`calendarDuration`

Intervalos de tempo em unidades de calendário: anos, meses, dias e horário.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = calendarDuration(y, m, d)

Cria uma duração de y anos, m meses e d dias.

d = calendarDuration(y, m, d, h, mi, s)

Inclui também horas, minutos e segundos.

Descrição

Uma calendarDuration guarda anos, meses, dias e horário como componentes separados. calendarDuration(1,2,3) significa portanto um ano, dois meses e três dias, e não um número fixo de segundos. Seu efeito é definido quando é somada a um datetime.

Os construtores calyears, calmonths, calweeks e caldays criam um único componente e podem ser somados: calyears(1) + calmonths(2).

Argumentos de entrada

y, m, d: Anos, meses e dias (inteiros).
h, mi, s: Horas, minutos e segundos.

Argumentos de saída

d: Objeto calendarDuration. Seu comprimento real em dias depende da data a que é somado.

Exemplo

Criar e somar

d = calendarDuration(1,2,3)
datetime(2020,1,31) + d

Saída

d = calendarDuration
   1y 2mo 3d
ans = datetime
   03-Apr-2021

Veja também

caldays calmonths calyears between datetime