TO_TIMESTAMP

Teradata Vantageā„¢ Data Types and Literals

prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
Programming Reference
featnum
B035-1143-162K

Purpose

Converts string_expr or integer_expr to a TIMESTAMP data type.

Syntax



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

A character argument.

If the conversion fails, TO_TIMESTAMP returns an error.

format_arg

A character expression.

format_arg is a data format specifying the format of string_expr.

For valid format_arg values, see TO_DATE.

Any fractional seconds that are specified beyond 6 digits are truncated.

If format_arg is omitted, TO_TIMESTAMP uses a default timestamp format of YYYY-MM-DD HH24:MI:SS.FF6.

If this syntax element is NULL, NULL is returned.

If this syntax element is not valid, an error is returned.

integer_expr

a number argument.

POSIX epoch conversion is implicit in the TO_TIMESTAMP function when integer_expr is passed to the function.

POSIX epoch is the number of seconds that have elapsed since midnight Coordinated Universal Time (UTC) of January 1, 1970.