TimeValue

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une chaîne de caractères en une heure.

Remarques

• La fonction TimeValue permet de convertir une chaîne de caractères représentant une heure au format texte en un objet heure que VBScript peut traiter. Cela est particulièrement utile pour travailler avec des données horaires sous forme de texte dans des applications de gestion de temps ou de planification.
• Le paramètre string passé à la fonction doit contenir une représentation valide de l'heure, généralement dans un format tel que "hh:mm:ss" ou "hh:mm AM/PM". Par exemple, TimeValue("14:30:00") renverra un objet représentant 14h30.
• Si la chaîne de caractères fournie à TimeValue est mal formée ou ne correspond pas à un format horaire valide, la fonction renverra une erreur d'exécution. Il est donc essentiel de s'assurer que la chaîne est correctement formatée avant de l'utiliser.
• La fonction TimeValue ignore les parties non liées à l'heure dans la chaîne, comme la date ou d'autres caractères. Par exemple, si la chaîne est "12:30 PM, 01/01/2025", seule la partie "12:30 PM" sera prise en compte pour la conversion.
• Un des avantages de TimeValue est sa capacité à manipuler les formats horaires avec ou sans indication AM/PM. Si la chaîne "2:30" est fournie, la fonction l'interprétera comme 2h30 AM par défaut. Il est donc important de gérer correctement les formats horaires 12 heures et 24 heures.
• TimeValue est particulièrement utile lorsque vous devez traiter des chaînes provenant de sources externes (comme des fichiers ou des formulaires web) et les convertir en une valeur horaire exploitable. Cela permet une gestion uniforme des heures, quel que soit le format d'entrée.
• Lorsqu'un format horaire est fourni sans secondes (par exemple "10:30"), TimeValue considérera que les secondes sont égales à zéro, renvoyant 10:30:00. Cela simplifie les manipulations des heures lorsqu'une précision sur les secondes n'est pas nécessaire.
• Bien que TimeValue soit un outil puissant pour convertir des chaînes en heures, il est important de noter que la fonction ne gère pas les zones horaires. Elle renverra toujours l'heure en fonction de l'heure locale de l'ordinateur sur lequel le script est exécuté, ce qui peut être une considération importante pour des applications internationales.