toDuration toDuration

Zet een argumentwaarde in een duur om. Voor meer informatie over gegevenstypes, verwijs naar deze pagina.

Categorie

Conversie

Functiesyntaxis

toDuration(<parameter>)

Parameters

Als tekenreeksexpressie: geaccepteerde notaties zijn gebaseerd op de ISO-8601-duurnotatie PnDTnHnMn.nS met dagen die worden beschouwd als precies 24 uur.

De tekenreeks begint met een optioneel teken, aangeduid met het negatieve of positieve ASCII-symbool. Indien negatief, wordt de hele periode genegeerd. De ASCII-letter "P" staat vervolgens in hoofdletters of kleine letters. Er zijn dan vier secties, elk bestaande uit een getal en een achtervoegsel. De secties hebben achtervoegsels in ASCII van "D", "H", "M" en "S" gedurende dagen, uren, minuten en seconden, die in hoofdletters of in kleine letters worden geaccepteerd. De achtervoegsels moeten op volgorde voorkomen. De ASCII-letter "T" moet vóór het eerste exemplaar van een uur-, minuut- of tweede sectie plaatsvinden, indien aanwezig. Ten minste één van de vier delen moet aanwezig zijn en indien "T" aanwezig is, moet er ten minste één deel na "T" aanwezig zijn. Het nummerdeel van elke sectie moet uit een of meer ASCII-cijfers bestaan. Het getal kan worden voorafgegaan door het negatieve of positieve ASCII-symbool. Het aantal dagen, uren en minuten moet worden geparseerd. Het aantal seconden moet samen met de optionele breuk parseren. Het decimale punt kan een punt of een komma zijn. Het fractionele deel kan van nul tot 9 cijfers hebben.

Handtekeningen en type geretourneerd

toDuration(<string>)

toDuration(<integer>)

Retourneert een duur.

Voorbeelden

toDuration("PT10H")

Geeft een duur van 10 uur.

toDuration("PT4S")

Retourneert de duur van 4s.

toDuration(4000)

Retourneert de duur van 4s.