تغییر تاریخ (date_modify)
گاهی باید «تغییر تاریخ (Date Modify)» بدهیم. یعنی زمان را جلو یا عقب ببریم. تابع date_modify() روی یک شی DateTime همین کار را انجام می دهد.
تعریف کوتاه و کاربرد تغییر تاریخ
date_modify(object, modify) مُهرزمان را تغییر می دهد. «رشته تغییر (Modify String)» توضیح می دهد چه مقدار جابجا شویم. مثلا 15 روز اضافه کنیم.
نحو (Syntax) و پارامترها
object: یک شی DateTime از date_create().
modify: رشته تاریخ/زمان. مثلا "+15 days" یا "-2 months".
مثال پایه: افزودن 15 روز
<?php
$date = date_create("2013-05-01");
date_modify($date, "+15 days");
echo date_format($date, "Y-m-d");
?>
مثال تکمیلی: کم کردن ماه و افزودن ساعت
می توانیم چند تغییر پشت سرهم بدهیم. سپس با date_format() چاپ کنیم.
<?php
$date = date_create("2013-05-01 10:00:00");
date_modify($date, "-1 month");
date_modify($date, "+2 hours");
echo date_format($date, "Y-m-d H:i:s");
?>
نکات فنی و خطا
در موفقیت، یک DateTime برمی گردد. در خطا، FALSE می شود. این تابع از PHP 5.2 در دسترس است. در PHP 5.3، مقدار برگشتی به DateTime تغییر کرد.
گام های عملی تغییر تاریخ
- با date_create() تاریخ اولیه بساز.
- رشته تغییر را مشخص کن. مثلا
"+1 week". date_modify()را صدا بزن.- با date_format() نتیجه را چاپ کن.
جمع بندی سریع
date_modify()زمان را جابجا می کند.- رشته تغییر بسیار انعطاف پذیر است.
- خروجی موفق یک
DateTimeاست. - برای نمایش، از
date_format()کمک بگیر.