autoformat()

Prev Next

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).

Parameter

Parameter

Beschreibung

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.

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)