idate

(PHP 5, PHP 7)

idateПреобразует локальное время/дату в целое число

Описание

idate ( string $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 - Воскресенье)
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()

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

Версия Описание
8.0.0 timestamp теперь допускает значение null.

Примеры

Пример #1 Пример использования idate()

<?php
$timestamp 
strtotime('1st January 2004'); //1072915200

// это выведет год в 2-х знаковом представлении 
// поскольку первая цифра "0", будет выведено 
// только "4"
echo idate('y'$timestamp);
?>

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

  • date() - Форматирует вывод системной даты/времени
  • getdate() - Возвращает информацию о дате/времени
  • time() - Возвращает текущую метку системного времени Unix