Função to_date

Aplica-se a: SQL do Databricks Runtime do Databricks

Retorna a conversão de expr para uma data usando uma formatação opcional.

Sintaxe

to_date(expr [, fmt] )

Argumentos

• expr: uma expressão STRING representando uma data.
• fmt: uma expressão STRING de formatação opcional.

Retornos

Um DATE.

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 DATE).

Se fmt estiver malformado ou seu aplicativo não resultar em uma data bem formada, Azure Databricks gerará um erro.

Condições de erro comuns

• CAST_INVALID_INPUT
• CANNOT_PARSE_TIMESTAMP

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

> SELECT to_date('not-a-date');
  Error: CAST_INVALID_INPUT

Funções relacionadas

• cast função
• date função
• to_timestamp função
• Padrões de datetime