Partilhar via


Função to_timestamp

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna expr a conversão para um carimbo de data/hora usando uma formatação opcional.

Sintaxe

to_timestamp(expr [, fmt] )

Argumentos

  • expr: Uma expressão STRING que representa um carimbo de data/hora.
  • fmt: Uma expressão STRING de formato opcional.

Devoluções

UM CARIMBO DE DATA/HORA.

Se fmt for fornecido, ele deve estar em conformidade com os padrões Datetime.

Se fmt não for fornecida, a função é sinônimo de cast(expr AS TIMESTAMP).

Se fmt estiver mal formado ou a sua aplicação não resultar num carimbo temporal bem definido, Azure Databricks gera um erro.

Para retornar NULL em vez de um erro em caso de um uso malformado expr try_to_timestamp.

Condições de erro comuns

Nota

No Databricks Runtime, se spark.sql.ansi.enabled for false, a função retornará NULL em vez de um erro para carimbos de data/hora malformados.

Exemplos

> SELECT to_timestamp('2016-12-31 00:12:00');
 2016-12-31 00:12:00

> SELECT to_timestamp('2016-12-31', 'yyyy-MM-dd');
 2016-12-31 00:00:00

> SELECT to_timestamp('not-a-timestamp');
  Error: CAST_INVALID_INPUT