شارك المقالة
تعرف على ما هو التقويم الهجري في 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 يوفّر وقتًا وجهدًا كبيرين، ويمنحك تجربة استخدام احترافية دون الحاجة لبناء التقويم من الصفر.
إذا كان تطبيقك يحتاج إلى دعم التاريخ الهجري، فإن الاعتماد على مكتبة متخصصة هو الحل الأفضل والأكثر أمانًا.
شاهد أيضًا
مقالات ذات صلة
كود برنامج بلغةالبايثون لتبادل قيمتين مختلفتين ( عمل swap في لغة python )

متابعي جي كودرس مرحبا بكم في مقالة بايثون جديدة وفي هذة المقالة سوف نتعرف كيف…

إنشاء wave على المقطع الصوتي في فلاتر | Create a wave on an audio clip in Flutter

إنشاء wave على المقطع الصوتي في فلاتر  wave واحد من العناصر التي تشغل بال الكثير…

شرح كيفية عمل رسالة Toast تظهر بالاسفل بشكل مختلف ومتناسق في flutter

شرح كيفية عمل رسالة Toast تظهر بالاسفل بشكل مختلف ومتناسق في flutterفي اي تطبيق تقوم…

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

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