isdst

Testa se valores datetime caem no horário de verão.

Categoria: Language Fundamentals > Data Types

Sintaxe

tf = isdst(t)

Retorna um array lógico indicando quais elementos do array datetime t estão no horário de verão.

Descrição

Um datetime com fuso horário carrega as regras daquele fuso, incluindo as datas em que os relógios avançam e recuam. isdst consulta essas regras para cada elemento.

Um datetime sem fuso horário não tem regras a aplicar, então o resultado é false em todos os elementos.

Argumentos de entrada

t
Array datetime. Precisa ter um fuso horário para dar uma resposta significativa.

Argumentos de saída

tf
Array lógico do mesmo tamanho de t; true onde o horário de verão está em vigor.

Exemplo

Inverno e verão em Nova York

w = datetime(2024,1,15,'TimeZone','America/New_York');
s = datetime(2024,7,15,'TimeZone','America/New_York');
isdst(w)
isdst(s)
Saída
ans = logical
   0
ans = logical
   1

Veja também

datetime timezones isbetween isweekend