فهرست مستندات پروژه

نمایش تاریخ

Daynumv1.0.0-beta.4مشاهده منبعفارسی / انگلیسی

نمایش تاریخ با توکن‌های پشتیبانی‌شده به سبک PHP.

نمایش از طریق view

format($pattern) را روی view تقویم صدا بزنید. formatter توکن‌های جدول زیر را پشتیبانی می‌کند، نه همه توکن‌های تمام نسخه‌های PHP را. کاراکتر ناشناخته بدون تغییر در خروجی می‌آید. برای نمایش خود حرف یک توکن، قبل از آن بک‌اسلش بگذارید. تبدیل view به رشته از قالب Y-m-d برای میلادی و Y/m/d برای بقیه تقویم‌ها استفاده می‌کند.

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

use Eram\Daynum\CivilDateTime;

$v = CivilDateTime::fromGregorian(2026, 4, 8, 14, 30, 0, 'Asia/Tehran')
    ->jalali()->withLocale('fa')->withDigits('persian');
echo $v->format('Y/m/d H:i P'), "\n";
echo $v->format('c'), "\n";
echo $v->format('\\Y Y'), "\n";
۱۴۰۵/۰۱/۱۹ ۱۴:۳۰ +03:30
2026-04-08T14:30:00+03:30
Y ۱۴۰۵

مرجع توکن‌ها

توکن‌هامعنی
Y yسال تقویم با حداقل چهار رقم / دو رقم آخر
m n F Mماه با صفر ابتدایی / بدون صفر / نام کامل / نام کوتاه
d j Sروز با صفر ابتدایی / بدون صفر / پسوند ترتیبی زبان
l D N wنام کامل و کوتاه روز هفته؛ شماره روز با دوشنبه=1 یا یکشنبه=0
zشماره روز سال از صفر؛ dayOfYear() از یک شروع می‌شود
W oشماره هفته و سال هفته بر اساس قانون پنجشنبه در همین تقویم
t Lتعداد روزهای ماه / نشانه سال کبیسه
H G h gساعت ۲۴ ساعته با صفر و بدون صفر؛ ساعت ۱۲ ساعته با صفر و بدون صفر
i s a Aدقیقه، ثانیه و نشانه قبل یا بعد از ظهر در زبان انتخابی
u vهمیشه 000000 و 000؛ دقت کمتر از ثانیه ذخیره نمی‌شود
e Tبرچسب ذخیره‌شده منطقه زمانی / نام اختصاری منطقه زمانی از PHP
O P p Z I Uاختلاف ساعت، اختلاف با دونقطه، اختلاف یا Z، اختلاف به ثانیه، وضعیت DST و ثانیه Unix
c rخروجی میلادی ISO 8601 و RFC 2822 از PHP

توکن‌های e T O P p Z I U c r به برچسب منطقه زمانی غیر null نیاز دارند. به‌جز e که خود برچسب را چاپ می‌کند، بقیه از PHP برای تشخیص منطقه زمانی استفاده می‌کنند و ممکن است برچسب نامعتبر را رد کنند. ارقام خروجی این توکن‌ها تبدیل نمی‌شوند. c و r حتی روی view شمسی یا قمری هم تاریخ میلادی می‌دهند؛ بقیه توکن‌های تقویمی از تقویم انتخاب‌شده استفاده می‌کنند. در ساعت‌های حذف‌شده هنگام تغییر ساعت رسمی، PHP ممکن است ساعت محلی را اصلاح کند؛ راهنمای منطقه زمانی را ببینید.

W و o ممکن است در مرز محدوده خطا بدهند و شروع هفته در locale روی آن‌ها اثر ندارد. S به زبان بستگی دارد و در فارسی و عربی خالی است. locale عربی نام ماه شمسی ندارد و F و M در این حالت خطا می‌دهند. پیش از اینکه فرض کنید هر خروجی را می‌توان دوباره خواند، راهنمای زبان و ارقام و parsing را بخوانید.

جستجو در مستندات

در همه پروژه‌ها جستجو کنید. با بستن این پنجره به راهنما برمی‌گردید.

Tab برای جابه‌جایی · Enter برای باز کردنEsc برای بستن