- 类别:
TRY_TO_TIME¶
TO_TIME、TIME 的特殊版本,它执行相同的操作(即将输入表达式转换为时间),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。
有关更多信息,请参阅 错误处理转换函数。
- 另请参阅:
语法¶
TRY_TO_TIME( <string_expr> [, <format> ] )
TRY_TO_TIME( '<integer>' )
实参¶
必填:
其中之一:
string_expr
可以转换为有效时间的字符串。
'integer'
计算结果为包含整数的字符串的表达式,例如
'15000000'
。根据字符串的大小,它可以解释为秒、毫秒、微秒或纳秒。有关详细信息,请参阅 使用说明。
可选:
format
string_expr
或 AUTO 的格式说明符。有关更多信息,请参阅 转换函数中的日期和时间格式。默认值为 TIME_INPUT_FORMAT 会话参数的当前值(默认为 AUTO)。
返回¶
返回值的数据类型是 TIME。
使用说明¶
输出中的时间显示格式由 TIME_OUTPUT_FORMAT 会话参数(默认为
HH24:MI:SS
)确定。如果输入参数的格式是包含整数的字符串,则值的度量单位(秒、微秒、毫秒或纳秒)按如下方式确定:
将字符串转换为整数后,该整数被视为自 Unix 纪元时间 (1970-01-01 00:00:00.000000000 UTC) 开始后的秒数、毫秒数、微秒数或纳秒数。
如果整数小于 31536000000(一年中的毫秒数),则该值被视为秒数。
如果该值大于或等于 31536000000 且小于 31536000000000,则该值被视为毫秒数。
如果该值大于或等于 31536000000000 且小于 31536000000000000,则该值被视为微秒数。
如果该值大于或等于 31536000000000000,则该值被视为纳秒数。
如果评估多行(例如,如果输入内容是包含多行的表的列名),则每个值都将单独得到检查,以确定该值表示的是秒数、毫秒数、微秒数还是纳秒数。
示例¶
此示例使用 TRY_TO_TIME:
SELECT TRY_TO_TIME('12:30:00'), TRY_TO_TIME('Invalid');
+-------------------------+------------------------+
| TRY_TO_TIME('12:30:00') | TRY_TO_TIME('INVALID') |
|-------------------------+------------------------|
| 12:30:00 | NULL |
+-------------------------+------------------------+
有关将输入表达式转换为时间的示例,请参阅 TO_TIME、TIME。