TO_YMINTERVAL

功能描述

TO_YMINTERVAL函数将其参数转换为YEAR TO MONTH INTERVAL数据类型，即处理时间时仅包含年和月的部分。

注意事项

to_yminterval函数将传入字符串转换为INTERVAL数据类型。函数接收两种格式字符串。

• SQL格式，兼容SQL标准（ISO/IEC9075）。
  • 仅允许出现年和月。
  • 语法元素之间允许任意个空格。
• ISO格式，兼容ISO 8601:2004标准。
  • 年、月、日、时、分、秒和小数秒，均允许输入，但除年和月以外的内容会被忽略。
  • 秒的小数位支持输入9位，超出后报错（虽然秒会被忽略，但会引发报错）。
  • Vastbase年数范围为0到178956970。如果输入月数大于等于12时，会出现向年份进位的情况，进位之后应保证年数范围依然在0到178956970，否则报错。
  • 语法元素之间不允许有空格。

语法格式

TO_YMINTERVAL ( '{ [+|-] years - months } ' [ DEFAULT return_value ON CONVERSION ERROR ])

参数说明

• years

  年，整型，Vastbase取值范围0到178956970（Oracle取值范围0到999999999）。

• months

  小时，整型，范围0到11。

• DEFAULT return_value ON CONVERSION ERROR

  可选参数。该子句允许指定此函数在将参数转换为INTERVAL MONTH TO YEAR类型时发生错误时返回的值。

示例

SELECT to_yminterval('1-1') FROM dual;

返回结果为：

 to_yminterval
---------------
 1 year 1 mon
(1 row)