date_parse

(PHP 5 >= 5.2.0, PHP 7)

date_parse Возвращает ассоциативный массив с подробной информацией о заданной дате/времени

Описание

date_parse ( string $datetime ) : array

Список параметров

datetime

Дата/время в формате, распознаваемом функцией DateTimeImmutable::__construct().

Возвращаемые значения

Возвращает массив (array), содержащий информацию о дате/времени в случае успешного выполнения или false в случае возникновения ошибки.

Ошибки

В случае возникновения ошибок форматирования даты/времени, элемент массива 'errors' будет содержать сообщения об этих ошибках.

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

Версия Описание
7.2.0 Элемент возращаемого массива с ключем zone теперь содержит секунды, а не минуты. Кроме того, знак инвертирован. Т.е. раньше был -120, а теперь 7200.

Примеры

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

<?php
print_r
(date_parse("2006-12-12 10:00:00.5"));
?>

Результат выполнения данного примера:

Array
(
    [year] => 2006
    [month] => 12
    [day] => 12
    [hour] => 10
    [minute] => 0
    [second] => 0
    [fraction] => 0.5
    [warning_count] => 0
    [warnings] => Array()
    [error_count] => 0
    [errors] => Array()
    [is_localtime] => 
)

Относительные форматы не влияют на значения, разобранные из абсолютных форматов, но будут доступны в элементе массива с ключом "relative".

Пример #2 date_parse() с относительным форматом

<?php
print_r
(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>

Результат выполнения данного примера:

Array
(
    [year] => 2006
    [month] => 12
    [day] => 12
    [hour] => 10
    [minute] => 0
    [second] => 0
    [fraction] => 0.5
    [warning_count] => 0
    [warnings] => Array()
    [error_count] => 0
    [errors] => Array ()

    [is_localtime] =>
    [relative] => Array
        (
            [year] => 0
            [month] => 0
            [day] => 7
            [hour] => 1
            [minute] => 0
            [second] => 0
        )

)

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

  • checkdate() - Проверяет корректность даты по григорианскому календарю
  • getdate() - Возвращает информацию о дате/времени