Converts string_expr or integer_expr to a TIMESTAMP data type.
TO_TIMESTAMP is an overloaded scalar function whose return value data type is TIMESTAMP(6).
ANSI Compliance
This statement is a Teradata extension to the ANSI SQL:2011 standard.
Syntax
[TD_SYSFNLIB.] TO_TIMESTAMP ( { string_expr, format_arg | integer } )
Syntax Elements
- 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.