Applies ToAccess pour Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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 (12h00) et 23 (23h00), inclus, ou un expression numérique.

minute

Obligatoire. Variant (Entier). Toute expression numérique.

seconde

Obligatoire. Variant (Entier). Toute expression numérique.

Notes

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 un certain temps. 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 MyTimeMyTime = TimeSerial(16, 35, 17)    ' MyTime contains serial representation of 4:35:17 PM.

Choisir la fonction de date correcte

Besoin d’aide ?

Vous voulez plus d’options ?

Explorez les avantages de l’abonnement, parcourez les cours de formation, découvrez comment sécuriser votre appareil, etc.

Les communautés vous permettent de poser des questions et d'y répondre, de donner vos commentaires et de bénéficier de l'avis d'experts aux connaissances approfondies.