Op deze pagina
> bronnen > documentatie > expressies > Opmaakfuncties

Opmaakfuncties

Functies voor het opmaken van waarden voor weergave. Deze functies zijn vooral beschikbaar in dashboardexpressies.

info

Opmaakfuncties zijn beschikbaar in frontendexpressies (dashboards, weergaven), maar niet in berekende attributen aan de serverkant.

Veelgebruikte patronen

  • Datums weergeven:

    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

  • Doorlooptijd opmaken:

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

  • Percentages weergeven:

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

Patronen voor datumopmaak

Gebruikt date-fns-opmaakpatronen. Veelgebruikte opmaaktokens voor formatDate:

  • Jaar:

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

  • Maand:

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

  • Dag:

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

  • Tijd:

    HH     Hour (24h)        14
hh     Hour (12h)        02
mm     Minutes           30
ss     Seconds           45
a      AM/PM             PM

Eenheden voor doorlooptijd

Alleen beschikbaar in frontendexpressies. Gebruikt korte eenheidslabels:

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

formatDate

(timestamp, format)

Maakt een timestamp op met een datumformaatpatroon.

Parameters
timestamp number De timestamp die je wilt opmaken
format string Het formaatpatroon, bijvoorbeeld 'yyyy-MM-dd' of 'HH:mm'
Retourneert string
Voorbeelden
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Notities

De ondersteunde tokens zijn voor de frontend en Athena op dezelfde manier afgeleid: yyyy, MM, dd, HH, mm en ss. Ook M, d, H, m, s en MMM, MMMM, EEE en EEEE worden ondersteund voor opmaak. De opmaak gebruikt UTC-semantiek.

formatDuration

(duration, unit?)

Maakt een duur in milliseconden op als een leesbare tekst.

Parameters
duration number Doorlooptijd in milliseconden
unit (optioneel) string Weergave-eenheid: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Retourneert string
Voorbeelden
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Notities

Alleen beschikbaar in frontendexpressies. Gebruikt korte eenheidslabels (s, m, h, d, mo, y).

formatPercentage

(value)

Maakt een decimale waarde op als percentage.

Parameters
value number De decimale waarde (0,5 = 50%)
Retourneert string
Voorbeelden
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Notities

Alleen beschikbaar in frontendexpressies.

formatNumber

(value, decimals?)

Maakt een getal op met optioneel aantal decimalen. Alleen beschikbaar in de frontend.

Parameters
value number Het getal dat je wilt opmaken
decimals (optioneel) number Aantal decimalen
Retourneert string
Voorbeelden
formatNumber(1234.5, 2) → 1,234.50
Notities

Alleen beschikbaar in frontendexpressies.

formatCurrency

(value, currency, decimals?)

Maakt een getal op als valuta. Alleen beschikbaar in de frontend.

Parameters
value number Het getal dat je wilt opmaken
currency string ISO 4217-valutacode, bijvoorbeeld EUR of USD
decimals (optioneel) number Aantal decimalen
Retourneert string
Voorbeelden
formatCurrency(99.9, "EUR") → €99.90
Notities

Alleen beschikbaar in frontendexpressies.

Gerelateerde onderwerpen