Fonction TimeSerial VBScript

Définition et utilisation

La fonction TimeSerial peut combiner l'heure, les minutes et les secondes pour former un temps.

Remarque :Si l'heure, la minute ou la seconde dépasse la plage autorisée, le principe de calcul est le même que celui de DateSerial. Si la valeur calculée est inférieure à #00:00:00#, le temps négatif est automatiquement converti en temps positif; si la valeur calculée est supérieure ou égale à #24:00:00#, le temps est avancé pour que les données deviennent des données contenant une date et une heure, avec pour date de départ #12/30/1899#.

Syntaxe

TimeSerial(hour,minute,second)
Paramètre Description
heure Obligatoire. Un nombre entre 0 et 23, ou une expression numérique.
minute Obligatoire. Un nombre entre 0 et 59, ou une expression numérique.
second Obligatoire. Un nombre entre 0 et 59, ou une expression numérique.

Pour spécifier un moment, comme 11:59:59, la valeur des paramètres de TimeSerial doit être dans la plage acceptable; c'est-à-dire que l'heure doit être comprise entre 0 et 23, et les minutes et les secondes doivent être comprises entre 0 et 59. Cependant, vous pouvez utiliser une expression numérique pour chaque paramètre pour spécifier un temps relatif, cette expression représentant le nombre d'heures, de minutes ou de secondes avant ou après un moment donné.

Lorsque la valeur de l'un des paramètres dépasse la plage d'acceptation, elle est correctement avancée à l'unité de temps supérieure. Par exemple, si 75 minutes sont spécifiées, cette durée est interprétée comme une heure et quinze minutes. Cependant, si l'une des valeurs des paramètres dépasse la plage de -32768 à 32767, cela entraînera une erreur. Si le temps spécifié directement par les trois paramètres ou calculé par l'expression dépasse la plage de dates acceptées, cela entraînera également une erreur.

Exemple

Exemple 1

document.write(TimeSerial(9,30,50)) 'Méthode d'appel normale'

Sortie :

9:30:50 ou 9:30:50 AM

Exemple 2

document.write(TimeSerial(0,9,11)) 'Méthode d'appel normale'

Sortie :

0:09:11 ou 12:09:11 AM

Exemple 3

document.write(TimeSerial(14+2,9-2,1-1)) 'Sortie basée sur le résultat de l'expression numérique'

Sortie :

16:07:00 ou 4:07:00 PM

Exemple 4

document.write(TimeSerial(26,30,0)) 'La date commence à partir du #12/30/1899# et augmente de 1 jour'

Sortie :

1899-12-31 2:30:00 AM