to_date-functie

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Retourneert expr cast naar een datum met een optionele opmaak.

Syntaxis

to_date(expr [, fmt] )

Argumenten

  • expr: Een TEKENREEKS-expressie die een datum vertegenwoordigt.
  • fmt: Een optionele notatie STRING-expressie.

Retouren

EEN DATUM.

Als fmt dit wordt opgegeven, moet deze voldoen aan datum/tijd-patronen.

Als fmt deze niet wordt opgegeven, is de functie een synoniem voor cast(expr AS DATE).

Als fmt ongeldig is of de toepassing niet resulteert in een goed gevormde datum, Azure Databricks een fout veroorzaakt.

Algemene foutvoorwaarden

Notitie

Als in Databricks Runtime spark.sql.ansi.enabledretourneert false de functie in plaats van een fout voor ongeldige datums.

Voorbeelden

> 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