(PHP 5, PHP 7, PHP 8)
idate — Преобразовывает локальное время/дату в целое число
Преобразовывает текущую дату и время в целое число в соответствии со строкой форматирования format
. Если аргумент timestamp
задан, расчёт будет произведён для этой временной метки, если нет — будет использовано локальное время. Другими словами, метка времени timestamp
— это необязательный аргумент и по умолчанию равен значению time().
В отличие от функции date(), функция idate() принимает только один символ в аргументе format
.
format
символ в format | Описание |
---|---|
B | Эталонное время/Время Интернета |
d | День месяца |
h | Час (12 часовой формат) |
H | Час (24 часовой формат) |
i | Минуты |
I (i в верхнем регистре) | возвращает 1 , если активировано DST, или 0 в противном случае |
L (l в верхнем регистре) | возвращает 1 для високосного года, 0 в противном случае |
m | Номер месяца |
N | День недели в ISO-8601 (с 1 для понедельника по 7 для воскресенья) |
o | Год в ISO-8601 (4 цифры) |
s | Секунды |
t | Количество дней в текущем месяце |
U | Время в секундах, от начала эпохи UNIX - 1 января 1970 00:00:00 UTC - то же, что time() |
w | День недели (0 - Воскресенье) |
W | ISO-8601 - Номер недели года, неделя начинается с понедельника |
y | Год (1 или 2 цифры - смотрите примечание ниже) |
Y | Год (4 цифры) |
z | День года |
Z | Часовой пояс — смещение в секундах |
timestamp
Необязательный параметр timestamp
— это целочисленная (int) метка времени, по умолчанию равная текущему местному времени, если параметр timestamp
не указан или равен null
. Говоря по другому, значение по умолчанию равно результату функции time().
Возвращает целое число (int) в случае успешного выполнения или false
, если возникла ошибка.
idate() всегда возвращает тип int и не может начинаться с нуля, поэтому idate() может вернуть меньше цифр, чем вы ожидаете. Смотрите примеры ниже.
Каждый вызов к функциям даты и времени при неправильных настройках часового пояса сгенерирует ошибку уровня E_WARNING
, если часовой пояс некорректный. Смотрите также описание функции date_default_timezone_set().
Версия | Описание |
---|---|
8.2.0 | Добавлены символы для параметра format: N (День недели в ISO-8601) и o (Год в ISO-8601). |
8.0.0 | timestamp теперь допускает значение null. |
Пример #1 Пример использования idate()
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// это выведет год в 2-х знаковом представлении
// поскольку первая цифра "0", будет выведено
// только "4"
echo idate('y', $timestamp);
?>