En esta página
> recursos > documentacion > expresiones > Funciones de formato

Funciones de formato

Funciones para dar formato a los valores que se muestran. Estas funciones están disponibles principalmente en las expresiones de los Dashboards.

info

Las funciones de formato están disponibles en expresiones del frontend (Dashboards, visualizaciones), pero no en atributos calculados del servidor.

Patrones habituales

  • Mostrar fechas:

    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

  • Dar formato a duraciones:

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

  • Mostrar porcentajes:

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

Patrones de formato de fecha

Utiliza patrones de formato de date-fns. Tokens de formato habituales para formatDate:

  • Año:

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

  • Mes:

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

  • Día:

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

  • Hora:

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

Unidades de duración

Solo están disponibles en expresiones del frontend. Utilizan etiquetas de unidad abreviadas:

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

formatDate

(timestamp, format)

Da formato a una marca de tiempo mediante un patrón de fecha.

Parámetros
timestamp number La marca de tiempo a la que se dará formato
format string El patrón de formato, por ejemplo, 'yyyy-MM-dd' o 'HH:mm'
Devuelve cadena
Ejemplos
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Notas

Los tokens compatibles se derivan de forma coherente para el frontend y Athena: yyyy, MM, dd, HH, mm y ss. También se admiten M, d, H, m, s y MMM, MMMM, EEE, EEEE para dar formato. El formato utiliza la semántica UTC.

formatDuration

(duration, unit?)

Da formato a una duración en milisegundos como una cadena fácil de interpretar.

Parámetros
duration number Duración en milisegundos
unit (opcional) string Unidad de visualización: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Devuelve cadena
Ejemplos
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Notas

Disponible únicamente en expresiones del frontend. Utiliza etiquetas de unidad abreviadas (s, m, h, d, mo, y).

formatPercentage

(value)

Da formato a un valor decimal como porcentaje.

Parámetros
value number El valor decimal (0.5 = 50 %)
Devuelve cadena
Ejemplos
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Notas

Disponible únicamente en expresiones del frontend.

formatNumber

(value, decimals?)

Da formato a un número con un número opcional de decimales. Solo está disponible en el frontend.

Parámetros
value number El número al que se dará formato
decimals (opcional) number Número de posiciones decimales
Devuelve cadena
Ejemplos
formatNumber(1234.5, 2) → 1,234.50
Notas

Disponible únicamente en expresiones del frontend.

formatCurrency

(value, currency, decimals?)

Da formato a un número como moneda. Solo está disponible en el frontend.

Parámetros
value number El número al que se dará formato
currency string Código de moneda ISO 4217, por ejemplo, EUR o USD
decimals (opcional) number Número de posiciones decimales
Devuelve cadena
Ejemplos
formatCurrency(99.9, "EUR") → €99.90
Notas

Disponible únicamente en expresiones del frontend.

Temas relacionados