PHP gmdate() Function












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



مثال


تاریخ و ساعت GMT/UTC را قالب بندی کنید و رشته های تاریخ قالب بندی شده را برگردانید:




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

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

این را خودتان امتحان کنید »




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


عملکرد gmdate() تاریخ و زمان GMT/UTC را قالب بندی می کند و رشته تاریخ قالب بندی شده را برمی گرداند.





نحو



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

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













است

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

  • 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: PHP 5.1: محدوده معتبر مهر زمانی اکنون از جمعه، 13 دسامبر 1901، 20:45:54 GMT تا سه، 19 ژانویه 2038، 03:14:07 GMT است. قبل از نسخه 5.1 مهر زمانی از 01-01-1970 تا 19-01-2038 در برخی از سیستم ها (مانند Windows) محدود می شد.
PHP 5.1.1: اضافه شد
ثابت های فرمت های استاندارد تاریخ/زمان که می توان برای تعیین آن استفاده کرد
پارامتر format




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