Partager via


DateAndTime.DateValue(String) Méthode

Définition

Retourne une Date valeur contenant les informations de date représentées par une chaîne, avec les informations d’heure définies sur 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’année 1 à 23:59:59 le 31 décembre 9999.

Retours

Valeur Date contenant les informations de date représentées par une chaîne, avec les informations d’heure définies sur minuit (00:00:00).

Exceptions

StringDate inclut des informations de temps non valides.

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 ou Date une variable, par exemple oldDate = #2/12/69#.

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

Remarques

Si StringDate elle 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 à partir de la CurrentCulture propriété de la CultureInfo classe dans l’espace System.Globalization de noms. Les valeurs par défaut CurrentCulture sont déterminées par les paramètres du Panneau de configuration . Vous pouvez remplacer le format Date courte en définissant la ShortDatePattern propriété de la DateTimeFormatInfo classe dans l’espace System.Globalization de 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 12/30/1991 et le 12/30/91, DateValue reconnaît également le 30 décembre 1991 et le 30 décembre 1991.

Si la partie année de StringDate l’année est omise, DateValue utilise l’année en cours à partir de la date du système de votre ordinateur.

Si l’argument StringDate inclut des informations de temps, DateValue ne l’inclut pas dans la valeur retournée. Toutefois, si StringDate elle inclut des informations temporelles non valides, telles que « 89:98 », une InvalidCastException erreur se produit.

S’applique à

Voir aussi