شارك المقالة
تعرف على ما هو التقويم الهجري في 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 يوفّر وقتًا وجهدًا كبيرين، ويمنحك تجربة استخدام احترافية دون الحاجة لبناء التقويم من الصفر.
إذا كان تطبيقك يحتاج إلى دعم التاريخ الهجري، فإن الاعتماد على مكتبة متخصصة هو الحل الأفضل والأكثر أمانًا.
شاهد أيضًا
مقالات ذات صلة
كود برنامج c++ لتحويل درجة الحراره من مئوية إلى فهرنهايت والعكس | Fahrenheit to celsius C++

كود برنامج c++ لتحويل درجة مئوية إلى فهرنهايت والعكس هل تم طلب منك واجب “sheet”…

كيفية انشاء دايلوج ” Dialog ” مخصص بالشكل الذي تريدة في برنامج اندرويد ستوديو – Custom Dialog box in android Studio

  الرسائل المنبثقه او Dialog او التنبيهات او مربع الحوار واحده من اهم العوامل التي…

كيفية تنفيذ امر معين عند النقر مطول على صورة او اي عنصر في Flutter

كيفية تنفيذ امر معين عند النقر مطول على صورة او اي عنصر في Flutter يغفل…

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

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