caldays

Dias de calendário, para aritmética de datas que respeita o calendário.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = caldays(n)

Cria uma calendarDuration de n dias de calendário.

Descrição

Um dia de calendário avança a data em um dia civil, mantendo o horário, mesmo numa mudança de horário de verão em que o dia não tem 24 horas. Por isso difere de days, que é uma duration fixa de 24 horas.

Some o resultado a um datetime: t + caldays(3). Várias unidades de calendário podem ser somadas, como em calmonths(1) + caldays(2).

Argumentos de entrada

n
Array numérico com quantidades de dias (inteiros para comportamento exato de calendário).

Argumentos de saída

d
Array calendarDuration, do mesmo tamanho de n.

Exemplo

Somando dias

t = datetime(2024,1,31);
t + caldays(1)
caldays(3)
Saída
ans = datetime
   01-Feb-2024
ans = calendarDuration
   3d

Veja também

days calweeks calmonths calendarDuration datetime