Renvoie une donnée de type Variante (Date) contenant l’heure complète (heure, minutes, secondes).
Syntaxe
TimeSerial(heure, minute, seconde)
Avertissement Assurez-vous que les arguments sont dans la plage de valeurs correcte. Un argument non valide peut entraîner un résultat incorrect.
La syntaxe de la fonction TimeSerial contient les arguments suivants :
| Argument | Description |
|---|---|
| heure | Obligatoire. Variante (entier). Nombre compris entre 0 (12:00 A.M.) et 23 (11:00 P.M.) inclus ou expression numérique. |
| minute | Obligatoire. Variante (entier). Toute expression numérique. |
| deuxième | Obligatoire. Variante (entier). Toute expression numérique. |
Remarques
Pour spécifier une heure, telle que 11:59:59, la plage de nombres de chaque argument TimeSerial doit être dans la plage normale de l’unité ; c’est-à-dire 0 à 23 pour les heures et 0 à 59 pour les minutes et les secondes. Cependant, vous pouvez également spécifier des heures relatives pour chaque argument à l’aide d’une expression numérique qui représente un certain nombre d’heures, de minutes ou de secondes avant ou après une certaine heure. L’exemple suivant utilise des expressions au lieu de nombres temporels absolus. La fonction TimeSerial renvoie une heure de 15 minutes avant (-15) six heures avant midi (12 - 6) ou 5:45:00 A.M.
TimeSerial(12 - 6, -15, 0)
Lorsqu’un argument dépasse la plage normale de cet argument, il incrémente jusqu’à l’unité plus grande suivante selon les besoins. Par exemple, si vous spécifiez 75 minutes, il est évalué à une heure et 15 minutes. Si un seul argument est en dehors de la plage comprise entre 32 768 et 32 767, une erreur se produit. Si l’heure spécifiée par les trois arguments fait que la date se situe en dehors de la plage de dates acceptable, une erreur se produit.
Exemple de requête
| Expression | Résultats |
|---|---|
| SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10) ; | Renvoie le « Temps » composé de l’heure, de la minute et de la seconde spécifiées entrées dans les arguments de la fonction et affiche dans la colonne NewTime. Résultat : « 18:12:10 ». |
Exemple de VBA
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction TimeSerial pour renvoyer une heure pour l’heure, la minute et la seconde spécifiées.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.