DateAndTime.DateValue(String) Méthode

Définition

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.

S’applique à

Voir aussi