toDuration toDuration

将参数值转换为持续时间。 有关数据类型的详细信息，请参阅此页面。

类别

转化

函数语法

toDuration(<parameter>)

参数

如果字符串表达式：接受的格式基于ISO-8601持续时间格式PnDTnHnMn.nS，天数被认为刚好是24小时。

字符串以可选符号开头，由ASCII负号或正号表示。 如果为负值，则整个期间将被否定。 ASCII字母“P”是下一个大写或小写。 然后有四个部分，每个部分包含一个数字和一个后缀。 各节的ASCII后缀为“D”、“H”、“M”和“S”，表示日、小时、分钟和秒，可使用大写或小写。 后缀必须按顺序出现。 ASCII字母“T”必须出现在小时、分钟或秒部分的第一次（如果有）之前。 四个部分中的至少一个必须存在，如果存在“T”，则“T”后面必须至少有一个部分。 每个部分的数字部分必须包含一个或多个ASCII数字。 数字可以用ASCII负号或正号作为前缀。 必须将天数、小时数和分钟数解析为。 必须解析到的秒数以及可选的分数。 小数点可以是点或逗号。 小数部分可以有0到9位数字。

签名和返回的类型

toDuration(<string>)

toDuration(<integer>)

返回持续时间。

示例

toDuration("PT10H")

返回10小时的持续时间。

toDuration("PT4S")

返回4秒的持续时间。

toDuration(4000)

返回4秒的持续时间。