toDuration toDuration

Converte un valore di argomento in una durata. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.

Categoria

Conversione

Sintassi della funzione

toDuration(<parameter>)

Elemento “parameters”

Espressione stringa: i formati accettati sono basati sul formato di durata ISO-8601 PnDTnHnMn.nS con giorni considerati esattamente 24 ore.

La stringa inizia con un segno facoltativo, indicato dal simbolo ASCII negativo o positivo. Se negativo, l'intero periodo viene ignorato. La lettera ASCII "P" è successiva in maiuscolo o in minuscolo. Ci sono poi quattro sezioni, ciascuna composta da un numero e un suffisso. Le sezioni hanno suffissi in ASCII di "D", "H", "M" e "S" per giorni, ore, minuti e secondi, accettati in maiuscolo o minuscolo. I suffissi devono essere disposti in ordine. La lettera ASCII "T" deve precedere la prima occorrenza, se presente, di un'ora, un minuto o una seconda sezione. Deve essere presente almeno una delle quattro sezioni e, se "T" è presente, deve esserci almeno una sezione dopo la "T". La parte numerica di ogni sezione deve essere costituita da una o più cifre ASCII. Il numero può essere preceduto dal simbolo ASCII negativo o positivo. Il numero di giorni, ore e minuti deve essere analizzato in lungo. Il numero di secondi deve essere analizzato insieme alla frazione facoltativa. Il punto decimale può essere un punto o una virgola. La parte frazionaria può avere da zero a 9 cifre.

Firme e tipo restituito

toDuration(<string>)

toDuration(<integer>)

Restituisce una durata.

Esempi

toDuration("PT10H")

Restituisce una durata di 10 ore.

toDuration("PT4S")

Restituisce una durata di 4 secondi.

toDuration(4000)

Restituisce una durata di 4 secondi.