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

Fonctions de mise en forme

Fonctions de mise en forme des valeurs affichées. Elles sont principalement disponibles dans les expressions des Dashboards.

info

formatDuration, formatPercentage, formatNumber et formatCurrency sont disponibles uniquement dans les expressions côté interface (Dashboards, affichages). formatDate est disponible dans les expressions côté interface et dans les attributs calculés côté serveur.

Exemples 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%"

Formats de date

Utilise un sous-ensemble des formats date-fns. Voici les jetons pris en charge par formatDate :

  • Année :

    yyyy   4-digit year      2024

  • 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
mm     Minutes           30
ss     Seconds           45

Unités de durée

Disponible uniquement dans les expressions côté interface. Utilise des libellés d’unité abrégés :

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

formatDate

(timestamp, format)

Formate un horodatage selon un modèle de date.

Paramètres
timestamp number Horodatage à formater
format string Modèle de format, par exemple 'yyyy-MM-dd' ou 'HH:mm'
Valeurs renvoyées chaîne
Exemples
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Remarques

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

formatDuration

(duration, unit?)

Formate une duré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’
Valeurs renvoyées chaîne
Exemples
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Remarques

Disponible uniquement dans les expressions frontend. Utilise des abréviations pour les unités (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 %)
Valeurs renvoyées chaîne
Exemples
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Remarques

Disponible uniquement dans les expressions 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
Valeurs renvoyées chaîne
Exemples
formatNumber(1234.5, 2) → 1,234.50
Remarques

Disponible uniquement dans les expressions frontend.

formatCurrency

(value, currency, decimals?)

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

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

Disponible uniquement dans les expressions frontend.

Sujets connexes

Documentation associée

Concevez de meilleurs processus. Bâtissez une architecture cohérente. Gardez la maîtrise.

Accédez immédiatement à la plateforme, sans carte bancaire ni attente. Représentez clairement le fonctionnement de votre organisation dans des modèles de processus reliés entre eux.

Définissez l’architecture des processus, les responsabilités et les contrôles, puis clarifiez les rôles à chaque niveau.

Démarrez votre essai gratuit et posez les bases d’une gouvernance, d’une gestion et d’une amélioration continue de vos processus.

Démarrez votre essai gratuit dès aujourd’hui.