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

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 a expressão da string: os formatos aceitos são baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados exatamente 24 horas.

A string start 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 delas 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.

Nesta página