DateAndTime.DateValue(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> DateTimePublic Function DateValue (StringDate As String) As DateTimeParameter
- 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 .
