NUMTODSINTERVAL Function | Data Types and Literals | Teradata Vantage - NUMTODSINTERVAL - Advanced SQL Engine - Teradata Database

SQL Data Types and Literals

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Published
July 2021
Language
English (United States)
Last Update
2021-07-27
dita:mapPath
tpf1598412463935.ditamap
dita:ditavalPath
tpf1598412463935.ditaval
dita:id
B035-1143
lifecycle
previous
Product Category
Teradata Vantageā„¢

Converts a numeric_value into an INTERVAL DAY(4) TO SECOND(6) value.

The return value data type is INTERVAL DAY(4) TO SECOND(6).

ANSI Compliance

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

Syntax

[TD_SYSFNLIB.] NUMTODSINTERVAL ( 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:
  • 'DAY'
  • 'HOUR'
  • 'MINUTE'
  • 'SECOND'

Any value that overflows the INTERVAL DAY(4) TO SECOND(6) value results in an error.

If this syntax element is NULL, NULL is returned.