Freigeben über


DateAndTime.DateValue(String) Methode

Definition

Gibt einen Date-Wert zurück, der die Datumsangabe als Zeichenfolge enthält und dessen Zeitangabe Mitternacht (00:00:00) lautet.

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

Parameter

StringDate
String

Erforderlich. Zeichenfolgenausdruck, der ein Datum und eine Uhrzeit zwischen 00:00:00 Uhr am 1. Januar des Jahres 1 und 23:59:59 Uhr am 31. Dezember 9999 darstellt.

Gibt zurück

Ein Date-Wert, der die Datumsangabe als Zeichenfolge enthält und dessen Zeitangabe Mitternacht (00:00:00) lautet.

Ausnahmen

StringDate enthält eine ungültige Zeitangabe.

Beispiele

In diesem Beispiel wird die DateValue -Funktion verwendet, um eine Zeichenfolge in ein Datum zu konvertieren. Sie können auch Datumsliterale verwenden, um einem oder Date einer Object Variablen direkt ein Datum zuzuweisen, z. BoldDate = #2/12/69#. .

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

Hinweise

Wenn StringDate nur Zahlen von 1 bis 12 durch gültige Datumstrennzeichen getrennt sind, DateValue erkennt die Reihenfolge für Monat, Tag und Jahr gemäß dem für Ihr System angegebenen Format für kurzes Datum. DateValue verwendet die aktuelle Kalendereinstellung aus der CurrentCulture -Eigenschaft der CultureInfo -Klasse im System.Globalization Namespace. Die Standardwerte CurrentCulture werden durch Systemsteuerung Einstellungen bestimmt. Sie können das Short Date-Format überschreiben, indem Sie die ShortDatePattern -Eigenschaft der DateTimeFormatInfo -Klasse im System.Globalization Namespace festlegen.

DateValue erkennt Monatsnamen in langer, abgekürzter und numerischer Form. Neben dem 30.12.1991 und dem 30.12.91 DateValue erkennt beispielsweise auch den 30. Dezember 1991 und den 30. Dezember 1991 an.

Wenn der Jahresteil von StringDate ausgelassen wird, DateValue wird das aktuelle Jahr aus dem Systemdatum Ihres Computers verwendet.

Wenn das StringDate Argument Zeitinformationen enthält, DateValue schließt es nicht in den zurückgegebenen Wert ein. Wenn StringDate jedoch ungültige Zeitinformationen wie "89:98" enthalten sind, tritt ein Fehler auf InvalidCastException .

Gilt für:

Weitere Informationen