datetime

Array de instantes no tempo com campos de calendário e relógio.

Categoria: Language Fundamentals > Data Types

Sintaxe

t = datetime(y, m, d)

Datas a partir de ano, mês e dia.

t = datetime(y, m, d, h, mi, s)

Acrescenta hora, minuto e segundo.

t = datetime(str)

Interpreta texto como '2020-03-04'.

t = datetime(str, 'InputFormat', f)

Interpreta texto com um formato explícito.

t = datetime(x, 'ConvertFrom', type)

Converte de 'datenum', 'posixtime', 'excel' e outros.

Descrição

Um datetime guarda um instante e pode ser somado a durações (t + hours(5)), subtraído de outro datetime para obter uma duration, comparado com < e == e consultado por campos como t.Year, t.Month, t.Day. Valores fora do intervalo são normalizados, então o mês 13 significa janeiro do ano seguinte.

Em um padrão para texto, MM significa mês e mm minutos, o contrário de datestr.

Argumentos de entrada

y, m, d, h, mi, s
Arrays numéricos do mesmo tamanho, ou escalares.
'InputFormat'
Padrão que descreve o texto, como 'dd/MM/yyyy'.
'Format'
Formato de exibição.

Argumentos de saída

t
Array datetime.

Exemplo

Criar, deslocar e consultar

t = datetime(2020,3,4,5,6,7)
t + hours(20)
t.Month
datetime('2020-03-04')
datetime(2020,1,2,'Format','yyyy/MM/dd')
Saída
t = datetime
   04-Mar-2020 05:06:07
ans = datetime
   05-Mar-2020 01:06:07
ans = 3
ans = datetime
   04-Mar-2020
ans = datetime
   2020/01/02

Veja também

duration datenum datestr dateshift between calendarDuration