idate

(PHP 5, PHP 7, PHP 8)

idate — Форматирует компонент даты или времени местного часового пояса как целое число

Описание

Функция обрабатывает значение параметра timestamp или получает метку текущего системного времени, если параметр опустили, и возвращает целочисленное значение компонента даты или времени в заданном формате. Поэтому параметр timestamp необязателен и по умолчанию равен значению, которое возвращает функция time() .

Функция idate(), в отличие от функции date() , принимает только один символ в аргументе format.

Список параметров

format

Допустимые символы в строке аргумента format

Символ в аргументе format	Описание
B	«Бит» времени в системе Swatch, или интернет-время
d	День месяца
h	Час в 12-часовом формате
H	Час в 24-часовом формате
i	Минуты
I (i в верхнем регистре)	Возвращает 1, если действует летнее время, иначе 0
L (l в верхнем регистре)	Возвращает 1 для високосного года, иначе 0
m	Номер месяца
N	День недели по стандарту ISO-8601, где 1 — понедельник, а 7 — воскресенье
o	Год по стандарту ISO-8601 — 4 цифры
s	Секунды
t	Количество дней в текущем месяце
U	Время в секундах с начала эпохи Unix — 00:00:00 1 января 1970 по времени UTC, аналогично значению, которое возвращает функция time()
w	День недели, где 0 — воскресенье
W	Номер недели года по стандарту ISO-8601, неделя начинается с понедельника
y	Год в 1- или 2-значном формате, см. примечание в примере
Y	Год в 4-значном формате
z	День года
Z	Смещение времени часового пояса в секундах

timestamp

Необязательный параметр timestamp — целочисленная (int ) метка времени, которая по умолчанию равна текущему местному времени, если параметр timestamp не указали или равен null . Говоря по другому, значение по умолчанию равно результату функции time() .

Возвращаемые значения

Функция возвращает значение int , если выполнилась успешно, или false , если возникла ошибка.

Функция idate() иногда возвращает значение, разрядность которого меньшей ожидаемой, поскольку функция idate() возвращает только значения int , которым нельзя начинаться с нуля. См. пример.

Ошибки

Каждый вызов функции для работы с датой и временем генерирует ошибку уровня E_WARNING при неправильных настройках часового пояса. Смотрите также описание функции date_default_timezone_set() .

Список изменений

Примеры

<?php
$timestamp = strtotime('1st January 2004'); // 1072915200
// Символ 'y' форматирует год в 2-значном формате,
// но поскольку год выводился бы с символа 0,
// код выведет только цифру 4
echo idate('y', $timestamp) . "\n";
$timestamp = strtotime('1st January 2024'); // 1704067200
echo idate('y', $timestamp);

4
24

Смотрите также

• DateTimeInterface::format() - Форматирует дату в заданном формате
• date() - Форматирует метку времени эпохи Unix
• getdate() - Возвращает информацию о дате и времени
• time() - Возвращает метку времени Unix на основе текущего системного времени