idate
(PHP 5, PHP 7)
idate — Преобразует локальное время/дату в целое число
Описание
$format
, int|null $timestamp = null
) : int|false
Преобразует текущую дату и время в целое число в соответствии со строкой
форматирования format. Если аргумент
timestamp задан, расчет будет произведен для
этой временной метки, если нет - будет использовано локальное время.
Другими словами, timestamp - необязательный
аргумент и по умолчанию равен значению time().
В отличие от функции 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- Воскресенье)WISO-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()
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
timestamp теперь допускает значение null.
|
Примеры
Пример #1 Пример использования idate()
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// это выведет год в 2-х знаковом представлении
// поскольку первая цифра "0", будет выведено
// только "4"
echo idate('y', $timestamp);
?>