(PHP 5, PHP 7, PHP 8)
idate — Преобразует локальное время/дату в целое число
$format
, ?int $timestamp
= null
): int|false
Преобразует текущую дату и время в целое число в соответствии со строкой
форматирования 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);
?>