DATETIMEFORMAT EB-Funktion
Die Funktion DATETIMEFORMAT gibt den Wert String zurück, der über einen vorgegebenen Zeitwert 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
DATETIMEFORMAT (datetime, format)
Syntax 2
DATETIMEFORMAT (datetime, format, culture)
Argumente
datetime: DateTime
Ein Datums-/Zeitwert, der das zu formatierende Datum und die Uhrzeit 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 DATETIMEFORMAT 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.
Wenn die Funktion DATETIMEFORMAT einen bestimmten Datums-/Zeitwert konvertiert, berücksichtigt sie die Zeitzoneneinstellung des Anwendungsbenutzers, der das EB-Format ausführt, in dem die Funktion basierend auf dem Kontext abgerufen wird.
Beispiel 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") gibt den Wert für das aktuelle Datum/die Uhrzeit des Anwendungsservers, 24. Dezember 2015, basierend auf dem angegebenen benutzerdefinierten Format mit "24-12-2015" zurück.
Beispiel 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") gibt das aktuelle Datum/den Zeitwert 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.
Beispiel 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") gibt den Zeichenkettenwert 2019-11-12T08:00:00.0000000-08:00 zurück, wenn die Funktion während eines Prozesses aufgerufen wird, der von einem Anwendungsbenutzer mit dem Zeitzonenwert (GMT-08: 00) Pacific Time (USA & Kanada) im Bereich Sprach- und Länder-/Regionsvoreinstellungen initiiert wird.