NUMTODSINTERVAL

语法：

NUMTODSINTERVAL(num, 'interval_unit')

功能：输入一个数值和interval域描述字段，输出INTERVAL DAY TO SECOND类型。

其中参数num可以是：

• 一个数值类型: 整数、大整数、浮点数、高精度数值类型NUMBER 。

• 可以隐式转换为数值的表达式。

具体的输入输出关系，见表1。

说明：参数interval_unit是一个字符串类型，指示了num对应INTERVAL类型的域。对于NUMTODSINTERVAL函数，其interval_unit可以为：DAY、HOUR、MINUTE和SECOND。注意interval_unit对大小写不敏感，首尾空格会被忽视。

示例：

返回当前时间1小时后的时间。

SELECT SYSDATE + NUMTODSINTERVAL(1, 'HOUR') from DUAL;

SYSDATE + NUMTODSINTERVAL(1, 'HOUR')
------------------------------------
2018-12-05 10:42:39

1 rows fetched.

NUMTOYMINTERVAL

语法：

NUMTOYMINTERVAL(num, 'interval_unit')

功能：输入一个数值和interval域描述字段，输出INTERVAL YEAR TO MONTH类型。

说明：

• 参数interval_unit是一个字符串类型，指示了num对应INTERVAL类型的域。对于NUMTOYMINTERVAL函数，其interval_unit可以为：YEAR和MONTH。注意interval_unit对大小写不敏感，首尾空格会被忽视。

• 其中参数num可以是:

• 一个数值类型: 整数、大整数、浮点数、高精度数值类型NUMBER 。

• 可以隐式转换为数值的表达式。

具体的输入输出关系，见表2。

示例：

返回当前时间1个月后的时间。

SELECT SYSDATE + NUMTOYMINTERVAL(1, 'MONTH') from DUAL;

SYSDATE + NUMTOYMINTERVAL(1, 'MONTH')
-------------------------------------
2019-01-05 09:33:28

1 rows fetched.

TO_DSINTERVAL

语法：

TO_DSINTERVAL(str_exp)

功能：输入INTERVAL字符串，输出INTERVAL DAY TO SECOND的值。

用于表示间隔中的天(DAY)和时间(包括时、分、秒、微秒)。适用于表示更精确的时间。

说明：

• TO_DSINTERVAL的ISO格式是至少要从DAY开始，不能指定YEAR或MONTH单元，否则会报语法错误。

• 在SQL间隔格式中，每个格式元素之间允许空格存在；但在ISO间隔格式中，格式元素之间不允许存在空格。

• TO_DSINTERVAL的ISO格式也需要遵循TO_YMINTERVAL函数的ISO格式限制。

  每个域的取值，如表3所示。

  表3 取值范围表

  域名称	SQL格式取值范围	ISO格式取值范围
  years	[0, 9999]	[0, 9999]
  months	[0, 11]	[0, 99999]
  days	[0, 9999999]	[0, 9999999]
  hours	[0, 23]	[0, 999999999]
  minutes	[0, 59]	[0, 999999999]
  seconds	[0, 59]	[0, 999999999]
  frac_secs	>=0，最多存6位有效数字	>=0，最多存6位有效数字

  各格式元素输出结果，如表4所示。

  表4 输出结果示例表

  输入	输出	说明
  '-PT23H23M23S'	-00 23:23:23.000000	-
  '-PT23H23M23.003333999S'	-00 23:23:23.003334	四舍五入，最多保留6位小数
  'PT999999M'	+694 10:39:00.000000	-
  '-P012M28DT21H213.00S'	错误	DSINTERVAL类型必须从DAY开始
  'PT123123M123H'	错误	MINUTE域不能出现在HOUR后面
  '-P100DT'	错误	若T被指定时，后面至少有一个时间域
  '-P12DT.00123S'	错误	未指定SECOND域的值
  'PT12.3H312.999999999999S'	错误	HOUR域只能为整数
  'P12H'	错误	时间域必须在T之后
  'PT12H12H'	错误	不允许对同一域多少赋值
  'PT12H12.S'	错误	若SECOND存在小数点，则后面FRAC_SEC也必须被指定
  '12 12:12:12'	+12 12:12:12.000000	-
  '-0 0:0:0'	+00 00:00:00.000000	-
  '9999999 23:59:59.999999'	+9999999 23:59:59.999999	-
  ' - 00012 0012 : 00012 : 000000000000012 '	-12 12:12:12.000000	允许首尾，域之间存在空格
  '+00 0:0:0. 0'	错误	SECOND和FRAC_SEC域之间不允许存在空格
  '+00 24:0:0.0'	错误	SQL格式中HOUR域最大值为23
  '+00 11:80:0.0'	错误	SQL格式中MINUTE域最大值为59
  '+00 11:11'	错误	格式错误

示例：

--删除表employee。 
DROP TABLE IF EXISTS employee;
--创建表employee。 
CREATE TABLE employee(employee_id INT NOT NULL,first_name VARCHAR(10),last_name VARCHAR(10), hire_date DATETIME);
--加入几条数据。
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1001,'Alice','BROWN','2017-06-20 12:00:00');
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1002,'BOB','Smith','2017-10-20 12:00:00');
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1003,'ALAN','Jones','2017-05-10 12:00:00');
--提交事务。
COMMIT;
--至2018年1月1日已经为公司工作100天的员工。
SELECT employee_id, first_name, last_name FROM employee WHERE hire_date + TO_DSINTERVAL('100 00:00:00') <= DATE '2018-01-01' ORDER BY employee_id;
EMPLOYEE_ID  FIRST_NAME LAST_NAME
------------ ---------- ----------
1001         Alice      BROWN
1003         ALAN       Jones

2 rows fetched.

TO_YMINTERVAL

语法：

TO_YMINTERVAL(str_exp)

功能：输入INTERVAL字符串，输出INTERVAL YEAR TO MONTH的值。

用于表示间隔中的年(YEAR)和月(MONTH)。适用于只关注时间差的年和月。

TO_YMINTERVAL支持两种文本输入格式:

• SQL时间间隔格式: 与SQL标准(ISO/IEC 9075:2003)兼容。

• ISO时间间隔格式: 与ISO 8601:2004标准兼容。

  两种标准下不同域的取值范围，请参见表5。

  表5 取值范围表

  域名称	SQL格式取值范围	ISO格式取值范围
  years	[0, 9999]	[0, 9999]
  months	[0, 11]	[0, 99999]
  days	[0, 9999999]	[0, 9999999]
  hours	[0, 23]	[0, 999999999]
  minutes	[0, 59]	[0, 999999999]
  seconds	[0, 59]	[0, 999999999]
  frac_secs	>=0，最多存6位有效数字	>=0，最多存6位有效数字

  ISO各格式元素输出结果，如表6所示。

  表6 输出结果示例表

  输入	输出	说明
  'P01Y02M'	+01-02	-
  'P24M'	+02-00	-
  '-P0Y123M'	-10-03	-
  '-P9999Y999999M'	错误	MONTH域超出范围(<=99999)
  'P9999DT2000H'	+00-00	YEAR和MONTH域未指定值，忽视其他域的值
  '-P012.3M23D'	错误	每个域只能为整数
  '-P 12M'	错误	ISO格式中不允许空格
  ' -P12M '	-01-00	允许首尾存在空格
  '-P12M33Y'	错误	YEAR域不能在MONTH域之后
  '1233-0'	+1233-00	-
  '- 1233 - 2'	-1233-02	SQL格式中允许空格
  ' +00-000003'	+00-03	允许首尾空格，域可以以多个0开始
  '12332-1'	错误	YEAR域超出范围(<=9999)
  '12-12'	错误	SQL格式中MONTH域超出范围(<=11)
  '223'	错误	不满足格式要求

说明：

• 所有域的取值都是非负整数。

• 在TO_YMINTERVAL函数中，即使指定了DAY、HOUR、MINUTE等域的值，它们仍将会被忽略，TO_YMINTERVAL函数仅关注YEAR和MONTH域指定的值。

• 在ISO格式中域的值必须按顺序指定，例如YEAR域不能出现在MONTH域之后。

• 若指定时间域指示符T，其后面至少出现一个时间域。

• 当指定FRAC_SEC域时，SECOND也必须被指定，且它们之间不允许存在空格。

示例：

返回当前时间开始1年零两个月后的时间。

SELECT (SYSDATE) + TO_YMINTERVAL('01-02') from DUAL;

(SYSDATE) + TO_YMINTERVAL('01-02')
----------------------------------2020-02-04 17:17:501 rows fetched.
--创建表employee。 
CREATE TABLE employee(employee_id INT NOT NULL,first_name VARCHAR(10),last_name VARCHAR(10), hire_date DATETIME);
--加入几条数据。
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1001,'Alice','BROWN','2017-06-20 12:00:00');
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1002,'BOB','Smith','2017-10-20 12:00:00');
INSERT INTO employee(employee_id,first_name,last_name,hire_date) VALUES(1003,'ALAN','Jones','2017-05-10 12:00:00');
--提交事务。
COMMIT;
--至2018年1月1日已经为公司工作100天的员工。
SELECT employee_id, first_name, last_name FROM employee WHERE hire_date + TO_DSINTERVAL('100 00:00:00') <= DATE '2018-01-01' ORDER BY employee_id;

EMPLOYEE_ID  FIRST_NAME LAST_NAME
------------ ---------- ----------
1001         Alice      BROWN
1003         ALAN       Jones

2 rows fetched.