PHP date() Function












❮ مرجع تاریخ/زمان PHP



مثال


یک تاریخ و زمان محلی را قالب بندی کنید و رشته های تاریخ قالب بندی شده را برگردانید:




// روز
تاریخ echo("l") را چاپ می کند. "
";

// روز، تاریخ، ماه، سال، زمان، AM یا PM
تاریخ پژواک را چاپ می‌کند ("l jS of F Y h:i:s A") ;
؟>

خودت امتحانش کن »




تعریف و استفاده


تابع date() تاریخ و زمان محلی را قالب بندی می کند و رشته تاریخ قالب بندی شده را برمی گرداند.





نحو



تاریخ (قالب، مهر زمانی)

مقادیر پارامتر













است

پارامتر توضیح
قالب لازم است. فرمت رشته تاریخ خروجی را مشخص می کند. از کاراکترهای زیر می توان استفاده کرد:

  • d - روز ماه (از 01 تا 31)

  • D - نمایش متنی یک روز (سه حرف)

  • j - روز ماه بدون صفرهای اول (1 تا 31)

  • l (حروف کوچک "L") - یک نمایش متنی کامل از یک روز

  • N - نمایش عددی ISO-8601 یک روز (1 برای دوشنبه، 7 برای یکشنبه)

  • S - پسوند ترتیبی انگلیسی برای روز ماه (2 نویسه st، nd، rd یا th. با j به خوبی کار می کند)

  • w - نمایش عددی روز (0 برای یکشنبه، 6 برای شنبه)

  • z - روز سال (از 0 تا 365)

  • W - شماره هفته ISO-8601 سال (هفته‌هایی که از دوشنبه شروع می‌شوند)

  • F - نمایش متنی کامل یک ماه (ژانویه تا دسامبر)

  • m - نمایش عددی یک ماه (از 01 تا 12)

  • M - یک نمایش متنی کوتاه از یک ماه (سه حرف)

  • n - نمایش عددی یک ماه، بدون صفرهای اول (1 تا 12)

  • t - تعداد روزها در ماه معین

  • L - آیا سال کبیسه است (1 اگر سال کبیسه باشد، 0 در غیر این صورت)

  • o - شماره سال ISO-8601

  • Y - نمایش چهار رقمی یک سال

  • y - نمایش دو رقمی یک سال

  • a - حروف کوچک am یا pm

  • A - حروف بزرگ AM یا PM

  • B - زمان اینترنت سواچ (000 تا 999)

  • g - قالب 12 ساعته از یک ساعت (1 تا 12)

  • G - قالب 24 ساعته یک ساعته (0 تا 23)

  • h - قالب 12 ساعته یک ساعت (01 تا 12)

  • H - قالب 24 ساعته یک ساعته (00 تا 23)

  • i - دقیقه با صفرهای ابتدایی (00 تا 59)

  • s - ثانیه، با صفرهای پیشرو (00 تا 59)

  • u - میکروثانیه (افزوده شده در PHP 5.2.2)

  • e - شناسه منطقه زمانی (مثال: UTC، GMT، Atlantic/Azores)

  • I (بزرگ i) - آیا تاریخ به وقت تابستانی است یا نه (1 اگر به وقت تابستانی است، 0 در غیر این صورت)

  • O - تفاوت زمان گرینویچ (GMT) بر حسب ساعت (مثال: 0100+)

  • P - تفاوت زمان گرینویچ (GMT) بر حسب ساعت: دقیقه (افزوده شده در PHP 5.1.3)

  • T - اختصارات منطقه زمانی (مثال: EST، MDT)

  • Z - تغییر منطقه زمانی در ثانیه. افست برای مناطق زمانی غرب UTC منفی است (43200- تا 50400)

  • c - تاریخ ISO-8601 (به عنوان مثال 2013-05-05T16:34:42+00:00)

  • r - تاریخ قالب‌بندی شده RFC 2822 (به عنوان مثال جمعه، 12 آوریل 2013، 12:01:05 +0200)

  • U - ثانیه های پس از یونیکس (1 ژانویه 1970 ساعت 00:00:00 GMT)


و ثابت های از پیش تعریف شده زیر نیز می توانند استفاده شوند (از PHP 5.1.0 موجود است):



  • DATE_ATOM - Atom (مثال: 2013-04-12T15:52:01+00:00)

  • DATE_COOKIE - کوکی‌های HTTP (مثال: جمعه، 12 آوریل-13، 15:52:01 UTC)

  • DATE_ISO8601 - ISO-8601 (مثال: 2013-04-12T15:52:01+0000)

  • DATE_RFC822 - RFC 822 (مثال: جمعه، 12 آوریل 13، 15:52:01 +0000)

  • DATE_RFC850 - RFC 850 (مثال: جمعه، 12 آوریل-13، 15:52:01 UTC)

  • DATE_RFC1036 - RFC 1036 (مثال: جمعه، 12 آوریل 13، 15:52:01 +0000)

  • DATE_RFC1123 - RFC 1123 (مثال: جمعه، 12 آوریل 2013، 15:52:01 +0000)

  • DATE_RFC2822 - RFC 2822 (جمعه، 12 آوریل 2013، 15:52:01 +0000)

  • DATE_RFC3339 - مانند DATE_ATOM (از PHP 5.1.3)

  • DATE_RSS - RSS (جمعه، 12 اوت 2013، 15:52:01 +0000)

  • DATE_W3C - کنسرسیوم وب جهانی (مثال: 2013-04-12T15:52:01+00:00)


مهر زمانی اختیاری. یک مهر زمانی یونیکس عدد صحیح را مشخص می کند. پیش فرض زمان محلی فعلی (time())












جزئیات فنی















مقدار بازگشتی: رشته تاریخ قالب بندی شده را در صورت موفقیت برمی گرداند. FALSE در صورت شکست + E_WARNING
نسخه PHP: 4+
تغییر: PHP 5.1.0: خطاهای منطقه زمانی E_STRICT و E_NOTICE اضافه شد. محدوده معتبر مهر زمانی اکنون از جمعه، 13 دسامبر 1901، 20:45:54 GMT تا سه، 19 ژانویه 2038، 03:14:07 GMT است. قبل از اینکه مهر زمانی نسخه 5.1.0 از 01-01-1970 به 19-01-2038 در برخی از سیستم ها (مانند Windows) محدود شود.
PHP 5.1.1: اضافه شدن ثابت های فرمت های استاندارد تاریخ/زمان که می توانند برای مشخص کردن استفاده شوند. پارامتر قالب




❮ مرجع تاریخ/زمان PHP