TimeValue, fonction (Visual Basic)
Mise à jour : novembre 2007
Retourne une valeur Date contenant l'indication d'heure représentée par une chaîne, l'indication de date ayant la valeur 1er janvier de l'année 1.
Public Function TimeValue(ByVal StringTime As String) As DateTime
Paramètres
- StringTime
Requis. Expression String représentant une valeur de date/d'heure située entre 00:00:00 le 1er janvier de l'année 1 et 23:59:59 le 31 décembre 9999.
Exceptions
Type d'exception |
Numéro de l'erreur |
Condition |
|---|---|---|
StringTime inclut des informations de date non valides. |
Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.
Notes
Vous pouvez entrer des heures valides en utilisant une horloge au format 12 ou 24 heures. Par exemple, "2:24 P.M." et "14:24" sont deux arguments StringTime valides.
Si l'argument StringTime comprend une indication de date, la fonction TimeValue ne l'inclut pas dans la valeur retournée. Toutefois, si StringTime inclut des informations de date non valides, par exemple "32 janvier", une erreur InvalidCastException se produit.
Exemple
L'exemple suivant utilise la fonction TimeValue pour convertir une chaîne en heure. Vous pouvez également utiliser des littéraux de date pour assigner directement une heure à une variable Date.
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
Configuration requise
Espace de noms : Microsoft.VisualBasic
**Module :**DateAndTime
Assembly : bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Voir aussi
Référence
DateSerial, fonction (Visual Basic)
DateValue, fonction (Visual Basic)
Second, fonction (Visual Basic)
TimeSerial, fonction (Visual Basic)