Oracle/PLSQL: TO_YMINTERVAL Function
The Oracle/PLSQL TO_YMINTERVAL function converts a string to an INTERVAL YEAR TO MONTH type.
TO_YMINTERVAL Function Syntax
The syntax for the TO_YMINTERVAL function is:
TO_YMINTERVAL( character )
character is the value to convert to an INTERVAL YEAR TO MONTH type. It can be a char, varchar2, nchar, or nvarchar2 value.
The TO_YMINTERVAL function can be used in the following versions of Oracle/PLSQL:
- Oracle 12c, Oracle 11g, Oracle 10g, Oracle 9i
TO_YMINTERVAL Function Examples
The TO_YMINTERVAL function can be used in Oracle/PLSQL. For example:
|TO_YMINTERVAL('03-11')||would return 3 years 11 months as an INTERVAL YEAR TO MONTH type|
|TO_YMINTERVAL('01-05')||would return 1 year 5 months as an INTERVAL YEAR TO MONTH type|
|TO_YMINTERVAL('00-01')||would return 0 years 1 month as an INTERVAL YEAR TO MONTH type|
The TO_YMINTERVAL function is most commonly used to add an interval to a date field. For example, you may wish to add 1 year and 5 months to an order date.
select order_date, order_date + to_yminterval('01-05') from orders;
This SQL statement would return the order date, as well as the order date plus 1 year and 5 months.