TimeSerial

Syntaxe

Paramètres

Description

Cette fonction permet de créer une heure à partir de paramètre de temps.

Remarques

• La fonction TimeSerial permet de créer une valeur horaire en combinant trois éléments distincts : l'heure, les minutes et les secondes. Elle est idéale pour la création d'objets Date à partir de valeurs temporelles individuelles.
• Les paramètres hour, minute et second doivent être spécifiés dans un format numérique. Par exemple, TimeSerial(14, 30, 0) renverra 14:30:00, représentant 2h30 de l'après-midi.
• L'utilisation de TimeSerial est très pratique lorsqu'il s'agit de manipuler et de combiner des éléments horaires dans un script, notamment lors de la gestion de temps ou de la génération de données basées sur des heures précises.
• Si les valeurs des paramètres dépassent les limites habituelles pour une heure (par exemple, une valeur d'heure supérieure à 23 ou de minute/secondes supérieures à 59), VBScript ajustera automatiquement la valeur. Par exemple, TimeSerial(25, 60, 60) sera converti en 02:01:00.
• Contrairement à la fonction Now, renvoyant à la fois la date et l'heure, TimeSerial se concentre uniquement sur l'heure précise d'un jour spécifique, sans inclure la date. Cela peut être utile pour des calculs ou des comparaisons horaires indépendants de la date.
• Une particularité de TimeSerial est que l'heure peut être supérieure à 24 ou inférieure à 0. Dans ce cas, VBScript ajustera automatiquement ces valeurs pour qu'elles respectent le format d'heure valide, permettant une grande souplesse dans les calculs temporels.
• Cette fonction est particulièrement utile dans les scénarios de calcul de durée ou de gestion de temps, par exemple dans des scripts de planification ou de calcul de temps de travail. Elle permet de créer des objets de type Time sans avoir à gérer manuellement le formatage de l'heure.
• Enfin, il est important de souligner que TimeSerial renvoie un objet Date en VBScript, qui peut ensuite être utilisé dans d'autres fonctions de manipulation de dates et heures, comme Hour(), Minute() ou Second(), pour extraire des composantes individuelles de l'heure créée.