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

Formatierungsfunktionen

Funktionen zur Darstellung von Werten. Diese Funktionen sind hauptsächlich in Dashboard-Ausdrücken verfügbar.

info

Formatierungsfunktionen sind in Frontend-Ausdrücken (Dashboards, Anzeigen) verfügbar, nicht jedoch in serverseitig berechneten Attributen.

Häufige Muster

  • Daten 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%"

Muster für Datumsformate

Verwendet date-fns-Formatmuster. Häufige Formatierungstoken für formatDate:

  • Jahr:

    yyyy   4-digit year      2024
yy     2-digit year      24

  • 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
hh     Hour (12h)        02
mm     Minutes           30
ss     Seconds           45
a      AM/PM             PM

Dauereinheiten

Nur in Frontend-Ausdrücken verfügbar. Verwendet kurze Einheitenbezeichnungen:

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

formatDate

(timestamp, format)

Formatiert einen Timestamp anhand eines Datumsformatmusters.

Parameter
timestamp number Der zu formatierende Timestamp
format string Das 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 verwendet UTC-Semantik.

formatDuration

(duration, unit?)

Formatiert eine Dauer in Millisekunden als leicht lesbare Zeichenfolge.

Parameter
duration number Duration 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 Prozentsatz.

Parameter
value number Der 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 optionaler Anzahl an Dezimalstellen. Nur im Frontend verfügbar.

Parameter
value number Die zu formatierende Zahl
decimals (optional) number Anzahl der Dezimalstellen
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 Die zu formatierende Zahl
currency string ISO-4217-Währungscode, zum Beispiel EUR oder USD
decimals (optional) number Anzahl der Dezimalstellen
Rückgabewert Zeichenfolge
Beispiele
formatCurrency(99.9, "EUR") → €99.90
Hinweise

Nur in Frontend-Ausdrücken verfügbar.

Verwandte Themen