datenum

Número serial de data: dias contados a partir de uma origem fixa.

Categoria: Language Fundamentals > Data Types

Sintaxe

n = datenum(y, m, d)

Número de data para ano, mês e dia.

n = datenum(y, m, d, h, mi, s)

Acrescenta o horário como fração do dia.

n = datenum(V)

A partir de um vetor de data [y m d h mi s].

n = datenum(str, format)

A partir de texto interpretado com um formato como 'yyyy-mm-dd'.

Descrição

O dia 1 de janeiro do ano 0 é o número de data 1, então datenum(2020,1,1) vale 737791. Por ser um número simples, diferenças entre números de data são intervalos em dias, e podem ser ordenadas ou plotadas diretamente.

Código novo geralmente prefere datetime, mais claro; datenum continua comum por compatibilidade, e datenum(t) também aceita um datetime.

Argumentos de entrada

y, m, d
Ano, mês, dia (meses e dias fora do intervalo são normalizados).
str
Texto de data.
format
Padrão que descreve str.

Argumentos de saída

n
Double. A parte inteira é a contagem de dias, a fração é o horário.

Exemplo

A partir de partes e de texto

datenum(2020,1,1)
datenum(2020,3,1) - datenum(2020,2,1)
datenum('2020-01-02', 'yyyy-mm-dd')
Saída
ans = 737791
ans = 29
ans = 737792

Veja também

datetime datestr datevec now calendar