Oracle / PLSQL: TO_YMINTERVAL Function

This article is written about how to use the Oracle/PLSQL TO_YMINTERVAL feature with syntax and examples.


The Oracle/PLSQL TO_YMINTERVAL function converts a string to an INTERVAL YEAR TO MONTH type.


The syntax for the TO_YMINTERVAL function in Oracle/PLSQL is:

TO_YMINTERVAL( character )

Parameters or Arguments

character The cost to convert to an INTERVAL YEAR TO MONTH type. It can be a char, varchar2, nchar, or nvarchar2 value.


The TO_YMINTERVAL characteristic returns an INTERVAL YEAR TO MONTH value.

Applies To

The TO_YMINTERVAL feature can be used in the following versions of Oracle/PLSQL:

Oracle 12c, Oracle 11g, Oracle 10g, Oracle 9i


Let’s seem to be at some Oracle TO_YMINTERVAL feature examples and explore how to use the TO_YMINTERVAL characteristic in Oracle/PLSQL.

For example:

Result: 3 years 11 months   (as an INTERVAL YEAR TO MONTH type)

Result: 1 year 5 months     (as an INTERVAL YEAR TO MONTH type)

Result: 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 might also want to add 1 yr and 5 months to an order date.

select order_date, order_date + to_yminterval('01-05')
from orders;

This SQL assertion would return the order date, as properly as the order date plus 1 year and 5 months.