Description
TimeSerial renvoie l'heure correspondant aux valeurs chronologiques spécifiées en arguments (heure, minutes, secondes).
Arguments
"heure" est un nombre ou une expression numérique indiquant la valeur d'heure à traiter.
"minute" est un nombre ou une expression numérique indiquant la valeur de minutes à traiter.
"seconde" est un nombre ou une expression numérique indiquant la valeur de secondes à traiter.
Action
TimeSerial renvoie l'heure correspondant aux valeurs chronologiques spécifiées en arguments (heure, minutes, secondes).
Exemple d'utilisation
La fonction TimeSerial peut être utilisée au lieu de
CTime ou de
TimeValue pour générer une valeur d'heure à partir de valeurs chronologiques d'heure, de minutes et de secondes.
L'une des caractéristiques originales de TimeSerial est qu'il n'est pas nécessaire que les arguments "heure", "minute" et "seconde" se situent dans les plages standard. Cela signifie qu'il n'est pas nécessaire que les heures soient comprises entre 0 et 24 et que les minutes et les secondes soient comprises entre 0 et 59. De telles heures sont interprétées en tant qu'heures relatives et TimeSerial produit une valeur d'heure correcte. Cette souplesse permet d'effectuer de nombreux calculs de valeurs chronologiques.
Exemples
TimeSerial (18, 45, 0)
TimeSerial (22 - 3, 15 - 30, 0)
Ces deux fonctions renvoient la même heure, soit 18:45. Dans le deuxième cas, la fonction interprète 3 heures et 30 minutes avant (signe moins) 22:15 comme étant 18:45.
TimeSerial (10 + 20, 30 + 55, 0)
Renvoie 07:25:00. Ici, les valeurs 20 heures et 55 minutes après (signe plus) 10:30:00 sont interprétées comme étant 7:25:00 (le jour suivant).