Auf dieser Seite
> ressourcen > dokumentation > ausdrücke > Formatierungsfunktionen

Formatierungsfunktionen

Funktionen zum Formatieren von Werten für die Anzeige. Diese Funktionen sind hauptsächlich in Dashboard-Ausdrücken verfügbar.

info

formatDuration, formatPercentage, formatNumber und formatCurrency sind nur in Frontend-Ausdrücken verfügbar, etwa in Dashboards und Anzeigen. formatDate ist sowohl in Frontend-Ausdrücken als auch in serverseitig berechneten Attributen verfügbar.

Häufige Muster

  • Datumsangaben anzeigen:

    formatDate(StartTime, "yyyy-MM-dd")         // 2024-03-15
formatDate(StartTime, "MMM d, yyyy")        // Mar 15, 2024
formatDate(StartTime, "HH:mm:ss")           // 14:30:45
formatDate(StartTime, "EEEE, MMMM d")       // Friday, March 15

  • Dauer formatieren:

    formatDuration(3600000)                     // "1 h"
formatDuration(90000, "s")                  // "90 s"
formatDuration(86400000, "d")               // "1 d"

  • Prozentwerte anzeigen:

    formatPercentage(0.75)                      // "75%"
formatPercentage(0.333)                     // "33.3%"

Datumsformatmuster

Verwendet eine Teilmenge der date-fns-Formatmuster. Unterstützte Tokens für formatDate:

  • Jahr:

    yyyy   4-digit year      2024

  • Monat:

    MM     Month (2 digits)  03
MMM    Month (short)     Mar
MMMM   Month (full)      March

  • Tag:

    dd     Day (2 digits)    15
d      Day               15
EEEE   Day name (full)   Friday
EEE    Day name (short)  Fri

  • Uhrzeit:

    HH     Hour (24h)        14
mm     Minutes           30
ss     Seconds           45

Dauereinheiten

Nur in Frontend-Ausdrücken verfügbar. Verwendet Kurzbezeichnungen für Einheiten:

ms     Milliseconds
s      Seconds
m      Minutes
h      Hours
d      Days
mo     Months
y      Years

formatDate

(timestamp, format)

Formatiert einen Timestamp anhand eines Datumsformats.

Parameter
timestamp number Zu formatierender Timestamp
format string Formatmuster, zum Beispiel 'yyyy-MM-dd' oder 'HH:mm'
Rückgabewert Zeichenfolge
Beispiele
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Hinweise

Die unterstützten Tokens werden für Frontend und Athena einheitlich abgeleitet: yyyy, MM, dd, HH, mm, ss. Für die Formatierung werden außerdem M, d, H, m, s sowie MMM, MMMM, EEE und EEEE unterstützt. Die Formatierung folgt der UTC-Semantik.

formatDuration

(duration, unit?)

Formatiert eine Dauer in Millisekunden als lesbaren Text.

Parameter
duration number Zeitspanne in Millisekunden
unit (optional) string Anzeigeeinheit: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Rückgabewert Zeichenfolge
Beispiele
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Hinweise

Nur in Frontend-Ausdrücken verfügbar. Verwendet kurze Einheitenbezeichnungen (s, m, h, d, mo, y).

formatPercentage

(value)

Formatiert einen Dezimalwert als Prozentangabe.

Parameter
value number Dezimalwert (0.5 = 50%)
Rückgabewert Zeichenfolge
Beispiele
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Hinweise

Nur in Frontend-Ausdrücken verfügbar.

formatNumber

(value, decimals?)

Formatiert eine Zahl mit optionalen Nachkommastellen. Nur im Frontend verfügbar.

Parameter
value number Zu formatierende Zahl
decimals (optional) number Anzahl der Nachkommastellen
Rückgabewert Zeichenfolge
Beispiele
formatNumber(1234.5, 2) → 1,234.50
Hinweise

Nur in Frontend-Ausdrücken verfügbar.

formatCurrency

(value, currency, decimals?)

Formatiert eine Zahl als Währungsbetrag. Nur im Frontend verfügbar.

Parameter
value number Zu formatierende Zahl
currency string Währungscode nach ISO 4217, zum Beispiel EUR oder USD
decimals (optional) number Anzahl der Nachkommastellen
Rückgabewert Zeichenfolge
Beispiele
formatCurrency(99.9, "EUR") → €99.90
Hinweise

Nur in Frontend-Ausdrücken verfügbar.

Verwandte Themen

Verbessern Sie Prozesse. Schaffen Sie eine vernetzte Architektur. Behalten Sie die Kontrolle.

Erhalten Sie sofort Zugriff, ohne Kreditkarte und Wartezeit. Bilden Sie die Arbeitsweise Ihrer Organisation in klaren, vernetzten Prozessmodellen ab.

Entwickeln Sie Ihre Prozessarchitektur, definieren Sie Zuständigkeiten und Kontrollen und stimmen Sie Rollen und Verantwortlichkeiten auf allen Ebenen ab.

Starten Sie Ihre kostenlose Testphase und schaffen Sie eine verlässliche Grundlage, um Ihre Prozesse zu steuern und kontinuierlich zu verbessern.

Starten Sie Ihre kostenlose Testphase