DATEFORMAT EB-Funktion

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

Syntax 1

DATEFORMAT (date, format)

Syntax 2

DATEFORMAT (date, format, culture)

Argumente

date: Date

Ein Datums-/Zeitwert, der das zu formatierende Datum darstellt.

format: Zeichenfolge

Das Format der Ausgabezeichenfolge. Informationen zu unterstützten Formaten finden Sie unter Standard und Benutzerdefiniert.

Notiz

Bei der Formatzeichenfolge wird zwischen Groß- und Kleinschreibung unterschieden, wenn Sie entweder ein Standardformat oder ein benutzerdefiniertes Format verwenden. Der standardmäßige Formatbezeichner „d“ gibt das Datum unter Verwendung des kurzen Datumsmusters zurück, während der Standardformatbezeichner „D“ das Datum unter Verwendung des langen Datumsmusters zurückgibt. Darüber hinaus gibt der benutzerdefinierte Formatbezeichner „M“ den Monat von 1 bis 12 zurück, während der benutzerdefinierte Formatbezeichner „m“ die Minute von 0 bis 59 zurückgibt.

culture: Zeichenfolge

Die zum Formatieren zu verwendende Kultur. Weitere Informationen zu unterstützten Kulturen finden Sie unter Kultur.

Rückgabewerte

Zeichenfolge

Der resultierende Zeichenfolgenwert.

Anwendungshinweise

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

DATEFORMAT (TODAY (), "dd-MM-yyyy") gibt den Wert für das aktuelle Datum des Anwendungsservers, 24. Dezember 2015, basierend auf dem angegebenen benutzerdefinierten Format als Zeichenfolge „24-12-2015“ zurück.

Beispiel 2

DATEFORMAT (SESSIONTODAY (), "d", "DE") gibt das aktuelle Datum der Anwendungssitzung, den 24. Dezember 2015, als Zeichenfolge „24-12-2015“ basierend auf den ausgewählten kulturspezifischen Kriterien für Deutschland und dem angegebenen Format zurück.

Zusätzliche Ressourcen

Datums- und Zeitfunktionen