توابع gmdate PHP
مثال
فرمت‌دهی تاریخ و زمان GMT/UTC و بازگرداندن رشته تاریخ فرمت‌دهی شده:
<?php
// خروجی روز هفته
echo gmdate("l") . "<br>";
// خروجی روز هفته، روز، ماه، سال، زمان و صبح یا عصر
echo gmdate("l jS \of F Y h:i:s A");
?>
مثال اجرایی
تعریف و استفاده
gmdate() تابع فرمت‌دهی تاریخ و زمان GMT/UTC و رشته تاریخ فرمت‌دهی شده را بازمی‌گرداند.
منطق
gmdate(format,timestamp);
| پارامتر |
توضیح |
| format |
ضروری. تعیین فرمت خروجی رشته تاریخ. می‌توان از کاراکترهای زیر استفاده کرد:
- d - روز شماره ماه (از 01 تا 31)
- D - نمایش روز هفته با سه حرف
- j - روز شماره ماه بدون شماره پیش (1 تا 31)
- l (کوچک‌تر از 'L') - نمایش کامل روز هفته
- N - شماره روز هفته با استفاده از فرمت عددی ISO-8601 (1 برای Monday[یکشنبه] و 7 برای Sunday[یکشنبه])
- S - پسوند انگلیسی روز هفته در ماه (2 کاراکتر: st، nd، rd یا th. با j ترکیب می‌شود)
- w - شماره روز هفته (0 برای Sunday[یکشنبه] و 6 برای Saturday[شنبه])
- z - روز شماره سال (از 0 تا 365)
- W - شماره هفته در سال با استفاده از فرمت عددی ISO-8601 (هفته از Monday[یکشنبه] شروع می‌شود)
- F - نمایش کامل ماه (January[ژانویه] تا December[دسامبر])
- m - شماره ماه با شماره پیش (از 01 تا 12)
- M - نمایش کوتاه ماه با سه حرف
- n - شماره ماه بدون صفر پیش (1 تا 12)
- t - تعداد روزهای شامل در ماه داده شده
- L - آیا سال کبیسه است (اگر سال کبیسه باشد 1، در غیر این صورت 0)
- ISO-8601 استاندارد زیر شماره سال
- Y - نمایش سال به صورت چهار رقمی
- y - نمایش سال به صورت دو رقمی
- a - به صورت کوچک نوشته شده: am یا pm
- A - به صورت بزرگ نوشته شده: AM یا PM
- B - Swatch Internet Time (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) به صورت hours:minutes (در 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 Cookies (مثلاً: جمعه, 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 (مثلاً: Fri, 12 Apr 13 15:52:01 +0000)
- DATE_RFC1123 - RFC 1123 (مثلاً: Fri, 12 Apr 2013 15:52:01 +0000)
- DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
- DATE_RFC3339 - مشابه DATE_ATOM (از PHP 5.1.3 شروع می‌شود)
- DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
- DATE_W3C - اتحادیه وب (مثلاً: 2013-04-12T15:52:01+00:00)
|
| timestamp |
اختیاری. مقادیر اعداد صحیح Unix timestamp را مشخص می‌کند. پیش‌فرض زمان محلی جاری (time()) است. |
جزئیات فنی
| مقدار بازگشتی: |
اگر موفق باشد، رشته تاریخ فرمت‌بندی شده را برمی‌گرداند، اگر ناموفق باشد، خطای E_WARNING را نشان می‌دهد و FALSE را برمی‌گرداند. |
| نسخه PHP: |
4+ |
| رویدادهای به‌روزرسانی: |
PHP 5.1.0: دامنه معتبر زمان‌پیکس از 13 دسامبر 1901 20:45:54 GMT جمعه تا 19 ژانویه 2038 03:14:07 GMT دوشنبه است. در نسخه‌های 5.1.0 قبل، در برخی سیستم‌ها (مثلاً ویندوز) زمان‌پیکس محدود به بازه‌ای از 01-01-1970 تا 19-01-2038 است.
PHP 5.1.1: اضافه کردن مقادیر استاندارد تاریخ/زمان، برای مشخص کردن format پارامترها.
|
