DateValue-FunktionDateValue function

Gibt einen Variant (Date) zurück.Returns a Variant (Date).

SyntaxSyntax

DateValue(date)DateValue(date)

Das erforderliche date-Argument ist in der Regel ein Zeichenfolgenausdruck, der ein Datum zwischen dem 1. Januar 100 und dem 31. Dezember 9999 darstellt.The required date argument is normally a string expression representing a date from January 1, 100, through December 31, 9999. date kann jedoch auch ein Ausdruck sein, der ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit in diesem Bereich darstellen kann.However, date can also be any expression that can represent a date, a time, or both a date and time, in that range.

HinweiseRemarks

Wenn date eine Zeichenfolge ist, die nur Zahlen enthält, die durch gültige Datumstrennzeichen getrennt sind, erkennt DateValue die Reihenfolge für Monat, Tag und Jahr entsprechend dem kurzen Datumsformat, das Sie für Ihr System angegeben haben.If date is a string that includes only numbers separated by valid date separators, DateValue recognizes the order for month, day, and year according to the Short Date format that you specified for your system. DateValue erkennt auch eindeutige Datumsangaben, die Monatsnamen, entweder in langer oder abgekürzter Form, enthalten.DateValue also recognizes unambiguous dates that contain month names, either in long or abbreviated form. DateValue erkennt zum Beispiel nicht nur 30/12/1991 und 30/12/91, sondern auch 30. Dezember 1991 und 30. Dez. 1991.For example, in addition to recognizing 12/30/1991 and 12/30/91, DateValue also recognizes December 30, 1991 and Dec 30, 1991.

Wenn das Jahr im date-Argument ausgelassen wird, verwendet das DateValue-Element das aktuelle Jahr entsprechend dem Systemdatum des Computers an.If the year part of date is omitted, DateValue uses the current year from your computer's system date.

Wenn das date-Argument eine Zeitangabe enthält, gibt DateValue diese nicht zurück.If the date argument includes time information, DateValue doesn't return it. Wenn date aber eine ungültige Zeitangabe (z. B. 89:98) enthält, tritt ein Fehler auf.However, if date includes invalid time information (such as "89:98"), an error occurs.

Hinweis

Das für date angegebene Datum muss ein gregorianisches Datum sein, wenn die Einstellung der Calendar-Eigenschaft dem gregorianischen Kalender entspricht.For date, if the Calendar property setting is Gregorian, the supplied date must be Gregorian. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein.If the calendar is Hijri, the supplied date must be Hijri. Wenn das angegebene Datum ein Hijri-Datum ist, ist das Argument date eine Zeichenfolge, die ein Datum vom 1.1.100 (2. Aug 718 im gregorianischen Format) und 3.4.9666 (31. Dezember 9999 im gregorianischen Format) darstellt.If the supplied date is Hijri, the argument date is a String representing a date from 1/1/100 (Gregorian Aug 2, 718) through 4/3/9666 (Gregorian Dec 31, 9999).

BeispielExample

Dieses Beispiel verwendet die DateValue-Funktion, um eine Zeichenfolge in ein Datum zu konvertieren.This example uses the DateValue function to convert a string to a date. Sie können auch Datumsliterale verwenden, um einer Variant- oder Date-Variable direkt ein Datum zuzuweisen, z. B. MyDate = #2/12/69#.You can also use date literals to directly assign a date to a Variant or Date variable, for example, MyDate = #2/12/69#.

Dim MyDate
MyDate = DateValue("February 12, 1969")    ' Return a date.


Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.