Get Formatted Value
Zuletzt geändert: 14.03.2026 05:56

Get-FormattedValue #

ÜBERSICHT #

Formatiert einen Eingabewert abhängig vom angegebenen Datentyp für strukturierte XML-/EDI-Ausgaben.

SYNTAX #

Get-FormattedValue [[-Field] <object>] [[-DataType] <string>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion bereinigt den Eingabewert von unsichtbaren Steuerzeichen und formatiert ihn je nach Typ:

  • DateTime: Wird in ISO 8601 yyyy-MM-ddTHH:mm:ss ausgegeben.
  • Decimal, Float, Decimal4, Decimal6: Umwandlung in Punktnotation mit fester Nachkommastellenanzahl.
  • Integer: Konvertiert den Eingabewert in eine ganze Zahl ohne Dezimalstellen. Gleitkommazahlen werden abgeschnitten.
  • StringGtin: Validierung auf korrekte GTIN-Länge (8, 13, 14 oder GS1 (01)…), ungültige Werte werden unterdrückt.
  • Sonstige: Als bereinigter String zurückgegeben.

Ungültige Werte, z. B. ein falsches Datum, fehlerhafte GTIN oder nicht-konvertierbare Zahlen, werden ignoriert oder übergeben, wie sie erhalten wurden.

PARAMETER #

-Field #

Type: object

Der Eingabewert, der bereinigt und formatiert werden soll.

-DataType #

Type: string
Default: "String"

Zieltyp: DateTime, Decimal, Float, Decimal4, Decimal6, Integer, StringGtin oder beliebiger Standard-String.

AUSGABEN #

string

Gibt den formatierten Wert als String zurück. Bei ungültigen Eingaben ggf. $null.

BEISPIELE #

# Ergibt: "12.5000"
Get-FormattedValue -Field "12.50" -DataType "decimal4"

# Ergibt: '"2024-12-31T00:00:00"'
Get-FormattedValue -Field "2024-12-31" -DataType "DateTime"

HINWEISE #

  • Die Funktion wird typischerweise bei der Ausgabe in standardisierte Formate wie XRechnung, UBL, oder EDIFACT verwendet.
  • Bei stringGtin erfolgt eine strenge Prüfung auf gültige GTIN-Struktur.