to_date
função
Aplica-se a: do SQL do Databricks Databricks Runtime
Devolve expr
a conversão para uma data utilizando uma formatação opcional.
Sintaxe
to_date(expr [, fmt] )
Argumentos
expr
: uma expressão STRING que representa uma data.- fmt: uma expressão string de formato opcional.
Devolve
UMA DATA.
Se fmt
for fornecido, tem de estar em conformidade com os padrões Datetime.
Se fmt
não for fornecido, a função é um sinónimo de cast(expr AS DATE)
.
Se fmt
tiver um formato incorreto ou a respetiva aplicação não resultar numa data bem formada, a função gera um erro.
Nota
No Databricks Runtime, se spark.sql.ansi.enabled for false
, a função devolve NULL
em vez de um erro para datas mal formadas.
Exemplos
> SELECT to_date('2009-07-30 04:17:52');
2009-07-30
> SELECT to_date('2016-12-31', 'yyyy-MM-dd');
2016-12-31