TO_CHAR(DateTime) Function | Data Types and Literals | Teradata Vantage - TO_CHAR(DateTime) - 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 a date_timestamp_value to a character string.

TO_CHAR(DateTime) is a scalar function whose return data type is VARCHAR CHARACTER SET UNICODE.

ANSI Compliance

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

Syntax

[TD_SYSFNLIB.] TO_CHAR (
  date_timestamp_value [, format_arg ]
)

Syntax Elements

TD_SYSFNLIB.
Name of the database where the function is located.
date_timestamp_value
A datetime or interval argument.
format_arg

A character expression.

For valid format_arg values, see TO_DATE.

format_arg is used to format the numeric values. If format_arg is omitted, numeric_expr is converted to a string exactly long enough to hold its significant digits.

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

If this syntax element is NULL, NULL is returned.