المنهجية Methodology
حالة المحتوى: مسودة تحتاج مراجعة لغوية وشرعية قبل النشر العام.
حساب مواقيت الصلاة
يحسب التطبيق المواقيت محلياً من التاريخ والإحداثيات ومنطقة IANA الزمنية وإعدادات طريقة الحساب والمذهب وقاعدة خطوط العرض العليا وتعديلات الدقائق. تستخدم نسخة Apple مكتبة Adhan Swift وتستخدم نسخة Android مكتبة Adhan Kotlin.
عند اختيار الطريقة التلقائية يستخدم التطبيق إعداد قطر للموقع ذي رمز الدولة QA، ويستخدم إعداد رابطة العالم الإسلامي لبقية الدول ما لم يختر المستخدم طريقة أخرى. هذه سياسة برمجية قابلة للتعديل، وليست حكماً على الجدول الأنسب لكل مكان.
بناء اليوم الزمني
تعمل حدود الفجر والشروق والظهر والعصر والمغرب والعشاء وفجر اليوم التالي كحدود لست مجموعات متصلة. تقسم النسب المحفوظة داخل كل مجموعة مدتها إلى أسماء زمنية متتابعة، ويظل مجموع النسب داخل كل مجموعة مساوياً لواحد. ينتج عن ذلك 24 فترة بلا فجوات أو تداخل.
النموذج A
يعرض القطاعات بزوايا متساوية، وتتغير سرعة العبور بحسب المدة الحقيقية لكل فترة.
النموذج B
يعرض القطاعات بأطوال متناسبة مع المدة الحقيقية ويستخدم للمقارنة داخل مختبر الزمن. لا يغيّر المختبر وقت الجهاز الحقيقي أو مواقيت التنبيهات.
المراجع التقنية
- Adhan Swift لحساب المواقيت في تطبيقات Apple.
- Adhan Kotlin لحساب المواقيت في تطبيقات Android.
- دليل طرق الحساب في مشروع Adhan لتعريف معاملات طرق الحساب المتاحة.
- قاعدة بيانات المناطق الزمنية من IANA للتوقيت المدني وتغيرات التوقيت الصيفي.
- النموذج الأول للساعة العربية مرجع للفكرة والسلوك، وليس مرجعاً حسابياً أو جهة اعتماد.
الحدود وحالة المراجعة
قد تختلف النتائج باختلاف طريقة الحساب والمذهب وقاعدة خطوط العرض والتعديلات المحلية. اعتمد جدول الجهة المحلية عندما تكون له الأولوية.
هذه المراجع التقنية لا تعتمد أسماء الساعات العربية أو ترتيبها أو ربطها بحدود الصلاة، ولا تمنح اعتماداً لغوياً أو شرعياً للمحتوى. تبقى هذه العناصر محجوبة عن النشر العام حتى يوثق مراجع لغوي وشرعي مسمى موافقته في سجل المراجعة داخل المشروع.
Content status: Draft pending linguistic and religious review before public release.
Prayer-time calculation
The app calculates prayer times locally from the date, coordinates, IANA time zone, calculation method, madhab, high-latitude rule, and minute adjustments. Apple apps use Adhan Swift and Android apps use Adhan Kotlin.
In automatic mode, locations with country code QA use the Qatar configuration. All other locations use the Muslim World League configuration unless the user selects another method. This is an editable software policy, not a judgment about the most appropriate local schedule.
Building the temporal day
Fajr, sunrise, Dhuhr, Asr, Maghrib, Isha, and the next day's Fajr define six connected groups. Saved ratios divide each group into ordered temporal names, with every group's ratios totaling one. The result is 24 periods without gaps or overlaps.
Model A
Segments use equal angles. Passage speed changes with the real duration of each period.
Model B
Segment lengths are proportional to real duration and are available for comparison in Time Lab. Simulation does not change real device time or notification schedules.
Technical references
- Adhan Swift for prayer calculations on Apple platforms.
- Adhan Kotlin for prayer calculations on Android.
- Adhan calculation methods for the available method parameters.
- IANA Time Zone Database for civil time and daylight-saving changes.
- Original Arabic Watch prototype as an idea and behavior reference, not a calculation authority or approval body.
Limits and review status
Results can vary with method, madhab, high-latitude rule, and local adjustments. Follow the schedule of your recognized local authority when it takes precedence.
These technical sources do not approve the 24 Arabic temporal names, their order, or their mapping to prayer boundaries. They provide no linguistic or religious endorsement. Those elements remain blocked from public release until a named qualified reviewer records approval in the project's content-review file.