autoformat(format a, value b, part c, [time zone d, locale e, exception handling f, force empty g])
|
Group |
Diese Funktion ist veraltet (deprecated).
Liefert das aufgelöste Datum eines EDIFACT-DTM-Segmentes unter Nutzung des Format-Codes a und des kodierten Datumswertes b.
Wird ein unerlaubter Format-Code verwendet oder ein kodierter Datumswert, der nicht zum Format-Code passt, hängt das Fehlerverhalten von Parameter f ab (siehe Beispiele).
Parameterbeschreibung
|
Parameter |
Description |
|
a |
Format-Code. Erlaubte Codes: 2-10, 101-110, 201-205, 301-306, 401-402, 404-406, 501-503, 600-604, 608-610, 613-616, 701-710, 713, 715-720, 801-814. Hinweis: Zu den Codes siehe z. B. https://www.edifactory.de/edifact/directory/D96A/data-element/2379 oder ähnliche Seiten. |
|
b |
Kodierter Datumswert. |
|
c |
(optional) 1, falls der Von-Teil der Dauer verwendet werden soll. 2, falls der Bis-Teil der Dauer verwendet werden soll. Default: 2. Hinweis: Beim Bis-Teil wird automatisch immer 1 Sekunde addiert. |
|
d |
(optional) Zeitzone, in das das Datum vor der Formatierung gewandelt werden soll. Default: Zeitzone des übergebenen Datums. Wichtiger Hinweis: Die abgekürzten Zeitzonennamen sollten vermieden werden, da diese zum Teil mehrfach verwendet wurden und so nicht sicher gesagt werden kann, welche Zeitzone gemeint ist. Java unterstützt diese Namen nur noch aus Kompatibilitätsgründen. Ein Profil kann also, z. B. nach einem Update der Java Virtual Machine oder des Betriebssystems, plötzlich andere Ergebnisse liefern. Besser ist es hier Kontinent und Stadt zu verwenden. Erlaubte Kürzel: GMT, UTC, SYSTEM (lokale Zeitzone des Servers). Beispiele: America/New_York Europe/Berlin |
|
e |
(optional) Locale. Default: System-Locale. Hinweis: Verwenden Sie zur Auswahl eines Wertes die drei Punkte. |
|
f |
(optional) Dieser Parameter steuert das Fehlerverhalten (unerlaubter Format-Code oder kodierter Datumswert, der nicht zum Format-Code passt). Bleibt der Parameter leer oder wird der Wert error verwendet, dann folgt ein Fehlerabbruch mit Exception. Wird der Wert empty verwendet, dann ist der Rückgabewert ein leerer String ("") mit gesetztem Empty Flag. Wird der Wert now verwendet, dann ist der Rückgabewert das aktuelle Datum. Default: <leer>. Hinweis: Verwenden Sie zur Auswahl eines Wertes die drei Punkte. |
|
g |
(optional) Falls true, dann wird immer (unabhängig von den anderen Einstellungen) ein leerer String ("") mit gesetztem Empty Flag zurück gegeben. Default: false. |
Beispiele
|
Parameter a |
b |
c |
d |
e |
f |
g |
Ergebnis |
|
305 |
12240802 |
|
|
|
|
|
2020-12-24 08:02:00.0 |
|
305 |
12240802 |
1 |
|
|
|
|
2020-12-24 08:02:00.0 |
|
305 |
12240802 |
|
Europe/Berlin |
|
|
|
2020-12-24 08:02:00.0 |
|
305 |
12240802 |
|
America/New_York |
|
|
|
2020-12-24 14:02:00.0 |
|
713 |
2009111200-2009131115 |
1 |
|
|
|
|
2020-09-11 12:00:00.0 |
|
713 |
2009111200-2009131115 |
|
|
|
|
|
2020-09-13 11:15:01.0 |
|
713 |
2009111200-2009131115 |
2 |
|
|
|
|
2020-09-13 11:15:01.0 |
|
714 |
2009111200-2009131115 |
|
|
|
|
|
Abbruch mit Fehler (nicht erlaubter Code). |
|
714 |
2009111200-2009131115 |
|
|
|
now |
|
2023-01-30 (aktuelles Datum) |
|
616 |
202101 |
|
|
de_DE |
|
|
2021-01-04 (erste Kalenderwoche 2021) |
|
616 |
202101 |
|
|
en_US |
|
|
2020-12-28 (erste Kalenderwoche 2021) |