`days`

Duração em dias fixos de 24 horas, ou duração convertida em número de dias.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = days(x)

Cria uma duração de x dias a partir de um número.

n = days(d)

Converte a duração d em um número de dias.

Descrição

Uma entrada numérica vira uma duration cujo formato de exibição é em dias; pode ser somada a datetimes e a outras durações: days(2) + hours(3) é 2.125 days. Uma entrada duration faz o caminho inverso e retorna um número simples, então days(duration(36,0,0)) é 1.5.

Um dia aqui sempre tem 24 horas. Para um passo que segue o calendário, incluindo mudanças de horário de verão, use caldays. Diferenças entre datetimes são durações, então days(t2 - t1) é o número de dias decorridos.

Argumentos de entrada

x: Array numérico.
d: Array duration.

Argumentos de saída

d: Array duration em dias, exibido como 1 day, 2.5 days.
n: Array double com o número de dias.

Exemplo

Nos dois sentidos

days([1 2.5])
days(2) + hours(3)
t1 = datetime(2020,1,1);
t2 = datetime(2020,1,10);
days(t2 - t1)

Saída

ans = 1×2 duration array

      1 day   2.5 days
ans = duration
   2.125 days
ans = 9

Veja também

hours minutes seconds duration caldays