(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);
?>