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

Funzioni di formattazione

Funzioni per formattare i valori da visualizzare. Queste funzioni sono disponibili principalmente nelle espressioni delle Dashboard.

info

Le funzioni di formattazione sono disponibili nelle espressioni frontend, nelle Dashboard e nelle visualizzazioni, ma non negli attributi calcolati lato server.

Pattern 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 la durata:

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

Pattern di formattazione delle date

Utilizza i pattern di formattazione di date-fns. Token di formattazione comuni per formatDate:

  • Anno:

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

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

Unità di durata

Disponibile solo nelle espressioni frontend. Utilizza 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 utilizzando un modello di formato per la data.

Parametri
timestamp number Il timestamp da formattare
format string Il modello di formato, ad esempio 'yyyy-MM-dd' o 'HH:mm'
Valore restituito 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 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 utilizza la semantica UTC.

formatDuration

(duration, unit?)

Formatta una durata espressa in millisecondi in una stringa di facile lettura.

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

Disponibile solo nelle espressioni frontend. Utilizza etichette brevi per le unità (s, m, h, d, mo, y).

formatPercentage

(value)

Formatta un valore decimale come percentuale.

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

Disponibile solo nelle espressioni frontend.

formatNumber

(value, decimals?)

Formatta un numero con un numero opzionale di cifre decimali. Solo frontend.

Parametri
value number Il numero da formattare
decimals (opzionale) number Numero di cifre decimali
Valore restituito stringa
Esempi
formatNumber(1234.5, 2) → 1,234.50
Note

Disponibile solo nelle espressioni frontend.

formatCurrency

(value, currency, decimals?)

Formatta un numero come valuta. Solo frontend.

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

Disponibile solo nelle espressioni frontend.

Argomenti correlati