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 Dashboard.

info

formatDuration, formatPercentage, formatNumber y formatCurrency solo están disponibles en expresiones del frontend (Dashboards y visualizaciones). formatDate está disponible tanto en expresiones del frontend como 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 un subconjunto de los patrones de formato de date-fns. Estos son los tokens compatibles con formatDate:

  • Año:

    yyyy   4-digit year      2024

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

Unidades de duración

Solo disponible en expresiones del frontend. Utiliza 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 Marca de tiempo a la que se dará formato
format string Patrón de formato, por ejemplo, 'yyyy-MM-dd' o 'HH:mm'
Devuelve string
Ejemplos
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Notas

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

formatDuration

(duration, unit?)

Da formato a una duración en milisegundos como una cadena legible.

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

Disponible solo 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 Valor decimal (0,5 = 50 %)
Devuelve string
Ejemplos
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Notas

Disponible solo en expresiones del frontend.

formatNumber

(value, decimals?)

Da formato a un número con un número opcional de decimales. Solo para el frontend.

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

Disponible solo en expresiones del frontend.

formatCurrency

(value, currency, decimals?)

Da formato a un número como importe monetario. Solo para el frontend.

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

Disponible solo en expresiones del frontend.

Temas relacionados

Diseñe mejores procesos. Conecte su arquitectura. Mantenga el control.

Acceda de inmediato, sin tarjeta de crédito ni esperas. Transforme la forma de trabajar de su organización en diseños de procesos claros y conectados.

Defina la arquitectura de procesos, los responsables y los controles, y alinee las funciones y responsabilidades en todos los niveles.

Comience su prueba gratuita y establezca una base fiable para gobernar, gestionar y mejorar continuamente sus procesos.

Comience hoy su prueba gratuita