TO_TIMESTAMP_TZ Function | Data Types and Literals | Teradata Vantage - TO_TIMESTAMP_TZ - 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
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-11-06
dita:mapPath
uds1628112204571.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
exs1472253032394
lifecycle
latest
Product Category
Teradata Vantageā„¢

Converts string_expr to a TIMESTAMP WITH TIME ZONE data type.

TO_TIMESTAMP_TZ is an overloaded scalar function whose return value data type is TIMESTAMP(6) WITH TIME ZONE.

ANSI Compliance

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

Syntax

[TD_SYSFNLIB.] TO_TIMESTAMP_TZ ( string_expr [, format_arg ] )

Syntax Elements

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

A character argument.

If the conversion fails, TO_TIMESTAMP_TZ returns an error.

format_arg

A character expression.

format_arg is a data format specifying the format of string_expr.

format_arg does not convert data to any of the other datetime data types.

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

If format_arg is omitted, a default timestamp with time zone format of YYYY-MM-DD HH24:MI:SS.FF6 TZH:TZM is used.

For valid format_arg values, see TO_DATE.

If this syntax element is NULL, NULL is returned.

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