VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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)