گرفتن آفست (date_offset_get)
گاهی می خواهیم «آفست منطقه زمانی (Timezone Offset)» را بدانیم. آفست یعنی اختلاف با «UTC». تابع date_offset_get() این مقدار را برحسب ثانیه برمی گرداند.
تعریف کوتاه و کاربرد
date_offset_get(object) آفست منطقه زمانیِ شی DateTime را می دهد. مقدار برحسب ثانیه است. اگر خطا رخ دهد، FALSE می شود.
نحو (Syntax) و پارامتر
object: شی DateTime ساخته شده با date_create(). می توانی منطقه زمانی را با timezone_open() بدهی.
مثال: آفست اسلو در زمستان و تابستان
<?php
$winter = date_create("2013-12-31", timezone_open("Europe/Oslo"));
$summer = date_create("2013-06-30", timezone_open("Europe/Oslo"));
echo date_offset_get($winter) . " seconds.<br>";
echo date_offset_get($summer) . " seconds.";
?>
نکته: به خاطر «تغییر ساعت تابستانی (DST)»، آفست زمستان و تابستان متفاوت است.
گام های سریع
- یک تاریخ با date_create() بساز.
- منطقه زمانی را با timezone_open() تعیین کن.
date_offset_get()را روی شی اجرا کن.- نتیجه ثانیه ای را در خروجی نمایش بده.
جزئیات فنی
خروجی موفق، آفست از UTC برحسب ثانیه است. این تابع از PHP 5.2 در دسترس است. در خطا، مقدار FALSE برمی گردد. برای مرور دوباره «گرفتن آفست» این صفحه را علامت گذاری کن.
جمع بندی سریع
- آفست یعنی فاصله با UTC.
- واحد خروجی، ثانیه است.
- DST آفست را تغییر می دهد.
- در خطا، مقدار FALSE است.