Возвращает смещение времени часового пояса относительно времени UTC

# DateTimeZone::getOffset

# timezone_offset_get

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

DateTimeZone::getOffset -- timezone_offset_get — Возвращает смещение времени часового пояса относительно времени UTC

### Описание

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

public function DateTimeZone::getOffset(DateTimeInterface `$datetime`): int

Процедурный стиль

function timezone_offset_get(DateTimeZone `$object`, DateTimeInterface `$datetime`): int

Функция возвращает смещение времени заданного часового пояса относительно времени по стандарту UTC на конкретный момент времени, который содержится в объекте даты и времени аргумента `datetime`. Смещение вычисляется для часового пояса в объекте DateTimeZone относительно времени UTC.

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

`object`
  Только для процедурного стиля: объект DateTimeZone, который возвращает функция timezone_open().
`datetime`

  Объект DateTime или другой совместимый с интерфейсом объект с датой и временем, относительно которого вычисляется смещение.

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

Функция возвращает смещение времени часового пояса в секундах.

### Примеры

Пример #1 Пример получения смещения времени часового пояса относительно UTC-времени методом DateTimeZone::getOffset()

    <?php

    // Создаём два объекта часового пояса: один для города Тайбэй — столицы Тайваня,
    // и другой для города Токио — столицы Японии
    $dateTimeZoneTaipei = new DateTimeZone("Asia/Taipei");
    $dateTimeZoneJapan  = new DateTimeZone("Asia/Tokyo");

    // Создаём два объекта DateTime, оба содержат идентичные метки Unix-времени,
    // но разные часовые пояса
    $dateTimeTaipei = new DateTime("now", $dateTimeZoneTaipei);
    $dateTimeJapan  = new DateTime("now", $dateTimeZoneJapan);

    // Вычисляем смещение времени часового пояса Токио в объекте $dateTimeZoneJapan
    // относительно времени UTC на момент времени в объекте $dateTimeTaipei
    // с учётом переходов на летнее или зимнее время и исторических изменений наподобие календарных реформ
    $timeOffset = $dateTimeZoneJapan->getOffset($dateTimeTaipei);

    // Выведет значение int(32400) для дат после 01:00:00 субботы 8 сентября 1951 года
    // по стандартному японскому времени в часовом поясе JST, Sat Sep 8 01:00:00 1951 JST
    var_dump($timeOffset);

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

    int(32400)

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