idate() (idate)
تابع idate() زمان/تاریخ محلی را «عددی» می دهد. این یعنی خروجی Integer است. برای فهم بهتر، «قالب بندی عددی تاریخ» را تمرین می کنیم. سپس چند کاراکتر مهم را می بینیم.
تعریف و کاربرد
طبق منبع: idate() یک تاریخ/زمان محلی را به عدد تبدیل می کند. همچنین فقط یک کاراکتر فرمت می پذیرد. بنابراین رشته های چندحرفی مجاز نیستند.
نکته: اگر به متن کامل مثل "2025-11-02" نیاز داری، از توابع متنی تاریخ استفاده کن.
سینتکس
<?php
// idate(format, timestamp)
// format: فقط یک کاراکتر مجاز است.
// timestamp: اختیاری؛ پیش فرض time() است.
?>
مثال سریع: تست فرمت های عددی
<?php
echo idate("B") . "<br>";
echo idate("d") . "<br>";
echo idate("h") . "<br>";
echo idate("H") . "<br>";
echo idate("i") . "<br>";
echo idate("I") . "<br>";
echo idate("L") . "<br>";
echo idate("m") . "<br>";
echo idate("s") . "<br>";
echo idate("t") . "<br>";
echo idate("U") . "<br>";
echo idate("w") . "<br>";
echo idate("W") . "<br>";
echo idate("y") . "<br>";
echo idate("Y") . "<br>";
echo idate("z") . "<br>";
echo idate("Z") . "<br>";
?>
توضیح مثال
هر idate() یک بخش از زمان را عددی برمی گرداند. مثلا H ساعت 24ساعته است. همچنین d روز ماه است. سپس U تعداد ثانیه از یونیکس اپوک است.
کاراکترهای پرکاربرد
- B: زمان اینترنتی Swatch Beat.
- d: روز ماه.
- h/H: ساعت 12/24 ساعته.
- i/s: دقیقه و ثانیه.
- I: عدد 1 یا 0 برای DST.
- L: سال کبیسه؟ 1 بله، 0 خیر.
- m: شماره ماه.
- t: روزهای ماه جاری.
- U: ثانیه از 1970-01-01.
- w/W: روز هفته و هفته سال.
- y/Y: سال 2رقمی یا 4رقمی.
- z/Z: روز سال و اختلاف منطقه زمانی.
تمرین گام به گام
- اول، یک فایل PHP بساز.
- بعد، چند
idate()با حروف مختلف بزن. - سپس، خروجی را مقایسه و یادداشت کن.
- در پایان، حرف نادرست را امتحان نکن.
برای مقایسه خروجی متنی و عددی، صفحه قالب بندی عددی تاریخ را ببین.
نکات فنی
- خروجی: عدد صحیح بر اساس فرمت.
- نسخه PHP: 5+.
- تغییرات: از PHP 5.1 خطاهای منطقه زمانی گزارش می شود.
جمع بندی سریع
- idate فقط یک کاراکتر می گیرد.
- خروجی همیشه عددی است.
- زمان، محلی محاسبه می شود.
- برای متن، سراغ توابع متنی برو.