In questa pagina
> risorse > documentazione > espressioni > Funzioni di formattazione

Funzioni di formattazione

Funzioni per formattare i valori da visualizzare. Sono disponibili principalmente nelle espressioni delle Dashboard.

info

formatDuration, formatPercentage, formatNumber e formatCurrency sono disponibili solo nelle espressioni frontend (Dashboard e visualizzazioni). formatDate è disponibile sia nelle espressioni frontend sia negli attributi calcolati lato server.

Schemi comuni

  • Visualizzare le date:

    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

  • Formattare le durate:

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

  • Visualizzare le percentuali:

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

Schemi di formattazione delle date

Usa un sottoinsieme degli schemi di formattazione di date-fns. Token supportati da formatDate:

  • Anno:

    yyyy   4-digit year      2024

  • Mese:

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

  • Giorno:

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

  • Ora:

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

Unità di durata

Disponibile solo nelle espressioni frontend. Usa etichette brevi per le unità:

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

formatDate

(timestamp, format)

Formatta un timestamp usando un formato data.

Parametri
timestamp number Timestamp da formattare
format string Formato, ad esempio 'yyyy-MM-dd' o 'HH:mm'
Valori restituiti stringa
Esempi
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Note

I token supportati sono definiti in modo coerente per il frontend e Athena: yyyy, MM, dd, HH, mm, ss. Per la formattazione sono supportati anche M, d, H, m, s e MMM, MMMM, EEE, EEEE. La formattazione segue la semantica UTC.

formatDuration

(duration, unit?)

Formatta una durata espressa in millisecondi come stringa leggibile.

Parametri
duration number Durata in millisecondi
unit (facoltativo) string Unità di visualizzazione: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Valori restituiti stringa
Esempi
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Note

Disponibile solo nelle espressioni del frontend. Utilizza abbreviazioni delle unità (s, m, h, d, mo, y).

formatPercentage

(value)

Formatta un valore decimale come percentuale.

Parametri
value number Valore decimale (0.5 = 50%)
Valori restituiti stringa
Esempi
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Note

Disponibile solo nelle espressioni del frontend.

formatNumber

(value, decimals?)

Formatta un numero, con la possibilità di specificare le cifre decimali. Disponibile solo nel frontend.

Parametri
value number Numero da formattare
decimals (facoltativo) number Numero di cifre decimali
Valori restituiti stringa
Esempi
formatNumber(1234.5, 2) → 1,234.50
Note

Disponibile solo nelle espressioni del frontend.

formatCurrency

(value, currency, decimals?)

Formatta un numero come importo monetario. Disponibile solo nel frontend.

Parametri
value number Numero da formattare
currency string Codice valuta ISO 4217, ad esempio EUR o USD
decimals (facoltativo) number Numero di cifre decimali
Valori restituiti stringa
Esempi
formatCurrency(99.9, "EUR") → €99.90
Note

Disponibile solo nelle espressioni del frontend.

Argomenti correlati

Progettazione. Analisi. Miglioramento. Costruisca un’architettura dei processi integrata e mantenga il controllo.

Acceda subito, senza carta di credito né attese. Trasformi il modo in cui opera la Sua organizzazione in una progettazione dei processi chiara e interconnessa.

Definisca l’architettura dei processi, le responsabilità e i controlli, e allinei ruoli e compiti a ogni livello.

Inizi la prova gratuita e crei una base affidabile per governare, gestire e migliorare costantemente i processi della Sua organizzazione.

Inizi ora la prova gratuita