Nesta página
> recursos > documentação > expressões > Funções de formatação

Funções de formatação

Funções para formatar valores para exibição. Essas funções estão disponíveis principalmente em expressões de Dashboard.

info

As funções de formatação estão disponíveis em expressões do frontend (Dashboards e exibições), mas não em atributos calculados no servidor.

Padrões comuns

  • Exibir datas:

    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

  • Formatar duração:

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

  • Exibir porcentagens:

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

Padrões de formatação de datas

Usa padrões de formatação do date-fns. Tokens de formatação comuns para formatDate:

  • Ano:

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

  • Mês:

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

  • Dia:

    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 duração

Disponível somente em expressões do frontend. Usa abreviações de unidades:

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

formatDate

(timestamp, format)

Formata um timestamp usando um padrão de data.

Parâmetros
timestamp number O timestamp a formatar
format string O padrão de formato, por exemplo, 'yyyy-MM-dd' ou 'HH:mm'
Retorno texto
Exemplos
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Observações

Os tokens aceitos são definidos de forma consistente para o frontend e o Athena: yyyy, MM, dd, HH, mm, ss. M, d, H, m, s e MMM, MMMM, EEE, EEEE também são aceitos para formatação. A formatação usa a semântica UTC.

formatDuration

(duration, unit?)

Formata uma duração em milissegundos como um texto fácil de entender.

Parâmetros
duration number Duração em milissegundos
unit (opcional) string Unidade de exibição: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Retorno texto
Exemplos
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Observações

Disponível somente nas expressões do frontend. Usa rótulos curtos de unidade (s, m, h, d, mo, y).

formatPercentage

(value)

Formata um valor decimal como porcentagem.

Parâmetros
value number O valor decimal (0,5 = 50%)
Retorno texto
Exemplos
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Observações

Disponível somente nas expressões do frontend.

formatNumber

(value, decimals?)

Formata um número com casas decimais opcionais. Disponível somente no frontend.

Parâmetros
value number O número a formatar
decimals (opcional) number Número de casas decimais
Retorno texto
Exemplos
formatNumber(1234.5, 2) → 1,234.50
Observações

Disponível somente nas expressões do frontend.

formatCurrency

(value, currency, decimals?)

Formata um número como moeda. Disponível somente no frontend.

Parâmetros
value number O número a formatar
currency string Código de moeda ISO 4217, por exemplo, EUR ou USD
decimals (opcional) number Número de casas decimais
Retorno texto
Exemplos
formatCurrency(99.9, "EUR") → €99.90
Observações

Disponível somente nas expressões do frontend.

Tópicos relacionados