Função to_timestamp
Aplica-se a: SQL do Databricks
Runtime do Databricks
Retorna a conversão de expr
para um carimbo de data/hora usando uma formatação opcional.
Sintaxe
to_timestamp(expr [, fmt] )
Argumentos
expr
: uma expressão STRING representando um carimbo de data/hora.- fmt: uma expressão STRING de formatação opcional.
Retornos
Um TIMESTAMP.
Se fmt
for fornecido, ele deverá estar em conformidade com os padrões de datetime.
Se fmt
não for fornecido, a função será um sinônimo de cast(expr AS TIMESTAMP)
.
Se fmt
estiver malformado ou seu aplicativo não resultar em um carimbo de data/hora formado corretamente, a função gerará um erro.
Para retornar NULL
em vez de um erro no caso de um malformado expr
use try_to_timestamp.
Observação
No Databricks Runtime, se spark.sql.ansi.enabled for false
, a função retorna 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