Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Fonction
S’applique à :
Databricks SQL
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: UneINTEGERexpression évaluant une valeur de 1 à 9999. -
month: UneINTEGERexpression évaluant une valeur de 1 (janvier) à 12 (décembre). -
day: UneINTEGERexpression évaluant une valeur de 1 à 31. -
hour: UneINTEGERexpression évaluant une valeur comprise entre 0 et 23. -
min: UneINTEGERexpression é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ésignantDATEles champs de l’année, du mois et du jour. -
time: Une expression optionnelleTIMEfournissant les champs heure, minute et seconde. La valeur par défaut est00:00:00omise. -
timezone: Une expression optionnelleSTRINGévaluant à un fuseau horaire valide, tel queCETouUTC.
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