Show Menu
TÓPICOS×

toDuration

Converte um valor de argumento em uma duração. For more information on data types, refer to Tipos de dados .

Categoria

Conversão

Sintaxe da função

toDuration(<parameter>)

Parâmetros

Parâmetro
Descrição
string
formatos baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados exatamente 24 horas
integer
número de milissegundos
Se expressão de string: os formatos aceitos são baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados exatamente 24 horas.
A string começa com um sinal opcional, denotado pelo símbolo negativo ou positivo ASCII. Se negativo, todo o período é negado. A letra ASCII "P" é a seguinte em maiúsculas ou minúsculas. 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 maiúsculas ou minúsculas. Os sufixos devem ocorrer em ordem. A letra "T" do ASCII deve ocorrer antes da primeira ocorrência, se houver, de uma hora, minuto ou segunda seção. Deve estar presente pelo menos uma das quatro seções e, se "T" estiver presente, deve existir pelo menos uma seção após "T". A parte numérica de cada seção deve consistir em um ou mais dígitos ASCII. O número pode ser prefixado 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.