Renvoie une donnée de type Variante (Date) contenant l’heure complète (heure, minutes, secondes).
Syntaxe
TimeSerial(hour, minute, second)
Avertissement Vérifiez que les arguments se trouvent 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. Variant (Entier). Nombre compris entre 0 (12:00 A.M.) et 23 (11:00 P.M.) inclus ou expression numérique. |
| Minute | Obligatoire. Variant (Entier). Toute expression numérique. |
| Deuxième | Obligatoire. Variant (Entier). Toute expression numérique. |
Remarques
Pour spécifier une heure, telle que 11:59:59, la plage de nombres pour chaque argument TimeSerial doit se trouver dans la plage normale de l’unité ; c’est-à-dire 0 à 23 pour les heures et 0 à 59 pour les minutes et les secondes. Toutefois, 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 de temps absolus. La fonction TimeSerial retourne 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 est incrémenté à l’unité supérieure suivante, comme il convient. Par exemple, si vous spécifiez 75 minutes, elle est évaluée comme une heure et 15 minutes. Si un seul argument se trouve en dehors de la plage -32 768 à 32 767, une erreur se produit. Si l’heure spécifiée par les trois arguments fait que la date dépasse 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) ; | Retourne le « Time » 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 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 du développeur dans la liste déroulante en regard de Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction TimeSerial pour retourner 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.