DATEVALUE EB-Funktion

Die Funktion DATEVALUE gibt den Wert Date zurück, der über einen vorgegebenen Textwert im speziellen Format und in einer optional angegebenen Kultur in einen Datumswert konvertiert wird. Informationen zu unterstützten Formaten finden Sie unter Standard und Benutzerdefiniert.

Syntax 1

DATEVALUE (text, format)

Syntax 2

DATEVALUE (text, format, culture)

Argumente

text: Zeichenfolge

Der Text, der den zu formatierenden Wert darstellt.

format: Zeichenfolge

Das Format des angegebenen Textes. Informationen zu unterstützten Formaten finden Sie unter Standard und Benutzerdefiniert.

culture: Zeichenfolge

Die Kultur, die zum Formatieren des angegebenen Texts verwendet wird. Weitere Informationen zu unterstützten Kulturen finden Sie unter Kultur.

Rückgabewerte

Datum

Der resultierende Datenwert.

Anwendungshinweise

Wenn die Kultur nicht als Argument der aufgerufenen Funktion definiert ist, wird der Wert culture durch den aufrufenden Kontext definiert. Wenn die Funktion DATEVALUE beispielsweise mit der Syntax 1 in einem EB-Format (elektronische Berichterstellung) für das Element DATEI abgerufen wird, das für die Verwendung der kulturspezifischen Kriterien für Deutschland konfiguriert ist, wird die Konvertierung unter Verwendung der kulturspezifischen Kriterien für Deutschland durchgeführt. Der Standardwert culture lautet EN-US.

Beispiel 1

DATEVALUE ("21-Dec-2016", "dd-MMM-yyyy") gibt den Datumswert Dezember 21, 2016 basierend auf dem angegebenen benutzerdefinierten Format und der Standardkultur EN-US der Anwendung zurück.

Beispiel 2

DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "IT") gibt den Datumswert 21. Januar 2016 basierend auf dem angegebenen benutzerdefinierten Format und der Kultur zurück.

Allerdings löst DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "EN-US") eine Ausnahme aus, um den Benutzer zu informieren, dass die angegebene Zeichenfolge nicht als gültiger Wert für Datum/Uhrzeit für die angegebene Kultur anerkannt wird.

Zusätzliche Ressourcen

Datums- und Zeitfunktionen