Idate: примеры (PHP)

Примеры показывают различные форматы вызова функции idate с разными параметрами.

echo idate('d');

19

$timestamp = strtotime('2023-12-25');
echo idate('m', $timestamp);

12

echo idate('L', strtotime('2024-01-01'));

1

echo idate('w', strtotime('2023-10-01'));

0

echo idate('N', strtotime('2023-10-01'));

7

В PHP существуют несколько функций для работы с датой и временем, каждая имеет свои особенности.

Возвращает форматированную строку даты. Может возвращать несколько компонентов одновременно, в отличие от idate, которая возвращает только одно целое число. Используется чаще, когда нужен читабельный вывод.

Возвращает ассоциативный массив с подробной информацией о дате/времени. Удобно, когда нужно получить сразу несколько значений.

Форматирует дату/время согласно локали. В PHP 8.1 считается устаревшей, вместо нее рекомендуется использовать IntlDateFormatter.

• idate() - для получения одного числового значения даты, когда требуется целочисленный тип для вычислений.
• date() - для форматированного строкового представления даты.
• getdate() - для получения всех компонентов даты одновременно в виде массива.
• IntlDateFormatter - для локализованного форматирования.

Передача строки длиннее одного символа приводит к неожиданным результатам, так как idate использует только первый символ.

// Неправильно: передается строка 'dm'
echo idate('dm');

19  // Был использован только первый символ 'd'

До PHP 8.0 функция возвращала false при ошибке. В PHP 8.0 и выше выбрасывается исключение TypeError при неверном типе аргумента.

// До PHP 8.0
var_dump(idate('d', 'invalid'));

bool(false)

// PHP 8.0+
// idate('d', 'invalid'); // Вызовет TypeError

Путаница между idate и date может привести к ошибкам, когда ожидается строка, а возвращается число.

Функция больше не возвращает false при возникновении ошибки. Вместо этого выбрасывается исключение TypeError при передаче аргументов неверного типа. Параметр $timestamp теперь допускает значение null.

В PHP 5.1.0 и выше функция учитывает установленный часовой пояс. В версиях ранее 5.1.0 для корректной работы с часовыми поясами нужно было использовать date_default_timezone_set().

$birthday = strtotime('1990-05-15');
$today = time();
$daysSinceBirth = idate('z', $today) - idate('z', $birthday) + 
                 (idate('Y', $today) - idate('Y', $birthday)) * 365;
echo "Количество дней с дня рождения: $daysSinceBirth";

Количество дней с дня рождения: 12205

$date = strtotime('2023-12-31');
$weekNumber = idate('W', $date);
echo "31 декабря 2023 находится в неделе номер: $weekNumber";

31 декабря 2023 находится в неделе номер: 52

function isWorkDay($timestamp) {
    $dayOfWeek = idate('N', $timestamp);
    return ($dayOfWeek >= 1 && $dayOfWeek <= 5);
}
$testDate = strtotime('2023-10-21');
echo isWorkDay($testDate) ? 'Рабочий день' : 'Выходной';

Выходной

date_default_timezone_set('Europe/Moscow');
$timestamp = time();
echo "Часовой пояс: " . idate('Z') / 3600 . " часа";

Часовой пояс: 3 часа

$beat = idate('B');
echo "Текущее время в интернет-формате: @$beat";

Текущее время в интернет-формате: @500

function getSeason($timestamp) {
    $month = idate('m', $timestamp);
    if ($month >= 3 && $month <= 5) return 'Весна';
    if ($month >= 6 && $month <= 8) return 'Лето';
    if ($month >= 9 && $month <= 11) return 'Осень';
    return 'Зима';
}
echo getSeason(strtotime('2023-08-15'));

Лето

Idate в Python

Модуль datetime предоставляет аналогичные возможности через атрибуты объектов datetime.

from datetime import datetime
now = datetime.now()
day = now.day  # Аналог idate('d')
month = now.month  # Аналог idate('m')
print(f"Day: {day}, Month: {month}")

Day: 19, Month: 10

Idate в Javascript

Объект Date имеет методы для получения отдельных компонентов.

const now = new Date();
const day = now.getDate();  // idate('d')
const month = now.getMonth() + 1;  // idate('m'), но в JS месяцы с 0
console.log(`Day: ${day}, Month: ${month}`);

Day: 19, Month: 10

Idate в MySQL

Функции извлечения частей даты из столбцов или значений.

SELECT DAY('2023-10-19') as day,  -- Аналог idate('d')
       MONTH('2023-10-19') as month;  -- Аналог idate('m')

day: 19, month: 10

В Python и JavaScript работа с датами обычно объектно-ориентированная, в PHP и MySQL - через функции. Формат возвращаемых значений также отличается: в PHP idate всегда возвращает integer, в то время как аналоги в других языках могут возвращать числа как примитивы или в рамках объекта.