PHP date_format() Function












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



مثال


یک شی DateTime جدید را برگردانید و سپس تاریخ را قالب بندی کنید:




$date=date_create("15-03-2013");
echo date_format($date,"Y/m/d H:i:s");
?>

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




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


تابع date_format() تاریخ قالب بندی شده را بر اساس فرمت مشخص شده برمی گرداند.


توجه: این تابع از زبان‌های محلی استفاده نمی‌کند (همه خروجی‌ها داخل هستند
انگلیسی).


نکته: همچنین به date() نگاه کنید
تابع، که تاریخ/زمان محلی را فرمت می کند.





نحو



date_format (شیء، قالب)

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















پارامتر توضیح
شیء لازم است. یک شی DateTime را مشخص می کند که توسط
date_create()
قالب لازم است. فرمت تاریخ را مشخص می کند. از کاراکترهای زیر می توان استفاده کرد:

  • 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)














جزئیات فنی











مقدار بازگشتی: تاریخ قالب بندی شده را به صورت رشته ای برمی گرداند. FALSE در صورت شکست
نسخه PHP: 5.2+




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