Aller au contenu
POST AI agent ready /v1/number/format

API de format de nombre – Formatage local gratuit

Formatez un nombre en utilisant les règles spécifiques aux paramètres régionaux pour les séparateurs décimaux, le regroupement, les symboles monétaires et la notation de pourcentage. Propulsé par la norme 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

Affichages de prix internationalisés

Formatez les prix des produits dans les paramètres régionaux de l'utilisateur afin que les clients en Allemagne voient 1 234,56 EUR tandis que les clients américains voient 1 234,56 $.

Génération de rapports

Formatez les chiffres financiers dans des rapports PDF ou par courrier électronique côté serveur lorsque les API Intl côté client ne sont pas disponibles.

Frequently asked questions

Quels paramètres régionaux sont pris en charge ?
Toutes les balises locales BCP 47 prises en charge par la bibliothèque ICU, notamment en-US, de-DE, ja-JP, ar-SA et des centaines d'autres.
Dois-je transmettre la devise lorsque j’utilise le style de devise ?
Oui. Le paramètre monétaire est obligatoire lorsque le style est « monnaie ». L'API renvoie une erreur si elle est manquante.
Puis-je formater des pourcentages ?
Oui. Définissez le style sur « pourcentage » et transmettez le nombre sous forme décimale (par exemple, 0,85 pour 85 %).
Est-ce que cela gère de très grands nombres ?
Oui. L'API prend en charge les nombres jusqu'à Number.MAX_SAFE_INTEGER (9 007 199 254 740 991). Pour les valeurs plus grandes, transmettez-les sous forme de chaînes.

Get your API key

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