Tresh.js

مكتبة جافاسكريبت عربية لمعالجة التواريخ والأوقات، مع دعم كامل للتقويم الهجري والميلادي.

المميزات

• معالجة التواريخ والأوقات بالعربية
• تحويل بين التقويم الهجري والميلادي
• حساب الفترات الزمنية وتنسيقها
• دعم مواقيت الصلاة
• التقويم الأكاديمي والمواسم
• إدارة المؤقتات والتنبيهات
• حساب أيام العمل والعطل الرسمية
• دعم المناطق الزمنية المختلفة

التثبيت

npm install treshjs

الاستخدام الأساسي

التاريخ العربي والهجري

const Tresh = require('treshjs');
const date = new Tresh(new Date());
// عرض التاريخ بالعربي
console.log(date.toArabicDate());
// الخميس ١٥ رمضان ١٤٤٥، ٠٩:٣٠
// التحويل للتاريخ الهجري
console.log(date.toHijri());
// ١٥/٩/١٤٤٥

### العد التنازلي

javascript
const timer = new Tresh(Date.now() + 3600000);
timer.countdown((remaining) => {
console.log(remaining); // 00:59:59
}, {
interval: 1000,
onComplete: () => console.log('انتهى الوقت')
});


### مواقيت الصلاة


const prayerTimes = new Tresh(new Date());
console.log(prayerTimes.getPrayerTimes());

الوظائف المتقدمة

التحقق من العطل

const date = new Tresh(new Date());
const holidays = date.isHoliday();
// يعرض العطل الرسمية والدينية
console.log(holidays);

تحويل المناطق الزمنية

const date = new Tresh(new Date());
console.log(date.toTimeZone('Africa/Cairo'));

حساب أيام العمل

const start = new Tresh(new Date());
const end = new Tresh(new Date().setDate(new Date().getDate() + 30));
const workingDays = start.getWorkingDays(end);

التوثيق

للمزيد من المعلومات والأمثلة، يرجى زيارة صفحة التوثيق.

المساهمة

نرحب بمساهماتكم لتحسين المكتبة. يمكنكم:

1. عمل Fork للمشروع
2. إنشاء فرع للتعديلات git checkout -b feature/new-feature
3. تنفيذ التعديلات وعمل Commit git commit -m 'إضافة ميزة جديدة'
4. رفع التعديلات git push origin feature/new-feature
5. فتح Pull Request

الترخيص

ISC

• Tresh