DateAndTime.DateValue(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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:
static DateTime DateValue(System::String ^ StringDate);
public static DateTime DateValue (string StringDate);
static member DateValue : string -> DateTime
Public Function DateValue (StringDate As String) As DateTime
Paramètres
- StringDate
- String
Obligatoire. Expression de chaîne représentant une valeur de date/heure comprise entre 00:00:00 le 1er janvier de l’an 1 et 23:59:59 le 31 décembre 9999.
Retours
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).
Exceptions
StringDate
comprend une indication d'heure non valide.
Exemples
Cet exemple utilise la DateValue
fonction pour convertir une chaîne en date. Vous pouvez également utiliser des littéraux de date pour affecter directement une date à une Object
variable ou Date
, par exemple, oldDate = #2/12/69#
.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Remarques
Si StringDate
inclut uniquement des nombres compris entre 1 et 12 séparés par des séparateurs de date valides, DateValue
reconnaît l’ordre pour le mois, le jour et l’année en fonction du format Date courte spécifié pour votre système. DateValue
utilise le paramètre de calendrier actuel de la CurrentCulture propriété de la CultureInfo classe dans l’espace de System.Globalization noms. Les valeurs par défaut CurrentCulture sont déterminées par Panneau de configuration paramètres. Vous pouvez remplacer le format Date courte en définissant la ShortDatePattern propriété de la DateTimeFormatInfo classe dans l’espace de System.Globalization noms.
DateValue
reconnaît les noms de mois sous forme longue, abrégée et numérique. Par exemple, en plus de reconnaître le 30/12/1991 et le 30/12/91, DateValue
il reconnaît également le 30 décembre 1991 et le 30 décembre 1991.
Si la partie année de StringDate
est omise, DateValue
utilise l’année en cours à partir de la date système de votre ordinateur.
Si l’argument StringDate
inclut des informations d’heure, DateValue
ne les inclut pas dans la valeur retournée. Toutefois, si StringDate
inclut des informations de temps non valides, telles que « 89 :98 », une InvalidCastException erreur se produit.