array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.idate.php', 1 => 'idate', 2 => 'Форматирует компонент даты или времени местного часового пояса как целое число', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Функции даты и времени', ), 'prev' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', ), 'next' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/functions/idate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

idate

(PHP 5, PHP 7, PHP 8)

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

Описание

idate(string $format, ?int $timestamp = null): int|false

Функция обрабатывает значение параметра 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().

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

Версия Описание
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

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