Edit Report a Bug

    DateTimeImmutable::setTime

    (PHP 5 >= 5.5.0, PHP 7, PHP 8)

    DateTimeImmutable::setTime — Устанавливает время

    Описание

    public DateTimeImmutable::setTime(
        int $hour,
        int $minute,
        int $second = 0,
        int $microsecond = 0
    ): DateTimeImmutable

    Возвращает новый объект DateTimeImmutable со временем, установленным на заданное время.

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

    hour

    Час времени.

    minute

    Минута времени.

    second

    Секунда времени.

    microsecond

    Микросекунда времени.

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

    Возвращает новый объект DateTimeImmutable с модифицированными данными.

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

    Версия Описание
    8.1.0 Поведение с удвоением существующих часов (во время резервного перехода на летнее время) изменилось. Раньше PHP выбирал второе вхождение (после перехода на летнее время) вместо первого вхождения (до перехода на летнее время).
    7.1.0 Добавлен параметр microsecond.

    Примеры

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

    Объектно-ориентированный стиль

    <?php
    $date     = new DateTimeImmutable('2001-01-01');

    $newDate = $date->setTime(14, 55);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";

    $newDate = $date->setTime(14, 55, 24);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";
    ?>

    Вывод приведённых примеров будет похож на: 

    2001-01-01 14:55:00
2001-01-01 14:55:24

    Пример #2 Значения, выходящие за пределы диапазона, добавляются к своим родительским значениям

    <?php
    $date     = new DateTimeImmutable('2001-01-01');

    $newDate = $date->setTime(14, 55, 24);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";

    $newDate = $date->setTime(14, 55, 65);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";

    $newDate = $date->setTime(14, 65, 24);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";

    $newDate = $date->setTime(25, 55, 24);
    echo     $newDate->format('Y-m-d H:i:s') . "\n";
    ?>

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

    2001-01-01 14:55:24
2001-01-01 14:56:05
2001-01-01 15:05:24
2001-01-02 01:55:24

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

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top