Pular para o conteúdo
POST AI agent ready /v1/number/format

API de formato de número - formatação de localidade gratuita

Formate um número usando regras específicas de localidade para separadores decimais, agrupamento, símbolos de moeda e notação percentual. Desenvolvido pelo padrão Intl.NumberFormat.

Parameters

numberrequired

The number to format.

string

BCP 47 locale tag.

string

Formatting style.

string

ISO 4217 currency code (required when style is "currency").

Code examples

curl -X POST https://api.botoi.com/v1/number/format \
  -H "Content-Type: application/json" \
  -d '{"number":1234567.89,"locale":"de-DE","style":"currency","currency":"EUR"}'

When to use this API

Exibições de preços internacionalizadas

Formate os preços dos produtos na localidade do usuário para que os clientes na Alemanha vejam 1.234,56 EUR, enquanto os clientes dos EUA vejam US$ 1.234,56.

Geração de relatórios

Formate números financeiros em PDF do lado do servidor ou relatórios por e-mail onde as APIs internacionais do lado do cliente não estiverem disponíveis.

Frequently asked questions

Quais localidades são suportadas?
Todas as tags de localidade BCP 47 suportadas pela biblioteca ICU, incluindo en-US, de-DE, ja-JP, ar-SA e centenas de outras.
Preciso passar a moeda ao usar o estilo de moeda?
Sim. O parâmetro moeda é obrigatório quando o estilo é "moeda". A API retorna um erro se estiver faltando.
Posso formatar porcentagens?
Sim. Defina o estilo como "porcentagem" e passe o número como decimal (por exemplo, 0,85 para 85%).
Isso lida com números muito grandes?
Sim. A API oferece suporte a números até Number.MAX_SAFE_INTEGER (9.007.199.254.740.991). Para valores maiores, passe-os como strings.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.