(PHP 5, PHP 7, PHP 8)
idate — Форматирует компонент даты или времени местного часового пояса как целое число
Функция обрабатывает значение параметра timestamp
или получает метку текущего системного времени, если параметр опустили,
и возвращает целочисленное значение компонента даты или времени в заданном формате.
Поэтому параметр timestamp необязателен
и по умолчанию равен значению, которое возвращает функция time().
Функция idate(), в отличие от функции date(),
принимает только один символ в аргументе 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().
| Версия | Описание |
|---|---|
| 8.2.0 |
Добавили символы форматирования:
N — день недели по стандарту ISO-8601
и o — год по стандарту ISO-8601.
|
| 8.0.0 |
Параметр timestamp теперь принимает значение null.
|
Пример #1 Пример форматирования компонента даты или времени функцией idate()
<?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