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

# idate

(PHP 5, PHP 7, PHP 8)

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

### Описание

function 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

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

- DateTimeInterface::format() - Форматирует дату в заданном формате
- date() - Форматирует метку времени эпохи Unix
- getdate() - Возвращает информацию о дате и времени
- time() - Возвращает метку времени Unix на основе текущего системного времени

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open