الحدود

هذه الحدود مقصودة. فهي تُبقي كل استدعاء رخيصًا ويمكن التنبؤ به، وتمنع المُدخَلات غير الموثوقة من أن تتحول إلى تاريخ ملتفّ أو إلى عملية حسابية مكلفة. وتجاوز أي حد يرفع دائمًا استثناء RtlyKitException موثَّقًا (انظر معالجة الأخطاء)، أو Result غير صالح في حالة أدوات التحقق.

نطاقات سنوات التقاويم

كل تاريخ مدعوم في أي تقويم يقابل سنة ميلادية بين 1 و9999، فيمكن لـ DateTimeImmutable أن يحتفظ بأي قيمة تنتجها الفئات دون التفاف. والنطاقات هي الثوابت العامة MIN_YEAR وMAX_YEAR:

<?php
require __DIR__.'/vendor/autoload.php';

use RtlyKit\Calendar\{Hebrew, Hijri, Jalali};

foreach ([Jalali::class, Hijri::class, Hebrew::class] as $class) {
    printf(
        "%-7s %5d..%-5d  %s .. %s\n",
        (new ReflectionClass($class))->getShortName(),
        $class::MIN_YEAR,
        $class::MAX_YEAR,
        $class::create($class::MIN_YEAR, 1, 1)->toGregorian()->format('Y-m-d'),
        $class::create($class::MAX_YEAR, 1, 1)->toGregorian()->format('Y-m-d'),
    );
}
// Jalali   -620..9377   0001-03-21 .. 9998-03-20
// Hijri       1..9665   0622-07-19 .. 9998-10-12
// Hebrew   3762..13759  0001-09-06 .. 9998-10-15

تلتزم كل نقاط الدخول بالنطاق: make وcreate وcreateFromFormat والطوابع الزمنية (timestamp) في Unix وadd*() / sub*() (بما فيها الفروق الضخمة) والدوال المساعدة وماكروات Carbon. والقيمة الواقعة خارج النطاق تُلقي InvalidDateException؛ ولا شيء يُرجع تاريخًا ملتفّاً، ولا يتسرّب أي TypeError أو ValueError.

الفروق والطوابع الزمنية

• أي مقدار في addDays() / subDays() (وفي الساعات والدقائق والثواني) يزيد على مدى التقويم المدعوم كله (نحو 3.7 مليون يوم، أو المدى نفسه بالساعات أو الدقائق أو الثواني) يُرفض مسبقًا بـ InvalidDateException ؛ كما يُرفض المقدار الأصغر الذي ينتهي خارج السنوات المدعومة.
• يجب أن يقع الطابع الزمني (timestamp) في Unix ضمن السنوات الميلادية من 1 إلى 9999 (مع هامش صغير للمنطقة الزمنية)؛ وما كان أبعد من ذلك يُرفض.
• تعمل Hebrew::addMonths() و addYears() في زمن ثابت، مهما كبر المقدار.

عتبات السنة في المُدخَلات النصية

النص مثل 1405/01/01 أو 1405-01-01 الممرَّر إلى make() أو إلى دالة مساعدة يُقرأ على أنه تاريخ التقويم نفسه إذا كانت السنة دون العتبة، وعلى أنه نص ميلادي فيما عدا ذلك:

لتمرير تاريخ ميلادي حقيقي دون العتبة (مثل السنة 999) استخدم DateTimeImmutable الذي لا يُعاد تفسيره أبدًا. انظر الأسئلة الشائعة.

نطاق أم القرى

• يغطي جدول أشهر أم القرى المدمج السنوات 1300 إلى 1500 هـ (من 1882-11-12 إلى 2077-11-16). وخارجه، وفي HijriVariant::Tabular دائمًا، تستخدم Hijri قواعد حسابية قد تختلف عن الرصد بيوم أو يومين. وتخبرك Hijri::hasUmmAlQuraData($year) ما إذا كانت السنة مغطاة. والسنوات 1318 إلى 1500 هـ هي التي قورنت بتقويم KACST الرسمي ( Hijri::ummAlQuraVerifiedRange() ).
• تستعمل IranHolidays تواريخ رسمية أو منقولة للسنوات الجلالية 1380 إلى 1405. وفي السنوات الأخرى لا تُبلغ عن العطل الإسلامية إلا داخل نطاق أم القرى. وخارجه، ولسنوات ما قبل بداية التقويم الهجري، لا تُرجع إلا العطل الجلالية الثابتة دون استثناء. وتعمل all() و allTitles() و allFixed() لكل سنة جلالية من -620 إلى 9377.

سقوف حجم المُدخَلات

السقوف جزء من العقد (انظر استقرار الواجهة).

نطاقات الأعداد

use function RtlyKit\number_to_words;

echo number_to_words(999999999, 'ar'), "\n";
// تسعمئة وتسعة وتسعون مليون وتسعمئة وتسعة وتسعون ألف وتسعمئة وتسعة وتسعون
// number_to_words(str_repeat('9', 27), 'ar') تُثير InvalidNumberException (number_too_large, limit "10^27 - 1")
// number_to_words(str_repeat('9', 22)) تُثير InvalidNumberException (number_too_large, limit "10^21 - 1")

نطاقات الإعدادات

حدود تغطية البيانات

انظر الدقة والبيانات لمعرفة الأساس الذي تقوم عليه هذه الجداول.

حدود المنصة

PHP من 8.2 إلى 8.5 دون أي امتداد إضافي؛ وLaravel 11 و12 و13؛ وCarbon 3. انظر استقرار الواجهة.