date_format function

Applies to: Databricks SQL Databricks Runtime

Converts a timestamp to a string in the format fmt.

Syntax

date_format(expr, fmt)

Arguments

• expr: A DATE, TIMESTAMP, or a STRING in a valid datetime format.
• fmt: A STRING expression describing the desired format.

Returns

A STRING.

See Datetime patterns for details on valid formats.

If fmt contains an invalid datetime pattern, Azure Databricks raises INVALID_DATETIME_PATTERN.

Common error conditions

• INVALID_DATETIME_PATTERN

Examples

> SELECT date_format('2016-04-08', 'y');
 2016

> SELECT date_format(current_date(), 'QQQQQ');
  Error: INVALID_DATETIME_PATTERN

Related functions

• Datetime patterns