DateTimeZone::getOffset

timezone_offset_get

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

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

Описание

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

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

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

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)