Partager via


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, la fonction déclenche une erreur.

Notes

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

Exemples

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