idate
(PHP 5, PHP 7, PHP 8)
idate — Преобразует локальное время/дату в целое число
Описание
idate(string $format
, int|null $timestamp
= null
): int|false
В отличие от функции date(), idate()
принимает только один символ в аргументе format
.
Список параметров
-
format
-
Допустимые символы в строке аргумента format
символ в format |
Описание |
B |
Эталонное время/Время Интернета |
d |
День месяца |
h |
Час (12 часовой формат) |
H |
Час (24 часовой формат) |
i |
Минуты |
I (i в верхнем регистре) |
возвращает 1 , если активировано DST, или
0 в противном случае |
L (l в верхнем регистре) |
возвращает 1 для високосного года,
0 в противном случае |
m |
Номер месяца |
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_NOTICE
,
и/или ошибку уровня E_STRICT
или E_WARNING
при использовании системных
настроек или переменной окружения TZ. Смотрите также date_default_timezone_set()
Примеры
Пример #1 Пример использования idate()
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// это выведет год в 2-х знаковом представлении
// поскольку первая цифра "0", будет выведено
// только "4"
echo idate('y', $timestamp);
?>
Смотрите также
- date() - Форматирует вывод системной даты/времени
- getdate() - Возвращает информацию о дате/времени
- time() - Возвращает текущую метку системного времени Unix