Decimal

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

JSON 表現
{
  "value": string
}
フィールド
value

string

10 進数値を文字列として表します。

文字列の表現は、オプションの符号(+(U+002B)または -(U+002D))の後に、0 個以上の 10 進数("the integer")が続き、必要に応じて小数部が続き、必要に応じて指数部が続きます。空の文字列は 0 として解釈する必要があります 。

小数部は、小数点に 0 個以上の 10 進数が続きます。文字列には、整数部または小数部のいずれかに少なくとも 1 桁の数字が含まれている必要があります。符号、整数部、小数部で構成される数値を仮数と呼びます。

指数部は、文字 e(U+0065)または E(U+0045)の後に 1 桁以上の 10 進数が続きます。

サービスは、10 進数値を保存する前に、次の方法で正規化する必要があります 。

  • 明示的に指定された + 符号を削除します(+2.5 -> 2.5)。
  • 長さがゼロの整数値を 0 に置き換えます(.5 -> 0.5)。
  • 指数文字を大文字に変換し、符号を明示的に指定します(2.5e8 -> 2.5E+8)。
  • 明示的に指定されたゼロの指数を削除します(2.5E0 -> 2.5)。

サービスは、独自のニーズと選択した内部 10 進数実装に基づいて、追加の正規化を行う場合があります (小数点と指数値を同時にシフトするなど(例: 2.5E-1 <-> 0.25))。また、サービスは、精度を高めるために小数部の末尾のゼロを保持する場合があります が、必須ではありません。

整数部と小数部を区切るには . 文字のみがサポートされます。ロケールに関係なく、, はサポートされません 。また、3 桁ごとの区切り文字はサポートされません 。サービスでサポートされている場合は、値を正規化する必要があります 。

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)でエラーを返す必要があります 。