Sur cette page
> ressources > documentation > expressions > Fonctions de mise en forme

Fonctions de mise en forme

Fonctions permettant de mettre en forme les valeurs affichées. Ces fonctions sont principalement disponibles dans les expressions de Dashboard.

info

Les fonctions de mise en forme sont disponibles dans les expressions frontend, pour les Dashboards et les affichages, mais pas dans les attributs calculés côté serveur.

Motifs courants

  • Afficher des dates :

    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

  • Mettre en forme une durée :

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

  • Afficher des pourcentages :

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

Motifs de formatage des dates

Utilise les motifs de formatage date-fns. Voici les jetons de formatage courants pour formatDate :

  • Année :

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

  • Mois :

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

  • Jour :

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

  • Heure :

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

Unités de durée

Disponible uniquement dans les expressions frontend. Utilise des libellés d’unités abrégés :

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

formatDate

(timestamp, format)

Formate un horodatage à l'aide d'un modèle de format de date.

Paramètres
timestamp number Horodatage à formater
format string Le modèle de format, par exemple « yyyy-MM-dd » ou « HH:mm »
Valeur renvoyée string
Exemples
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Remarques

Les tokens pris en charge sont définis de manière cohérente pour le frontend et Athena : yyyy, MM, dd, HH, mm, ss, ainsi que M, d, H, m, s et MMM, MMMM, EEE, EEEE, également pris en charge pour le formatage. Le formatage utilise la sémantique UTC.

formatDuration

(duration, unit?)

Formate une durée exprimée en millisecondes sous la forme d'une chaîne lisible.

Paramètres
duration number Durée en millisecondes
unit (facultatif) string Unité d'affichage : 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Valeur renvoyée string
Exemples
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Remarques

Disponible uniquement dans les expressions du frontend. Utilise des libellés d'unités courts (s, m, h, d, mo, y).

formatPercentage

(value)

Formate une valeur décimale en pourcentage.

Paramètres
value number Valeur décimale (0.5 = 50 %)
Valeur renvoyée string
Exemples
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Remarques

Disponible uniquement dans les expressions du frontend.

formatNumber

(value, decimals?)

Formate un nombre avec un nombre facultatif de décimales. Disponible uniquement dans le frontend.

Paramètres
value number Nombre à formater
decimals (facultatif) number Nombre de décimales
Valeur renvoyée string
Exemples
formatNumber(1234.5, 2) → 1,234.50
Remarques

Disponible uniquement dans les expressions du frontend.

formatCurrency

(value, currency, decimals?)

Formate un nombre en devise. Disponible uniquement dans le frontend.

Paramètres
value number Nombre à formater
currency string Code devise ISO 4217, par exemple EUR ou USD
decimals (facultatif) number Nombre de décimales
Valeur renvoyée string
Exemples
formatCurrency(99.9, "EUR") → €99.90
Remarques

Disponible uniquement dans les expressions du frontend.

Sujets associés

Documentation associée