فهرست مستندات پروژه
پرسشهای رایج
پاسخ به ابهامهای رایج درباره تاریخ، ارقام، parsing و منطقه زمانی.
چرا تاریخ شمسی بهصورت پیشفرض انگلیسی است؟
تقویم و زبان مستقلاند. برای نامها withLocale('fa') و برای ارقام withDigits('persian') را به کار ببرید. هر view جدید با en و latn شروع میشود؛ زبان و ارقام را ببینید.
چرا نمیتوانم خروجی addMonths را مستقیم format کنم؟
خروجی آن CivilDateTime است. قبل از format() دوباره jalali() یا view دیگری را انتخاب کنید. نوع خروجی را ببینید.
چرا endOfMonth ساعت را حفظ میکند؟
مرز تقویمی فقط روز را انتخاب میکند. برای 23:59:59 از endOfMonth()->endOfDay() و برای query پایگاه داده از بازهای استفاده کنید که انتهای آن شامل بازه نیست. محاسبات را ببینید.
آیا تغییر برچسب منطقه زمانی ساعت را تبدیل میکند؟
خیر. تفسیر همان تاریخ و ساعت محلی را عوض میکند. برای نمایش همان لحظه در منطقه دیگر، از timestamp یا PHP استفاده کنید. راهنمای منطقه زمانی مثال اجرایی دارد.
چرا تاریخ نامعتبر در یک API مقدار null میدهد و در دیگری خطا؟
tryFrom…() و tryParseExact() جایگزینهای nullable برای متدهای ساخت و parsing هستند. همه خطاهای تنظیمات را نمیگیرند. خطاها را ببینید.
آیا نامها و عبارتهای نسبی قابل خواندن هستند؟
نام ماه و روز هفته با locale مشخص پشتیبانی میشود. عبارت نسبی مثل «next Monday» پشتیبانی نمیشود. parsing و تغییرات beta.4 در آن را ببینید.
آیا قمری محاسباتی جایگزین نامحدود است؟
خیر. ساخت تاریخ در سالهای 1 تا 9666 قمری را پشتیبانی میکند و مدل تقویمی آن با امالقری فرق دارد. آن را آگاهانه انتخاب کنید و نامش را در خروجی مشخص کنید؛ انتخاب تقویم را ببینید.
آیا Daynum همهجا جای Carbon یا morilog/jalali را میگیرد؟
خیر. morilog نسخه 3 هم تغییرناپذیر است؛ Carbon و PHP هم APIهای مفیدی برای منطقه زمانی و برنامه دارند. بر اساس کار مورد نیاز انتخاب کنید و فراخوانیهای برنامه را تست کنید. راهنمای مهاجرت با منابع را ببینید.