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)

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей 1 note

down

Daniel Vidal ¶

4 years ago

Note that the DateTime parameter has no effect in the result returned by DateTimeZone::getOffset($DateTime), unless, it refers to a DateTime where there is daylight savings in the referenced DateTimeZone.
Ex.:
<?php
$timezone_brl = new DateTimeZone('America/Sao_Paulo');
$timezone_eng = new DateTimeZone('Europe/London');
$timezone_aus = new DateTimeZone('Australia/Brisbane');
$dateTimes = [
 new DateTime()
 , new DateTime('now', $timezone_eng)
 , new DateTime('now', $timezone_aus)
 , new DateTime('now', $timezone_brl)
 , new DateTime('2000-06-10', $timezone_brl)
 , new DateTime('2000-12-10', $timezone_brl)
 , new DateTime('2020-12-10', $timezone_brl)
];
foreach($dateTimes as $dateTime)
{
 echo "\n" . $timezone_brl->getOffset($dateTime);
}
/**
* -10800
* -10800
* -10800
* -10800
* -10800 // No daylight savings in June/2000
* - 7200 // Brazil had daylight savings until 2020
* -10800 // No more daylight savings, so it returns -10800
*/
?>

+Добавить