このページは Cloud Translation API によって翻訳されました。

Decimal

JSON 表現

10 進数値の表示（2.5 など）。クライアントは、Java の [BigDecimal][] や Python の [decimal.Decimal][] など、言語ネイティブの 10 進数形式に変換できます。

[BigDecimal]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/BigDecimal.html[decimal.Decimal]: https://docs.python.org/3/library/decimal.html

JSON 表現
{ "value": string }

フィールド

フィールド
`value`	`string` 10 進数値（文字列）。文字列表現は、オプションの記号、`+`（`U+002B`）または `-`（`U+002D`）、その後に 0 個以上の 10 進数字（「整数」）のシーケンス、必要に応じて小数点、必要に応じて指数で構成されます。空の文字列は `0` として解釈する必要があります。分数は、小数点の後に 0 個以上の小数点が続きます。文字列には、整数または分数のいずれかで 1 桁以上の数字を含める必要があります。符号と整数、分数で形成される数値を有意数と呼びます。指数は、文字 `e`（`U+0065`）または `E`（`U+0045`）の後に 1 つ以上の小数点が続いています。サービスで小数点以下の値を格納する前に、次の方法で正規化する必要があります。明示的に提供された `+` 記号を削除します（`+2.5` -> `2.5`）。長さがゼロの整数値を `0`（`.5` -> `0.5`）に置き換えます。指数文字を大文字にして、明示的に符号を付けます（`2.5e8` -> `2.5E+8`）。明示的に指定したゼロ指数を削除します（`2.5E0` -> `2.5`）。サービスでは、独自の小数点と小数点以下の数字の実装（例: `2.5E-1` <-> `0.25`）の変更など、独自のニーズと内部の小数点以下の桁数に基づいて、追加の正規化を行うことができます。たとえば、小数点以下を 0 にすると、適合率を上げることができますが、必須ではありません。整数と割合を分割できるのは `.` 文字のみです。言語に関係なく、`,` を指定しないでください。また、千桁の区切りはサポートされていません。これらのサービスでサポートされている場合、値を正規化する必要があります。 ENBF 文法は次のとおりです。 `DecimalString = '' \| [Sign] Significand [Exponent]; Sign = '+' \| '-'; Significand = Digits ['.'] [Digits] \| [Digits] '.' Digits; Exponent = ('e' \| 'E') [Sign] Digits; Digits = { '0' \| '1' \| '2' \| '3' \| '4' \| '5' \| '6' \| '7' \| '8' \| '9' };` サービスは、サポートされている値の範囲、最大サポートされる精度（合計桁数）、スケール（小数点以下の桁数）と、範囲外の値を受け取った場合の動作を明記する必要があります。サービスが適合する場合や、サービスがサポートする値より高い精度またはスケールを持つ場合であっても、サービスは、入力として渡された値を受け入れることが可能であり、サポートされているスケールに合わせるために値を丸める必要があります。または、精度が失われた場合に `400 Bad Request` （gRPC の `INVALID_ARGUMENT`）とともにエラーが発生することがあります。サポート対象の範囲外の値を受け取った場合、サービスは `400 Bad Request` とエラーになります（gRPC の `INVALID_ARGUMENT`）。

value

string

10 進数値（文字列）。

文字列表現は、オプションの記号、+（U+002B）または -（U+002D）、その後に 0 個以上の 10 進数字（「整数」）のシーケンス、必要に応じて小数点、必要に応じて指数で構成されます。空の文字列は 0 として解釈する必要があります。

分数は、小数点の後に 0 個以上の小数点が続きます。文字列には、整数または分数のいずれかで 1 桁以上の数字を含める必要があります。符号と整数、分数で形成される数値を有意数と呼びます。

指数は、文字 e（U+0065）または E（U+0045）の後に 1 つ以上の小数点が続いています。

サービスで小数点以下の値を格納する前に、次の方法で正規化する必要があります。

明示的に提供された + 記号を削除します（+2.5 -> 2.5）。
長さがゼロの整数値を 0（.5 -> 0.5）に置き換えます。
指数文字を大文字にして、明示的に符号を付けます（2.5e8 -> 2.5E+8）。
明示的に指定したゼロ指数を削除します（2.5E0 -> 2.5）。

サービスでは、独自の小数点と小数点以下の数字の実装（例: 2.5E-1 <-> 0.25）の変更など、独自のニーズと内部の小数点以下の桁数に基づいて、追加の正規化を行うことができます。たとえば、小数点以下を 0 にすると、適合率を上げることができますが、必須ではありません。

整数と割合を分割できるのは . 文字のみです。言語に関係なく、, を指定しないでください。また、千桁の区切りはサポートされていません。これらのサービスでサポートされている場合、値を正規化する必要があります。

ENBF 文法は次のとおりです。

DecimalString =
  '' | [Sign] Significand [Exponent];

Sign = '+' | '-';

Significand =
  Digits ['.'] [Digits] | [Digits] '.' Digits;

Exponent = ('e' | 'E') [Sign] Digits;

Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' };

サービスは、サポートされている値の範囲、最大サポートされる精度（合計桁数）、スケール（小数点以下の桁数）と、範囲外の値を受け取った場合の動作を明記する必要があります。

サービスが適合する場合や、サービスがサポートする値より高い精度またはスケールを持つ場合であっても、サービスは、入力として渡された値を受け入れることが可能であり、サポートされているスケールに合わせるために値を丸める必要があります。または、精度が失われた場合に 400 Bad Request （gRPC の INVALID_ARGUMENT）とともにエラーが発生することがあります。

サポート対象の範囲外の値を受け取った場合、サービスは 400 Bad Request とエラーになります（gRPC の INVALID_ARGUMENT）。