NUMTOYMININTERVAL Function | Data Types and Literals | Teradata Vantage - NUMTOYMINTERVAL - Teradata Vantage - Analytics Database

SQL Data Types and Literals

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Publication Date
June 2022
Content Type
Data Types
SQL Reference
Publication ID
B035-1143-172K
ft:locale
en-US
ft:lastEdition
2025-11-06
dita:mapPath
uds1628112204571.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
ft:sourceId
dita
dita:id
exs1472253032394
lifecycle
latest
Product Category
Teradata Vantageā„¢

Converts numeric_value into an INTERVAL YEAR(4) TO MONTH value.

The return value data type is INTERVAL YEAR(4) TO MONTH.

ANSI Compliance

This statement is a Teradata extension to the ANSI SQL:2011 standard.

Syntax

[TD_SYSFNLIB.] NUMTOYMINTERVAL ( numeric_value, interval_unit )

Syntax Elements

TD_SYSFNLIB.
Name of the database where the function is located.
numeric_value

A numeric argument.

If this syntax element is NULL, NULL is returned.

interval_unit

A character expression.

interval_unit specifies the unit of value for numeric_value. It must be one of the following case-insensitive values:
  • 'YEAR'
  • 'MONTH'

Any value that overflows the INTERVAL YEAR(4) TO MONTH value results in an error.

If this syntax element is NULL, NULL is returned.