gmstrftime() (gmstrftime)
با «قالب بندی GMT» شروع کنیم. تابع gmstrftime() تاریخ/زمان را بر اساس تنظیمات زبان سیستم (Locale: زبانِ نمایش) برمی گرداند. دقت کن، زمان بر پایه GMT/UTC است، نه محلی.
تعریف و کاربرد
طبق منبع: gmstrftime() یک زمان/تاریخ را در منطقه زمانی GMT/UTC قالب بندی می کند. نام ماه ها و روزها از Locale فعلی پیروی می کنند.
نکته: اگر زمان محلی می خواهی، از strftime() استفاده کن.
سینتکس
<?php
// gmstrftime(format, timestamp)
// format: الگوی نمایش مانند "%Y-%m-%d %H:%M:%S"
// timestamp: اختیاری؛ پیش فرض time()
?>
پارامترها
- format: الزامی. الگوی خروجی؛ مانند %Y، %m، %d، %H، %M، %S، %B، %A، %Z.
- timestamp: اختیاری. زمان یونیکس برای قالب بندی؛ پیش فرض
time().
نمونه ای از پرکاربردها
- %Y: سال کامل.
- %m: ماه دو رقمی.
- %d: روز ماه.
- %H:%M:%S: زمان 24ساعته.
- %B / %A: نام کامل ماه/روز.
- %Z یا %z: نام/اختصار منطقه زمانی.
مثال عملی: قالب بندی GMT
<?php
$ts = mktime(20, 0, 0, 12, 31, 98);
echo gmstrftime("%B %d %Y, %X %Z", $ts) . "<br>";
setlocale(LC_ALL, "hu_HU.UTF8");
echo gmstrftime("%Y. %B %d. %A. %X %Z");
?>
توضیح مثال
اینجا با mktime() یک زمان ساختیم. سپس با gmstrftime() آن را قالب بندی کردیم. بعد setlocale() را تغییر دادیم تا نام ها با زبان انتخابی نمایش یابند. خروجی همیشه بر پایه GMT است.
نکات فنی و سازگاری
- خروجی: رشته طبق الگوی format.
- نسخه PHP: 4+.
- برای ساخت زمان GMT، از gmmktime() کمک بگیر.
- برای «قالب بندی GMT» با زمان محلی مقایسه کن.
جمع بندی سریع
- gmstrftime(): خروجی بر پایه GMT/UTC.
- نمایش نام ها تابع Locale است.
- format را با توکن ها تنظیم کن.
- timestamp اختیاری است.
- نمونه آماده را اجرا و تمرین کن.