toDuration

Converte um valor de argumento em uma duração. Para obter mais informações sobre tipos de dados, consulte esta página.

Categoria

Conversão

Sintaxe da função

toDuration(<parameter>)

Parâmetros

Se expressão da string: Os formatos aceites são baseados no formato ISO-8601 duration PnDTnHnMn.sS com dias considerados exatamente 24 horas.

A string começa com um sinal opcional, denotado pelo símbolo negativo ou positivo ASCII. Se for negativo, todo o período é negado. A letra ASCII "P" é a próxima em maiúscula ou minúscula. Em seguida, há quatro seções, cada uma com um número e um sufixo. As seções têm sufixos no ASCII de "D", "H", "M" e "S" para dias, horas, minutos e segundos, aceitos em letras maiúsculas ou minúsculas. Os sufixos devem ocorrer em ordem. A letra ASCII "T" deve ocorrer antes da primeira ocorrência, se houver, de uma hora, minuto ou segunda seção. Pelo menos uma das quatro seções deve estar presente e, se "T" estiver presente, deve haver pelo menos uma seção após o "T". A parte do número de cada seção deve consistir em um ou mais dígitos ASCII. O número pode ser pré-fixado pelo símbolo negativo ou positivo ASCII. O número de dias, horas e minutos deve ser analisado. O número de segundos deve ser analisado junto com a fração opcional. O ponto decimal pode ser um ponto ou uma vírgula. A parte fracional pode ter de zero a 9 dígitos.

Assinaturas e tipo retornado

toDuration(<string>)

toDuration(<integer>)

Retorna uma duração.

Exemplos

toDuration("PT10H")

Retorna a duração de 10 horas.

toDuration("PT4S")

Retorna a duração de 4s.

toDuration(4000)

Retorna a duração de 4s.