calmonths

Meses de calendário, para aritmética de datas que respeita a duração dos meses.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = calmonths(n)

Cria uma calendarDuration de n meses de calendário.

Descrição

Somar calmonths(1) a uma data avança o número do mês em um e mantém o dia. Se o mês de destino for mais curto, o resultado é limitado ao seu último dia, então 31 de janeiro mais um mês dá 29 de fevereiro em ano bissexto.

Um mês não tem número fixo de dias, então não há equivalente em duration.

Argumentos de entrada

n
Array numérico com quantidades de meses.

Argumentos de saída

d
Array calendarDuration, do mesmo tamanho de n.

Exemplo

Limite no fim do mês

datetime(2024,1,31) + calmonths(1)
calmonths(1:3)
Saída
ans = datetime
   29-Feb-2024
ans = 1×3 calendarDuration array

   1mo   2mo   3mo

Veja também

calyears calquarters caldays calendarDuration eomday