`tzoffset`

Deslocamento em relação ao UTC do fuso horário de um datetime.

Categoria: Language Fundamentals > Data Types

Sintaxe

dt = tzoffset(d)

Retorna o deslocamento em relação ao UTC que vale em cada datetime de d.

Descrição

O valor depende da data, não só do fuso: Nova York fica em -05:00 no inverno e -04:00 no verão. Um datetime sem fuso horário não tem deslocamento, e tzoffset retorna durações NaN para ele.

Para ver o nome do fuso use a propriedade TimeZone, e para listar nomes válidos use timezones.

Argumentos de entrada

d: Array de datetime que tem fuso horário.

Argumentos de saída

dt: Array de duration: horário local menos UTC, incluindo qualquer ajuste de horário de verão naquela data.

Exemplo

Deslocamentos em três fusos

d = datetime(2024,7,1,'TimeZone','America/New_York');
tzoffset(d)
tzoffset(datetime(2024,1,1,'TimeZone','America/Sao_Paulo'))
tzoffset(datetime(2024,1,1,'TimeZone','UTC'))

Saída

ans = duration
   -04:00
ans = duration
   -03:00
ans = duration
   00:00

Veja também

timezones datetime posixtime timeofday