ایجاد از فرمت (date_create_from_format)
با ایجاد از فرمت می توانیم از یک رشته، تاریخ بسازیم. «فرمت (Format)» یعنی الگوی نوشتن تاریخ. بنابراین اگر الگو را درست بدهیم، تاریخ دقیق می گیریم. برای مرور کلی، صفحه مرجع تاریخ PHP را ببین.
تابع date_create_from_format چیست؟
تابع date_create_from_format(format, time, timezone) یک شیء DateTime برمی گرداند. سپس می توانیم آن را فرمت یا مقایسه کنیم. «منطقه زمانی (Timezone)» یعنی اختلاف ساعت مکان ها.
ورودی ها
- format: الگوی خواندن تاریخ؛ مثل
j-M-Y. - time: رشته تاریخ/زمان؛ مثل
15-Mar-2013. - timezone: اختیاری؛ منطقه زمانی همان رشته.
نکته: خروجی در موفقیت یک DateTime است و در خطا FALSE.
نمونه کد از منبع
<?php
$date = date_create_from_format("j-M-Y", "15-Mar-2013");
?>
حروف پرکاربرد در format
d: روز با صفر پیشرو؛ مثل 05.j: روز بدون صفر؛ مثل 5.m: ماه عددی 01–12.M: ماه کوتاه؛ مثل Jan.Y: سال کامل؛ مثل 2013.H:i:s: ساعت 24ساعته، دقیقه، ثانیه.
هشدار: اگر رشته با فرمت نخورد، مقدار FALSE برمی گردد.
گام های عملی
- الگوی مناسب فرمت را انتخاب کن.
- رشته تاریخ را مطابق همان الگو بنویس.
- تابع
date_create_from_formatرا صدا بزن. - در صورت نیاز، با date_format نمایش بده.
نکته: برای ساخت مستقیم، صفحه date_create() را ببین. همچنین برای هماهنگی سئو، لینک ایجاد از فرمت را استفاده کن.
جمع بندی سریع
- فرمت درست، نتیجه درست می دهد.
- خروجی معمولاً یک
DateTimeاست. - عدم تطابق، مقدار
FALSEمی دهد. - نمایش نهایی با
date_formatراحت است.