Fonction make_timestamp

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

Crée un timestamp à partir des champs year, month, day, hour, min, sec et timezone.

Syntaxe

make_timestamp(year, month, day, hour, min, sec [, timezone] )

make_timestamp(date [, time [, timezone]] )

Important

L’argument time utilise le TIME type de donnée, qui est en version Bêta.

Arguments

  • year: Une INTEGER expression évaluant une valeur de 1 à 9999.
  • month: Une INTEGER expression évaluant une valeur de 1 (janvier) à 12 (décembre).
  • day: Une INTEGER expression évaluant une valeur de 1 à 31.
  • hour: Une INTEGER expression évaluant une valeur comprise entre 0 et 23.
  • min: Une INTEGER expression évaluant à une valeur comprise entre 0 et 59.
  • sec : expression numérique qui prend une valeur comprise entre 0 et 60.
  • date: Une expression désignant DATE les champs de l’année, du mois et du jour.
  • time: Une expression optionnelle TIME fournissant les champs heure, minute et seconde. La valeur par défaut est 00:00:00 omise.
  • timezone: Une expression optionnelle STRING évaluant à un fuseau horaire valide, tel que CET ou UTC.

Retours

Un TIMESTAMP.

Si un argument est hors limites, la fonction augmente DATETIME_FIELD_OUT_OF_BOUNDS. Utilisez try_make_timestamp pour revenir NULL à la place.

Si sec est 60, la fonction l’interprète comme 0 et ajoute une minute au résultat.

Si sec a une valeur fractionnaire qui ne peut pas être représentée en microseconde précision, Azure Databricks déclenche INVALID_FRACTION_OF_SECOND.

Conditions d’erreur courantes

Exemples

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887');
 2014-12-28 06:30:45.887

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887', 'CET');
 2014-12-27 21:30:45.887

> SELECT make_timestamp(DATE'2014-12-28');
 2014-12-28 00:00:00

> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS