Uttara

Apresentação · Formatação de saída

Formatação de saída

Helpers puros para exibir valores crus do banco/API: moeda, números, datas relativas, identificadores BR e helpers de string. Importe via @uttara-dev/ui/format.

Helpers de formatação

formatCurrency, formatNumber, formatDate/DateTime/Relative, formatPhoneBR/CpfCnpj/Cep, truncate, pluralize, initials. Tolerantes a null com fallback opcional.

Números e moeda

1234.5R$ 1.234,50formatCurrency(1234.5)
1234.5 (USD em en-US)$1,234.50formatCurrency(1234.5, "USD", { locale: "en-US" })
1234567.891.234.567,89formatNumber(1234567.89)
12.512,5%formatPercent(12.5)
0.125 (ratio)12,5%formatPercent(0.125, { mode: "ratio" })
25000002,5 miformatCompact(2_500_000)

Datas

"2026-04-26"26/04/2026formatDate("2026-04-26")
Date longo26 de abril de 2026formatDate(d, { dateStyle: "long" })
Date + hora26/04/2026, 12:00formatDateTime(d)
OntemontemformatRelative(d, { now })
Há 6 diashá 6 diasformatRelative(d, { now })

Identificadores BR (exibição)

"11987654321"(11) 98765-4321formatPhoneBR("11987654321")
"1132345678"(11) 3234-5678formatPhoneBR("1132345678")
"12345678901"123.456.789-01formatCpfCnpj("12345678901")
"12345678000190"12.345.678/0001-90formatCpfCnpj("12345678000190")
"01310100"01310-100formatCep("01310100")
null (com fallback)formatCpfCnpj(null, { fallback: "—" })

Texto

"Lorem ipsum dolor sit amet"Lorem ipsum…truncate(s, 12)
0 itens0 itenspluralize(0, "item", "itens")
1 item1 itempluralize(1, "item", "itens")
3 itens3 itenspluralize(3, "item", "itens")
"Ana Maria Souza"AMinitials("Ana Maria Souza")