شارك المقالة
تعرف على ما هو التقويم الهجري في Kotlin وكيفية التعامل معه في Android، مع مثال عملي واستخدام مكتبة Hijri Calendar جاهزة لتسهيل العمل.

ما هو التقويم الهجري في Kotlin؟ شرح عملي مع مثال ومكتبة جاهزة

ما هو التقويم الهجري في Kotlin؟


التقويم الهجري هو تقويم قمري يعتمد عليه المسلمون في تحديد المناسبات الدينية مثل شهر رمضان، وعيد الفطر، وعيد الأضحى، بالإضافة إلى توثيق الأحداث التاريخية.
يبدأ التقويم الهجري من هجرة النبي محمد ﷺ من مكة إلى المدينة المنورة عام 622 ميلاديًا، ويتكوّن من 12 شهرًا قمريًا.

التقويم الهجري في Kotlin

لغة Kotlin لا توفر بشكل افتراضي دعمًا مباشرًا للتقويم الهجري ضمن مكتباتها الأساسية، ولكن يمكن التعامل معه من خلال:
  • مكتبات خارجية (Third-party libraries).
  • استخدام تقاويم مخصصة تعتمد على الحسابات الفلكية.
  • مكتبات جاهزة توفر تجربة استخدام أسهل.

استخدام IslamicCalendar في Kotlin

توفر بعض المكتبات كلاس يُسمى IslamicCalendar والذي يُستخدم لتمثيل التواريخ الهجرية ومعالجتها.

أهم الدوال المتوفرة

  • constructor(year: Int, month: Int, dayOfMonth: Int)
    لإنشاء تاريخ هجري جديد.
  • get(field: Calendar.Field): Int
    للحصول على السنة أو الشهر أو اليوم.
  • set(field: Calendar.Field, value: Int)
    لتعديل قيمة معينة في التاريخ الهجري.

مثال على إنشاء تاريخ هجري في Kotlin


val hijriYear = 1446
val hijriMonth = 8
val hijriDay = 15

val hijriCalendar = IslamicCalendar(hijriYear, hijriMonth, hijriDay)

println("Hijri Date: ${hijriCalendar.year}/${hijriCalendar.month}/${hijriCalendar.dayOfMonth}")

مكتبة التقويم الهجري من تطوير المهندس Mohamed Almahdy

بدلًا من بناء كل شيء يدويًا، توجد مكتبة جاهزة من تطوير المهندس Mohamed Almahdy توفّر دعمًا ممتازًا للتقويم الهجري مع تصميم جاهز وسهل الدمج في تطبيقات Android باستخدام Kotlin.
المكتبة توفّر:
  • واجهة مستخدم جاهزة لاختيار التاريخ الهجري.
  • دعم كامل للتقويم الهجري.
  • سهولة التكامل مع مشاريع Android.
  • كود منظم وقابل للتخصيص.

رابط الكود الخاص بالتصميم


متى تحتاج التقويم الهجري في Kotlin؟

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

الخلاصة

التعامل مع التقويم الهجري في Kotlin ليس مدعومًا بشكل افتراضي، لكن يمكن تنفيذه بسهولة من خلال مكتبات جاهزة.
استخدام مكتبة جاهزة مثل مكتبة المهندس Mohamed Almahdy يوفّر وقتًا وجهدًا كبيرين، ويمنحك تجربة استخدام احترافية دون الحاجة لبناء التقويم من الصفر.
إذا كان تطبيقك يحتاج إلى دعم التاريخ الهجري، فإن الاعتماد على مكتبة متخصصة هو الحل الأفضل والأكثر أمانًا.
شاهد أيضًا
مقالات ذات صلة
تحمل ورفع ملف من الانترنت مع اظهار شريط التحميل اثناء التحميل و الرفع في flutter

تحمل ورفع ملف من الانترنت مع اظهار شريط التحميل اثناء التحميل و الرفع في flutter…

شرح كيفية مشاركة رابط في فلاتر | Explain how to share a link in flutter

شرح كيفية مشاركة رابط في فلاتر | Explain how to share a link in flutterفي اثناء…

تعلم البرمجة باستخدام Flutter وإضافة دعم متعدد اللغات لتطبيقاتك

خطوات سهلة لتطبيق الترجمات المتعددة في تطبيقات الأندرويد باستخدام Flutter Localizationsأصبح تطوير تطبيقات الهاتف المحمول…

🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع