Oracle/PLSQL: To_YMInterval Function

In Oracle/PLSQL, the to_yminterval function converts a string to an INTERVAL YEAR TO MONTH type.

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.

Applies To

• Oracle 11g, Oracle 10g, Oracle 9i

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.