Oracle TO_DSINTERVAL() 函数使用指南

Oracle TO_DSINTERVAL() 是一个内置函数，它将给定的字符串参数转为一个 INTERVAL DAY TO SECOND 类型的值。

Oracle TO_DSINTERVAL() 语法

这里是 Oracle TO_DSINTERVAL() 函数的语法：

TO_DSINTERVAL(str, [ DEFAULT return_value ON CONVERSION ERROR ])

参数

str

必需的。它可以是指定计算结果为 CHAR、VARCHAR2、NCHAR 或 NVARCHAR2 数据类型的字符串的任何表达式。您可以使用两种格式的其中一种：

• 与 SQL 标准 (ISO/IEC 9075) 兼容的 SQL 间隔格式： [+|-] days hours:minutes:seconds[.frac_secs]。其中，days 是 0 到 999999999 之间的整数，hours 是 0 到 23 之间的整数，minutes 和 seconds 是 0 到 59 之间的整数。frac_secs 秒的小数部分，它介于 .0 到 .999999999 之间。一个或多个空格将天与小时分开。格式元素之间允许有额外的空格。

• 与 ISO 8601:2004 标准兼容的 ISO 持续时间格式： [-]P[daysD][T[hoursH][minutesM][seconds[.frac_secs]S]]。其中，days、hours、minutes 和 seconds 是介于 0 和 999999999 之间的整数。frac_secs 秒的小数部分，它介于 .0 到 .999999999 之间。值中不允许有空格。如果指定 T，则必须至少指定 hours、 minutes 或 seconds 中的一个。

DEFAULT return_value ON CONVERSION ERROR

可选的。它允许您指定在转换发生错误时返回的值。

返回值

Oracle TO_DSINTERVAL() 函数返回一个 INTERVAL DAY TO SECOND 类型的值。

如果任意一个参数为 NULL， TO_DSINTERVAL() 将返回 NULL。

Oracle TO_DSINTERVAL() 示例

这里有几个展示了 Oracle TO_DSINTERVAL() 函数用法的示例。

SQL 格式

本示例使用 SQL 格式传入一个区间值：

SELECT
    TO_DSINTERVAL('100 10:11:12.123')  "Result1",
    TO_DSINTERVAL('+100 10:11:12.123') "Result2",
    TO_DSINTERVAL('-100 10:11:12.123') "Result3"
FROM dual;

输出：

Result1                 Result2                 Result3
_______________________ _______________________ _______________________
+100 10:11:12.123000    +100 10:11:12.123000    -100 10:11:12.123000

ISO 格式

本示例使用 ISO 格式传入一个区间值：

SELECT
    TO_DSINTERVAL('P100DT10H11M12.123S')  "Result1",
    TO_DSINTERVAL('-P100DT10H11M12.123S') "Result2"
FROM dual;

输出：

Result1                 Result2
_______________________ _______________________
+100 10:11:12.123000    -100 10:11:12.123000

错误

如果您提供了一个错误的格式， Oracle TO_DSINTERVAL() 函数将报告一个错误：

SELECT
    TO_DSINTERVAL('+P100DT10H11M12.123S')
FROM dual;

输出：

SQL Error: ORA-01867: the interval is invalid
01867. 00000 -  "the interval is invalid"
*Cause:    The character string you specified is not a valid interval.
*Action:   Please specify a valid interval.

在本示例中，由于 IOS 格式不支持 + 符号，因此 Oracle 报告了一个错误。 Oracle TO_DSINTERVAL() 函数允许您指定一个默认值以应对转换出错：

SELECT
    TO_DSINTERVAL(
      '+P100DT10H11M12.123S'
      DEFAULT 'P100DT10H11M12.123S' ON CONVERSION ERROR
    ) "Result"
FROM dual;

输出：

Result
_______________________
+100 10:11:12.123000

NULL 参数

如果任意一个参数为 NULL， TO_DSINTERVAL() 将返回 NULL。

SET NULL 'NULL';
SELECT
    TO_DSINTERVAL(NULL)
FROM dual;

输出：

TO_DSINTERVAL(NULL)
______________________
NULL

在本示例中，我们使用 SET NULL 'NULL'; 语句将 NULL 值显示为 'NULL' 字符串。

结论

Oracle TO_DSINTERVAL() 是一个内置函数，它将给定的字符串参数转为一个 INTERVAL DAY TO SECOND 类型的值。