Numeric Format
テキストを任意の数値データ型として解析する場合、または任意の数値データ型をテキストにフォーマットする必要がある場合は、フォーマットパターンを指定する必要があります。
解析とフォーマットはロケールに依存します。
CloudConnectでは、Javaの10進フォーマットが使用されます。 数値フォーマットパターン構文
Symbol | Location | Localized?(ロケール対応? | 意味 | ||||||
---|---|---|---|---|---|---|---|---|---|
# | 数字 | はい | 桁数.jp> | 桁数.jp> | 桁数.jp> | 数字, ゼロは不在 | |||
0 | 数字 | はい | 桁 | ||||||
と表示される。 | Number | Yes | Decimal separator or monetary decimal separator | ||||||
– | Number | Yes | Minus sign | ||||||
.Number | のような記号。 | Number | Yes | グループ化セパレータ | |||||
E | Number | Yes | 科学表記で仮数と指数を分離することが可能です。 接頭辞、接尾辞の引用は不要です。 | ||||||
; | サブパターン境界 | あり | 正と負のサブパターンを分離 | ||||||
% | プレフィックスまたはサフィックス | あり | 100倍してパーセント表示 | ‰ (\u2030) | Prefix or suffix | 1000倍して百分率で表示 | |||
¤ (\u00A4) | Prefix or suffix | 通貨記号.の場合。 通貨記号に置き換えます。 二重になっている場合は、国際通貨記号に置き換わる。 パターン内に存在する場合、通貨の小数点以下の区切り文字の代わりに使用されます。 | |||||||
‘ | プレフィックスまたはサフィックス | なし | プレフィックスまたはサフィックス内の特殊文字の引用に使われます。例えば、「’#’#」は123を「#123」とフォーマットします。 シングルクォート自体を作成するには、2つ続けて使用します。 “# o”clock”. |
-
prefix, suffixともにUnicode文字で、余白を含め、特殊文字を除いた” \u0000 から ㊤FFFDまで “です。
フォーマットパターンは、次の表に示すように、サブパターン、プレフィックス、サフィックス等から構成されます:
これらの記号の説明は次のとおりです。 使用される表記
表記 | 説明 |
---|---|
X* | 0個以上のX |
(X | Y) | XまたはY |
Xのいずれかのインスタンスです。.Y | XからYまでの任意の文字 |
S – T | Sに含まれる文字。 T |
{X} | X はオプション |
また、フォーマットはロケールに依存することを覚えていてください。 次の表は、ロケールによって結果が異なることを表しています。 ロケールに応じた書式設定
パターン | ロケール | 結果 | |
---|---|---|---|
###,###.### | en.US | 123,456.789 | |
###,### | de.DE | 123.789 | 123.456,789 |
###,###.### | fr.FR | 123 456,789 |
数字を扱うことについて深く調べるにはJava公式ドキュメントを見てみてください。
Scientific Notation
科学的記数法の数値は仮数と10の累乗の積として表される。
例えば、1234
は 1.234 x 103
と表すことができる。
仮数はしばしば1.0 <= x < 10.0
の範囲にあるが、そうである必要はない。
数値データ型は、パターンによってのみ科学的記数法をフォーマットおよび解析するように指示することができる。 パターンでは、指数文字の直後に1つ以上の数字文字が続くと科学的記法を示します。
例.
例: “0.###E0” は数字1234を “1.234E3” としてフォーマットします。
Legend:
1) の数値パターンと結果の例を以下に示します。 整数の最大桁数は3、最小桁数は1、最大値は最小値より大きいので、指数はいずれも3(整数の最大桁数)の倍数となる。) 整数最大桁数2、整数最小桁数1、最大値が最小値より大きいので、指数はそれぞれ2(整数最大桁数)の倍数となります。
3): 整数桁の最大値が2、整数桁の最小値が2、最大値は最小値と等しいので、指数を調整することで整数桁の最小値を実現します。
4): 整数部の最大桁数は3、分数部の最大桁数は2、有効桁数は整数部の最大桁数と分数部の最大桁数の和ですから、有効桁数は図のようになります(5桁)。
Binary Formats
以下の表は、使用できる形式のリストです。 利用可能なバイナリフォーマット
Type | Name | Format | Length |
---|---|---|---|
integer | BIG_ENDIAN |
two’s-complement.Of .T(整数) ビッグエンディアン | 変数 |
LITTLE_ENDIAN |
2の補数、リトルエンディアン | ||
PACKED_DECIMAL |
packeddecimal | ||
浮動小数点 | DOUBLE_BIG_ENDIAN |
IEEE 754, ビッグエンディアン | 8バイト |
DOUBLE_LITTLE_ENDIAN |
IEEE 754、リトルエンディアン | ||
FLOAT_BIG_ENDIAN |
IEEE 754, ビッグエンディアン | 4バイト | |
FLOAT_LITTLE_ENDIAN |
IEEE 754、リトルエンディアン |
浮動小数点フォーマットは、numeric
および decimal
データタイプで使用可能です。整数型は integer
および long
データ型で使用することができます。 例外として、decimal
データタイプは整数フォーマット (BIG_ENDIAN
、LITTLE_ENDIAN
および PACKED_DECIMAL
) もサポートしています。 decimal
データ型で整数フォーマットを使用する場合、Scale 属性に従って暗黙の小数点が設定されます。 例えば、格納されている値が123456789でScaleが3に設定されている場合、フィールドの値は123456.789となります。
バイナリフォーマットを使用するには、サポートされているデータ型の1つを使用してメタデータフィールドを作成し、Format属性に"BINARY:"
を前に付けたフォーマット名を設定します。
固定長フォーマット (double と float) の場合、Size 属性もそれに応じて設定する必要があります。
現在、バイナリデータ形式は ComplexDataReader と非推奨の FixLenDataReader によってのみ処理できます。