DateValue, fonction (Visual Basic)
Mise à jour : novembre 2007
Retourne une valeur Date contenant l'indication de date représentée par une chaîne, l'indication d'heure ayant la valeur minuit (00:00:00).
Public Function DateValue(ByVal StringDate As String) As DateTime
Paramètres
- StringDate
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 |
|---|---|---|
StringDate comprend une indication d'heure non valide. |
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
Si StringDate comprend uniquement des nombres de 1 à 12 séparés par des séparateurs de date valides, DateValue reconnaît l'ordre du mois, du jour et de l'année d'après le format Date courte spécifié pour votre système. DateValue utilise le paramètre de calendrier actuel de la propriété CurrentCulture de la classe CultureInfo dans l'espace de noms System.Globalization. Les valeurs par défaut de CurrentCulture dépendent des paramètres du Panneau de configuration. Vous pouvez substituer le format Date courte en définissant la propriété ShortDatePattern de la classe DateTimeFormatInfo dans l'espace de noms System.Globalization.
DateValue reconnaît les noms de mois sous leur forme longue, abrégée et numérique. Par exemple, DateValue reconnaît non seulement 30/12/1991 et 30/12/91, mais aussi 30 décembre 1991 et 30-déc-1991.
Si la partie année de l'argument StringDate est omise, DateValue prend comme valeur l'année en cours fournie par la date.
Si l'argument StringDate comprend une indication d'heure, DateValue ne l'inclut pas dans la valeur retournée. Si, toutefois, l'heure indiquée dans StringDate n'est pas valide (par exemple "89:98"), une erreur InvalidCastException se produit.
Exemple
Cet exemple utilise la fonction DateValue pour convertir une chaîne en date. Vous pouvez également utiliser des littéraux de date pour assigner directement une date à une variable Object ou Date, par exemple, oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
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)
Month, fonction (Visual Basic)
TimeSerial, fonction (Visual Basic)
TimeValue, fonction (Visual Basic)
Weekday, fonction (Visual Basic)