コンテンツへスキップ
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 ドルが表示されるようにします。

レポートの生成

クライアント側の国際 API が利用できない場合は、サーバー側の PDF または電子メール レポートで財務数値をフォーマットします。

Frequently asked questions

どのロケールがサポートされていますか?
ICU ライブラリでサポートされているすべての BCP 47 ロケール タグ (en-US、de-DE、ja-JP、ar-SA など)。
通貨スタイルを使用する場合、通貨を渡す必要がありますか?
はい。 スタイルが「通貨」の場合、通貨パラメータは必須です。 欠落している場合、API はエラーを返します。
パーセンテージをフォーマットできますか?
はい。 スタイルを「パーセント」に設定し、数値を小数として渡します (たとえば、85% の場合は 0.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.