تابع date() PHP
مثال
فرمت تاریخ و زمان محلی و رشته تاریخ فرمته شده را برمی‌گرداند:
<?php
// خروج روز
echo date("l") . "<br>";
// خروج تاریخ، تاریخ، ماه، سال، زمان AM یا PM
echo date("l jS \of F Y h:i:s A");
?>
مثال‌ها
تعریف و استفاده
date() تابع فرمت تاریخ و زمان محلی را فرمت می‌کند و رشته تاریخ فرمته شده را برمی‌گرداند.
دستور زبان
date(قالب,نشانگر زمانی);
| پارامتر |
توضیح |
| قالب |
ضروری. فرمت تعیین شده برای رشته تاریخ خروجی.
- 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)
- o - عدد سال در استاندارد 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 (مثال: Fri, 12 Apr 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 (مثال: Friday, 12-Apr-13 15:52:01 UTC)
- DATE_ISO8601 - ISO-8601 (مثال: 2013-04-12T15:52:01+0000)
- DATE_RFC822 - RFC 822 (مثال: Fri, 12 Apr 13 15:52:01 +0000)
- DATE_RFC850 - RFC 850 (مثال: Friday, 12-Apr-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)
|
| نشانگر زمانی |
اختیاری. نشان‌دهنده نشانگر زمانی صحیح. پیش‌فرض زمان محلی فعلی (time()). |
جزئیات فنی
| مقدار بازگشتی: |
در صورت موفقیت، رشته تاریخ و زمان فرمت شده را برمی‌گرداند، در صورت شکست، خطای E_WARNING را گزارش می‌دهد و FALSE را برمی‌گرداند. |
| نسخه 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 است.
PHP 5.1.1: اضافه کردن مقادیر استاندارد تاریخ/زمان، برای مشخص کردن قالب پارامترها.
|
