exponenta event banner

tzoffset

Смещение часового пояса от UTC

Описание

пример

dt = tzoffset(t) возвращает массив длительностей, равный смещению часового пояса от UTC каждого значения datetime в t. То есть dt - это время, в течение которого каждый datetime t отличается от UTC. Для дат, приходящихся на летнее и зимнее время, dt включает в себя сдвиг времени для перехода на летнее и зимнее время. Смещение для незональных значений datetime не определено.

пример

[dt,dst] = tzoffset(t) дополнительно возвращает смену времени для перехода на летнее время для каждого даты и времени в t.

Примеры

свернуть все

Создать datetime массив в часовом поясе для Нью-Йорка.

t1 = datetime('today','TimeZone','America/New_York');
t = dateshift(t1,'end','month',[1:3:9])
t = 1x3 datetime
   30-Apr-2021   31-Jul-2021   31-Oct-2021

Найдите смещение часового пояса от UTC и сдвиг времени для перехода на летнее время для каждого значения даты и времени.

[dt,dst] = tzoffset(t)
dt = 1x3 duration
   -04:00   -04:00   -04:00

dst = 1x3 duration
   01:00   01:00   01:00

Входные аргументы

свернуть все

Дата и время ввода, указанные как datetime массив.

Выходные аргументы

свернуть все

Смещение часового пояса от UTC, возвращаемое как скаляр, вектор, матрица или многомерный duration массив. dt имеет тот же размер, что и t.

Сдвиг времени для перехода на летнее время, возвращаемый в виде скаляра, вектора, матрицы или многомерного duration массив. dt имеет тот же размер, что и t. Значение 01:00 указывает, что соответствующее значение datetime в t происходит во время перехода на летнее время в месте, где оно соблюдается. Для местоположений, не соблюдающих летнее время, элементы dst массив - все 00:00.

Расширенные возможности

См. также

Представлен в R2014b