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 Datumsinformationen enthält, die durch eine Zeichenfolge dargestellt werden, wobei die Uhrzeitinformationen auf Mitternacht festgelegt sind (00:00:00).
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 einen Datums-/Uhrzeitwert von 00:00:00 am 1. Januar bis 23:59:59 Uhr am 31. Dezember 9999 darstellt.
Gibt zurück
Ein Date Wert, der die Datumsinformationen enthält, die durch eine Zeichenfolge dargestellt werden, wobei die Uhrzeitinformationen auf Mitternacht festgelegt sind (00:00:00).
Ausnahmen
StringDate enthält ungültige Zeitinformationen.
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 Datum oder Date einer Object Variablen direkt ein Datum zuzuweisen, oldDate = #2/12/69#z. B. .
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 wird die Reihenfolge für Monat, Tag und Jahr entsprechend dem für Ihr System angegebenen Format "Kurzes Datum" erkannt.
DateValue verwendet die aktuelle Kalendereinstellung aus der CurrentCulture Eigenschaft der CultureInfo Klasse im System.Globalization Namespace. Die Standardwerte CurrentCulture werden durch die Systemsteuerungseinstellungen bestimmt. Sie können das Format "Kurzes Datum" ü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 der Anerkennung von 12.30.1991 und 12.30.91 DateValue wird beispielsweise auch der 30. Dezember 1991 und der 30. Dezember 1991 erkannt.
Wenn der Jahresteil 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 InvalidCastException Fehler auf.
