fa date

shdate

(PHP 5, PHP 7, PHP 8)

sdate — فرمت محلی تاریخ/زمان

---

توضیحات

string shdate ( string $format [, int $timestamp = time() ] );

string sdate ( string $format [, int $timestamp = time() ] );

رشته‌ای که با توجه به قالب و زمان ساخته می‌شود را برمی‌گرداند.

---

پارامترها

پارامتر	توضیحات	مثال	مثال
format	رشته‌ای براساس قالب‌ها.	ِY-m-d	H:i:s
timestamp	زمان برحسب ثانیه	()time	1214837120

قالب‌های پارامتر format

قالب	توضیحات	مثال / مقدار خروجی
روز
d	عدد روز از ماه - با صفر	01 تا 31
j	عدد روز از ماه - بدون صفر	1 تا 31
S	پسوند برای روز از ماه ، 2 حرف (با j کار می کند)	ام
D	نام اختصاری روز از هفته	شـ (شنبه) تا جـ (جمعه)
l ( حرف کوچک 'L' )	نام کامل روز از هفته	شنبه تا جمعه
N	عدد روز از هفته - شروع از عدد یک ( ISO-8601 )	1 (شنبه) تا 7 (جمعه)
w	عدد روز از هفته - شروع از عدد صفر	0 (شنبه) تا 6 (جمعه)
z	عدد روز از سال (شروع از صفر)	200
هفته
W	شماره هفته از سال - شروع هفته از شنبه (ISO-8601)	42 (هفته 42 در سال)
ماه
F	نام کامل ماه در سال	Farvardin تا Esfand
M	نام اختصاری ماه در سال	Far تا Esf
m	عدد ماه در سال - با صفر	01 تا 12
n	عدد ماه در سال - بدون صفر	1 تا 12
t	عدد روزهای یک ماه	2۹ تا 31
سال
Y	عدد کامل سال - چهار رقمی	1399
y	عدد سال - دو رقمی با صفر	99
L	سال کبیسه	1 (کبیسه است), 0 (کبیسه نیست)
o	سال شماره گذاری هفته. این مقدار برابر با Y است با این تفاوت که اگر شماره هفته(W) مربوط به سال قبل یا سال بعد باشد از آن سال استفاده می‌شود	برای هفته‌های 1،52،53 ممکن است با Y متفاوت ‌شود
زمان
g	عدد ساعت به صورت 12-ساعتی - بدون صفر	1 تا 12
h	عدد ساعت به صورت 12-ساعتی - با صفر	01 تا 12
G	عدد ساعت به صورت 24-ساعتی - بدون صفر	0 تا 23
H	عدد ساعت به صورت 24-ساعتی - با صفر	00 تا 23
i	عدد دقیقه - با صفر	00 تا 59
s	عدد ثانیه - با صفر	00 تا 59
a	نام اختصاری قبل از ظهر و بعد از ظهر	قـ.ظ تا بـ.ظ
A	قبل از ظهر و بعد از ظهر به صورت کامل	بعد از ظهر
B	زمان اینترنت سواچ (Swatch Internet time )	000 تا 999
u	میکرو ثانیه - توجه داشته باشید که در ()SHDateTime::format پشتیبانی می‌شود	654321
v	میلی ثانیه - مشابه u	654
منطقه زمانی
e	شناسه منطقه زمانی	UTC, GMT, Asia/Tehran
I (حرف بزرگ "i")	آیا وقت تابستانی است یا خیر (طولانی بودن روز)	در نیمه اول سال 1 ،در غیر این صورت 0
O	اختلاف زمان با گرینویچ (GMT) بدون دو نقطه بین ساعت و دقیقه	0200+
P	اختلاف زمان با گرینویچ (GMT) با دو نقطه بین ساعت و دقیقه	02:00+
T	منطقه زمانی به اختصار	EST, MDT, ...
Z	اختلاف ساعت جهانی به ثانیه - غرب UTC همیشه منفی، شرق UTC همیشه مثبت	50400
تاریخ / زمان کامل
c	ISO-8601 تاریخ	1397-01-02T15:19:21+00:00
r	» RFC 2822 فرمت تاریخ	پـ ، 2 فروردین 1397 16:01:07 0330+
U	یونیکس ، زمان برحسب ثانیه (Dey 11 1348 00:00:00 GMT)	پارامتر timestamp
اضافه شده
اضافه شده	آزمایشی	آزمایشی
c?	شماره ی قرن	14 ( 1301-1400 )
E?	شماره ی دهه	90 ( 1391-1400 )
s?	شماره‌ی فصل	1 (بهار)
S?	نام فصل از سال	بهار
A?	نام باستانی برج ها	حمل تا حوت
B?	نام حیوانی سال ها	موش تا خوک
r?	تعداد روز (کامل) باقی مانده از سال	1-1 -> 364 و با کبیسه 365
Y?	سال به حروف (کامل)	یک هزار و سیصد و نود و سه
D?	روزبه حروف (کامل)	سی و یک
n?	تاریخ و زمان عید نوروز سال بعد (تقریبی)
t?	طولانی ترین شب سال (یلدا)
T?	طولانی ترین روز (تموز)
?R
?L
?Z

منطقه زمانی در تابع ()gmdate مقدار 0(صفر) خواهد بود. نویسه‌های شناسایی نشده در رشته قالب همانطور که هست چاپ می شوند. قالب Z هنگام استفاده از ()gmdate همیشه 0 برمی گردد.

---

برگردان

رشته تاریخ قالب بندی شده را برمی گرداند. اگر از مقدار غیر عددی برای زمان استفاده شود ، FALSE بازگردانده می شود و خطای سطح E_WARNING منتشر می شود.

---

مثال

// Assuming today is 10 Dey 1399, 17:16:18, and that we are in the
// Mountain Standard Time (Asia/Tehran) Time Zone

$today = shdate("F j, Y, g:i a");                 // Dey 10, 2001, 5:16 am
$today = shdate("m.d.y");                         // 03.10.01
$today = shdate("j, n, Y");                       // 10, 3, 2001
$today = shdate("Ymd");                           // 20010310
$today = shdate('h-i-s, j-m-y, it is w Day');     // 05-16-18, 10-03-01, 1631 1618 6 Satpm01
$today = shdate("D M j G:i:s T Y");               // Sat Dey 10 17:16:18 MST 2001
$today = shdate('H:m:s \m \i\s\ \m\o\n\t\h');     // 17:03:18 m is month
$today = shdate("H:i:s");                         // 17:16:18
$today = shdate("Y-m-d H:i:s");                   // 2001-03-10 17:16:18 (the MySQL DATETIME format)