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.