Freigeben über

DATETIMEVALUE EB-Funktion

  • Artikel

Die Funktion DATETIMEVALUE gibt den Wert DateTime zurück, der über einen vorgegebenen Textwert im speziellen Format und in einer optional angegebenen Kultur in einen Wert „Datum/Uhrzeit“ konvertiert wird. Informationen zu unterstützten Formaten finden Sie unter Standard und Benutzerdefiniert.

Syntax 1

DATETIMEVALUE (text, format)

Syntax 2

DATETIMEVALUE (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

DateTime

Der resultierende Wert für Datum/Uhrzeit.

Anwendungshinweise

Wenn die Kultur nicht als Argument der aufgerufenen Funktion definiert ist, wird der Wert culture durch den aufrufenden Kontext definiert. Wenn die Funktion DATETIMEVALUE 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

DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") gibt 2:55:00 h a, 21. Dezember 2016 basierend auf dem angegebenen benutzerdefinierten Format und der Standardkultur EN-US der Anwendung zurück.

Beispiel 2

DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") gibt 02.55.00 h am 21. Dezember 2016 basierend auf dem angegebenen benutzerdefinierten Format und der Kultur zurück.

Allerdings löst DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "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