Share via

Fonction TimeSerial

  • Article

Retourne une valeur de type Variant (Date) contenant une heure précise (heure, minute et seconde).

Syntaxe

TimeSerial(hour, minute, second)

La syntaxe de la fonction TimeSerial comprend les arguments nommés suivants :

Élément Description
Heure Obligatoire; Variant (Entier). Nombre compris entre 0 (12:00 A.M.) et 23 (23:00 P.M.), inclus, ou expression numérique.
Minute Obligatoire; Variant (Entier). Expression numérique.
Deuxième Obligatoire; Variant (Entier). Toute expression numérique.

Remarques

Pour exprimer une heure déterminée, par exemple 11:59:59, vous devez utiliser la plage de valeurs normalement autorisées pour chaque argument de la fonction TimeSerial ; c’est-à-dire, entre 0 et 23 pour les heures et entre 0 et 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 valeurs horaires absolues. 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 est hors de la plage comprise entre -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

Cet exemple utilise la fonction TimeSerial pour retourner une heure pour l’heure, la minute et la seconde indiquées.

Dim MyTime
MyTime = TimeSerial(16, 35, 17)    ' MyTime contains serial 
    ' representation of 4:35:17 PM.

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.