Fonction unix_timestamp

S’applique à :case marquée oui Databricks SQL case marquée oui Databricks Runtime

Retourne le timestamp UNIX de l’heure actuelle ou spécifiée.

Syntaxe

unix_timestamp([expr [, fmt] ] )

Arguments

  • expr : expression facultative de type DATE, TIMESTAMP ou chaîne (STRING) dans un format de dateheure valide.
  • fmt : expression facultative de type chaîne (STRING) spécifiant le format si expr est une chaîne (STRING).

Retours

Une valeur BIGINT.

Si aucun argument n’est fourni, la valeur par défaut est le timestamp actuel. fmt est ignoré si expr est une DATE ou un TIMESTAMP. Si expr est une chaîne (STRING), fmt est utilisé pour convertir la chaîne en TIMESTAMP avant de calculer le timestamp UNIX.

La valeur fmt par défaut est 'yyyy-MM-dd HH:mm:ss'.

Pour connaître les modèles de format de date et d’heure valides, consultez Modèles de dateheure.

Si fmt ou expr ne sont pas valides, Azure Databricks déclenche CANNOT_PARSE_TIMESTAMP.

Notes

Dans Databricks Runtime, si spark.sql.ansi.enabled est false, la fonction retourne NULL au lieu d’une erreur de timestamps malformés.

Conditions d’erreur courantes

Exemples

> SELECT unix_timestamp();
 1476884637
> SELECT unix_timestamp('2016-04-08', 'yyyy-MM-dd');
 1460041200

> SELECT unix_timestamp('not-a-timestamp', 'yyyy-MM-dd');
  Error: CANNOT_PARSE_TIMESTAMP