duration

Intervalo de tempo como número de horas, minutos e segundos.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = duration(h, m, s)

d = duration(h, m, s, ms)

d = duration(___, 'Format', f)

Descrição

Uma duração é um tempo decorrido exato, guardado internamente em dias. As horas não voltam a zero em 24: duration(25,30,0) é 25:30:00, e duration(0,0,90) é 00:01:30. Durações podem ser somadas e subtraídas, multiplicadas por números, comparadas e somadas a datetimes. Converta para números com hours, minutes, seconds ou days.

As funções seconds, minutes, hours, days e years são formas mais curtas de criar durações a partir de um único número.

Argumentos de entrada

h, m, s

Arrays numéricos do mesmo tamanho, ou escalares. Valores fora da faixa usual são normalizados.

'Format'

Formato de exibição: 'hh:mm:ss' (padrão), 'hh:mm', 'd', 'hh:mm:ss.SSS' e outros.

Argumentos de saída

d

Array duration.

Exemplo

Criar, combinar e converter

d = duration(25, 30, 0)
d + duration(0, 45, 0)
duration(2, 0, 0) > duration(1, 30, 0)
hours(duration(2, 30, 0))
duration(26, 0, 0, 'Format', 'd')

d = duration
   25:30:00
ans = duration
   26:15:00
ans = logical
   1
ans = 2.5000
ans = duration
   1.0833 days

Veja também

hours minutes seconds days datetime calendarDuration