`caldiff`

Diferenças entre valores datetime consecutivos, como durações de calendário.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = caldiff(t)

Retorna as diferenças de calendário entre elementos consecutivos de t.

d = caldiff(t, components)

Expressa as diferenças nas unidades indicadas, como 'days' ou 'months'.

Descrição

caldiff(t) está para between como diff está para a subtração: aplica between(t(k), t(k+1)) a cada par vizinho. Trabalhando na primeira dimensão não singleton, um vetor de n datas gera n-1 diferenças.

Sem components, cada diferença é dividida em meses e dias. Passar 'days' força uma contagem pura de dias.

Argumentos de entrada

t: Vetor ou array datetime.
components: Unidades a usar, por exemplo 'days', 'months', 'years'.

Argumentos de saída

d: Array calendarDuration com um elemento a menos na dimensão de trabalho.

Exemplo

Intervalos entre datas

t = [datetime(2024,1,1) datetime(2024,3,5) datetime(2024,3,6)];
caldiff(t)
caldiff(t(1:2), 'days')

Saída

ans = 1×2 calendarDuration array

   2mo 4d       1d
ans = calendarDuration
   64d

Veja também

between diff datetime calendarDuration