toDuration toDuration

Konverterar ett argumentvärde till en längd. Mer information om datatyper finns på den här sidan.

Kategori

Konvertering

Funktionssyntax

toDuration(<parameter>)

Parametrar

Om stränguttryck: godkända format baseras på varaktighetsformatet PnDTnHnMn.nS för ISO-8601 med dagar som anses vara exakt 24 timmar.

Strängen börjar med ett valfritt tecken som anges med ASCII-tecknet för negativ eller positiv symbol. Om värdet är negativt negeras hela perioden. ASCII-bokstaven"P" står bredvid med versaler eller gemener. Därefter finns det fyra avsnitt som består av ett tal och ett suffix. Avsnitten har suffix i ASCII av "D", "H", "M" och "S" för dagar, timmar, minuter och sekunder, vilka accepteras med versaler eller gemener. Suffixen måste finnas i ordning. ASCII-bokstaven "T" måste inträffa före den första förekomsten av en timme, minut eller sekund. Minst en av de fyra avsnitten måste finnas, och om T förekommer måste det finnas minst en sektion efter T. Nummerdelen av varje avsnitt måste bestå av en eller flera ASCII-siffror. Talet kan föregås av ASCII-negativa eller positiva symboler. Antalet dagar, timmar och minuter måste tolkas. Antalet sekunder måste tolkas tillsammans med den valfria fraktionen. Decimaltecknet kan vara antingen en punkt eller ett komma. Den bråkdelar kan innehålla mellan noll och nio siffror.

Underskrifter och returtyp

toDuration(<string>)

toDuration(<integer>)

Returnerar en varaktighet.

Exempel

toDuration("PT10H")

Returnerar längden 10 timmar.

toDuration("PT4S")

Returnerar längden på 4s.

toDuration(4000)

Returnerar längden på 4s.