تنظیم ISO تاریخ (date_isodate_set)
گاهی با «استاندارد ISO 8601» کار داریم. «تنظیم ISO تاریخ (ISO Date Set)» یعنی ساخت تاریخ با شماره سال و هفته. سپس روز هفته را هم می دهیم. این کار با date_isodate_set() انجام می شود.
تعریف کوتاه و کاربرد
date_isodate_set(object, year, week, day) تاریخ را بر اساس ISO 8601 می سازد. به جای روز ماه، از «هفته» و «روز هفته» استفاده می کنیم. این روش برای برنامه های مدرسه ایِ هفتگی خیلی منطقی است.
نحو (Syntax) و پارامترها
object: شی DateTime از date_create().
year: سالِ موردنظر.
week: شماره هفته.
day: روز هفته. پیش فرض 1 است.
مثال پایه
<?php
$date = date_create();
date_isodate_set($date, 2013, 5);
echo date_format($date, "Y-m-d");
?>
مثال با تعیین روز هفته
اینجا روز هفته را هم می دهیم. بنابراین کنترل بیشتری داریم. سپس با date_format() خروجی را چاپ می کنیم.
<?php
$date = date_create();
date_isodate_set($date, 2013, 5, 3);
echo date_format($date, "Y-m-d");
?>
جزئیات فنی و نسخه ها
خروجی موفق، شی DateTime است. در خطا، FALSE برمی گردد. این تابع از PHP 5.2 در دسترس است. همچنین از PHP 5.3 مقدار برگشتی به DateTime تغییر کرد.
نکته: برای آموزش کاملِ تنظیم ISO تاریخ حتما مثال ها را اجرا کن. سپس تفاوت هفته ها را بررسی کن.
گام های سریع
- یک شی تاریخ با date_create() بساز.
- سال و هفته را به
date_isodate_set()بده. - در صورت نیاز، روز هفته را تعیین کن.
- با date_format() تاریخ را چاپ کن.
جمع بندی سریع
- استاندارد ISO با هفته ها کار می کند.
- پارامتر روز اختیاری است.
- خروجی موفق،
DateTimeاست. - برای چاپ،
date_format()را استفاده کن.