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

Funções de formatação

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

info

formatDuration, formatPercentage, formatNumber e formatCurrency estão disponíveis apenas em expressões de frontend (Dashboards e exibições). formatDate está disponível tanto em expressões de frontend quanto 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 formato de data

Usa um subconjunto dos padrões de formatação do date-fns. Tokens compatíveis com formatDate:

  • Ano:

    yyyy   4-digit year      2024

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

Unidades de duração

Disponível apenas em expressões de 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 Timestamp a formatar
format string Padrão de formato, por exemplo, 'yyyy-MM-dd' ou 'HH:mm'
Retorno string
Exemplos
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Observações

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

formatDuration

(duration, unit?)

Formata uma duração em milissegundos como uma string legível.

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

Disponível apenas em expressões do frontend. Usa abreviações de unidades (s, m, h, d, mo, y).

formatPercentage

(value)

Formata um valor decimal como porcentagem.

Parâmetros
value number Valor decimal (0.5 = 50%)
Retorno string
Exemplos
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Observações

Disponível apenas em expressões do frontend.

formatNumber

(value, decimals?)

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

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

Disponível apenas em expressões do frontend.

formatCurrency

(value, currency, decimals?)

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

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

Disponível apenas em expressões do frontend.

Tópicos relacionados

Melhore seus processos. Crie uma arquitetura conectada. Mantenha o controle.

Acesse na hora, sem cartão de crédito nem espera. Transforme a forma como sua organização trabalha em modelos de processo claros e conectados.

Crie sua arquitetura de processos, defina responsabilidades e controles e alinhe papéis e atribuições em todos os níveis.

Comece o teste grátis e crie uma base confiável para governar, gerenciar e melhorar seus processos continuamente.

Comece hoje seu teste grátis.