Перейти к содержимому
POST AI agent ready /v1/number/format

API числового формата — бесплатное форматирование локали

Отформатируйте число, используя специфичные для локали правила для десятичных разделителей, группировки, символов валюты и процентного обозначения. Работает на основе стандарта 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

Международные дисплеи цен

Отформатируйте цены на продукты в языковом стандарте пользователя, чтобы клиенты в Германии видели 1 234,56 евро, а клиенты из США — 1 234,56 долларов США.

Генерация отчета

Форматируйте финансовые показатели в серверных PDF-файлах или в отчетах по электронной почте, если международные API на стороне клиента недоступны.

Frequently asked questions

Какие локали поддерживаются?
Все теги локали BCP 47, поддерживаемые библиотекой ICU, включая en-US, de-DE, ja-JP, ar-SA и сотни других.
Нужно ли передавать валюту при использовании стиля валюты?
Да. Параметр валюты является обязательным, если выбран стиль «валюта». API возвращает ошибку, если он отсутствует.
Могу ли я форматировать проценты?
Да. Установите стиль «процент» и передайте число в десятичном виде (например, 0,85 для 85%).
Это обрабатывает очень большие числа?
Да. API поддерживает числа до Number.MAX_SAFE_INTEGER (9 007 199 254 740 991). Для больших значений передайте их как строки.

Get your API key

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