timestamp_micros function

Applies to: Databricks SQL Databricks Runtime

Creates a timestamp expr microseconds since UTC epoch.

Syntax

timestamp_micros(expr)

Arguments

• expr: An integral numeric expression specifying microseconds.

Returns

A TIMESTAMP.

If expr is out of the range representable as a TIMESTAMP, Databricks raises ARITHMETIC_OVERFLOW.

Common error conditions

• ARITHMETIC_OVERFLOW

Examples

SQL

> SELECT timestamp_micros(1230219000123123);
 2008-12-25 07:30:00.123123

> SELECT timestamp_micros(9999999999999999999);
  Error: ARITHMETIC_OVERFLOW

Related functions

• timestamp function
• timestamp_millis function
• timestamp_seconds function