SQL 形式モデル¶

形式要素¶

形式要素は、数字および/または文字のシーケンス（ほとんど大文字と小文字を区別しない）、および記号の場合があります。形式要素は、互いに直接連結できます。

一部の形式要素は、入力テキストの出力と一致を制御するために、すべての形式モデルで共通して使用されます。他の形式要素には、キャストに使用される値の型に基づいた特定の用途があります。詳細については、このトピックの次のセクションをご参照ください。

• 形式修飾子と汎用スペース処理

• 固定位置形式要素

• テキスト最小形式要素

形式リテラル¶

形式リテラルは、次の組み合わせで構成されるシーケンスです。

• 二重引用符で区切られた任意の文字列（二重引用符は、隣接する2つの二重引用符として表される）。

• 次の1つ以上の記号：

  記号/文字	メモ
  . （ピリオド）	固定数値モデルでは、 0、 9、または X に続く場合は形式要素として扱われます。それ以外の場合はそのまま保存されます。
  , （コンマ）	数値モデルでは、 0、 9、または X に続く場合は形式要素として扱われます。それ以外の場合はそのまま保存されます。
  ; （セミコロン）	常にそのまま保存されます。
  : （コロン）	常にそのまま保存されます。
  - （マイナス記号）	常にそのまま保存されます。
  = （等号）	常にそのまま保存されます。
  / （スラッシュ）	常にそのまま保存されます。
  ( （左括弧）	常にそのまま保存されます。
  ) （右括弧）	常にそのまま保存されます。

リテラルは常にそのままの形で、形式モデル内の場所で正確に出力されます。

以下に、 SQL 形式モデルを使用して、番号の前ではなく番号の後にマイナス記号を出力する簡単な例を示します。 MI は、数値が負の数である場合にマイナス記号を配置する場所を示します。

select to_varchar(-123.45, '999.99MI') as EXAMPLE;

Copy

出力は、デフォルトの -123.45 ではなく 123.45- に似ています。

その他の例は、このトピックの最後に含まれています。

Fillモード修飾子を使用した出力文字列の出力¶

デフォルトでは、Fillモードは fill に設定され、 FM Fillモード修飾子はそれを compact に切り替えます。繰り返し使用すると、 fill などに戻ります。

ほとんどの場合、出力で fill モードを使用すると、左側に数字の先頭にゼロまたはスペースを埋め込み、右側にテキストを埋め込むことで、形式要素が固定幅の出力を生成することが保証されます。これにより、固定幅フォントの列指向出力が確実に整列されます。

compact モードでは、ほとんどの形式要素は最小幅の出力のみを生成します（先行ゼロとスペース、および後続スペースは抑制される）。

これらの規則に従わない形式要素は、以下に明示的に記載されています。

完全一致修飾子 FX は出力に影響しません。アンダースコア形式要素は何も出力しません。

修飾子を使用した入力文字列の解析¶

入力文字列の解析は、Fillモード修飾子 FM と完全一致修飾子 FX の両方の影響を受けます。初期：

• Fillモードは fill に設定され、 FM はそれを compact に切り替えて戻します。

• 完全一致モードは lax に設定され、 FX はそれを exact に切り替えて戻します。

解析中の形式要素およびリテラルに対するすべての文字列照合では、大文字と小文字が区別されません。

lax モードでは、入力解析の最初のステップは、先頭の空白（一連のスペース、タブ、 LF、 CR、 FF、 VT 文字）をスキップすることです。最初の形式要素が FX の場合、入力開始時のモードは厳密です。それ以外の場合は lax です。

lax 一致モードでは、リテラル内のスペースは、空ではない任意のスペースの入力シーケンスと照合されます。スペース以外の文字は1対1で一致します。 exact モードでは、リテラル内のすべての文字は入力文字と1対1で一致する必要があります。

数値形式要素は、対応する数字列と照合されます。

• fill モードと exact モードの両方が有効な場合、桁数は対応する数値形式要素の幅に正確に対応する必要があります（先行ゼロが予想される）。

• compact または lax モードが有効な場合、一致する入力番号には、最大で形式要素の最大幅に等しい桁数、および少なくとも1桁が必要です。先行ゼロは無視されます。

テキスト形式の要素は、大文字と小文字を区別せずに一致します。

• fill モードと exact モードの両方が有効な場合、要素の最大幅までの後続スペースの数が予想されます。

• それ以外の場合、可変長テキスト要素の後のスペースは lax モードでは無視され、 exact モードでは実際の単語（パディングスペースなし）との完全一致が期待されます。

最後に、現在のモードが lax の場合、入力文字列の最後までの末尾の空白は無視されます。

通常、 lax モードと exact モードの両方では、形式モデルにスペースが存在しないか、 fill モードで形式要素のコンテンツを出力しても生成できないスペースの照合は許可されません。

lax モードと exact モードの両方にスペースが存在する場合、スペースを無視する場所は、 _ （アンダースコア）形式要素を使用して明示的にマークできます。

経験則として、 exact モードの形式は、同じ形式で出力された入力文字列のみを認識しますが、 lax モードの形式は、Fillモード修飾子が追加または削除された同様の形式で印刷された入力文字列を認識します。

固定位置の数値形式¶

固定位置番号は、数字要素 0 または 9 を使用して表されます。例えば、 999 は、1から3の10進数を保持します。数値の小数部分は、区切り要素 . （ピリオド）または D を使用して区切られます。

• . は、常にピリオドとしてレンダリングされます。

• D 要素に別の文字を使用するには、入力文字列を変更して、キャスト関数を適用する前にすべてのピリオドをコンマに、すべてのコンマをピリオドに置き換えます。

通常、整数部の先行ゼロと小数部の後続ゼロはスペースで置き換えられます（整数部の値がゼロの場合を除き、その場合は単一の 0 文字としてレンダリングされる）。この動作を抑制するには、 9 の代わりに 0 形式要素を使用します。対応する位置には 0 文字が保持されます。形式要素 B を数値の前に使用すると、整数値の最後の 0 の保持が抑制されます（ B を使用し、数値の整数部分の値がゼロの場合、すべての数字はスペースとしてレンダリングされる）。

数字のグループ区切り記号 , （コンマ）または G は、数字が十分に大きく、数字がグループ区切り記号の両側にある場合、対応するグループ区切り文字が出力されます。通貨合計の出力に役立つ形式の例は 999,999.00 です。

形式の桁位置よりも数字の整数部分の桁数が多い場合、オーバーフローを示すためにすべての桁が # として出力されます。

指数要素により、整数部の最初の桁が1から9になるように固定位置の数値が正規化されます（数値の値がゼロでない限り、指数の値もゼロになる）。 EE 要素は指数の正しい桁数を自動的に選択し、 + 記号を出力しませんが、 EEE、 EEEE、 EEEEE は常に指数および要求された桁数の + または - 記号を出力します。（先行ゼロは抑制されない）。指数オーバーフローは、数字の代わりに # で示されます。

指数インジケータは、形式要素の最初の文字の大文字小文字に応じて、大文字の E または小文字の e を出力します。

X 形式要素は 9 と同様に機能しますが、16進数字 0-9A-F が出力されます。現在、16進小数はサポートされていません。 9 と同様に、 X は先行ゼロをスペースに置き換えます。 0 要素は、 X と組み合わせて使用すると、先行ゼロ抑制なしで16進数を出力します（したがって、 000X を使用して、常に4桁を含む16進数を出力します）。

X は大文字のラテン文字を含む16進数を出力し、小文字の x は小文字のラテン文字を出力します。16進数の 0 形式要素は、後続の X 形式要素の大文字と小文字を使用します。

通常、16進数は符号なしで出力されます。つまり、負の数値には最上位ビットにすべて 1 が含まれますが、 X 要素を明示的な符号（S または MI）とともに使用すると、 - 記号が絶対値とともに出力されます。

固定位置の数値形式モデルは、浮動小数点数の特別な値（無限大または非数値）のオーバーフローを報告します。

テキスト最小の数値形式¶

固定位置の数値形式モデルでは常に桁数が明示的に指定されますが、テキスト最小形式要素では、数値の値に基づいて最小桁数が使用されます。 TM* 形式の要素はFillモード修飾子（fill または compact）に関係なく、常にスペースなしの可変長出力を生成します。

• TM9 は、数値の値に基づいて、整数または小数として数値を出力します。10進数の固定小数点数値は、数値のスケールによって決定される小数部の桁数で正確に出力されます（末尾のゼロは fill モードで保持されます）。

• 浮動小数点数の場合、 TM9 は、数値の指数に基づいて小数桁の数を選択します（2進数から10進数への正確な変換はできません）。浮動小数点数の大きさが大きすぎて位置表記が長すぎる場合、科学表記に切り替えます（以下の TME を参照）。浮動小数点数が小さすぎる場合、 TM9 はゼロを出力します。

• TME は、科学表記法で数値を出力します。つまり、指数（ EE と同じ）と小数部の整数位置に1桁を付けて出力します。指数インジケータのケース（E または e）は、形式要素の最初の文字（T または t）のケースと一致します。

• TM は、数値の大きさに応じて TM9 または TME のいずれかを選択し、精度を維持しながらテキストの長さを最小化します。

出力のデフォルト形式¶

次の表に、出力のデフォルト形式を示します。

解析のデフォルト形式¶

次の表に、解析のデフォルト形式を示します。

オプティミスティック文字列の自動変換（数値として自動的に認識される文字列）に使用される形式のリストは、上記のデフォルト入力形式の表にあるすべての形式の結合です。

出力例¶

次の例は、先頭にゼロを付けて数字を表示する方法を示しています。

create table sample_numbers (f float);
insert into sample_numbers (f) values (1.2);
insert into sample_numbers (f) values (123.456);
insert into sample_numbers (f) values (1234.56);
insert into sample_numbers (f) values (-123456.789);
select to_varchar(f, '999,999.999'), to_varchar(f, 'S000,000.000') from sample_numbers;

Copy

出力は次のようになります。

+------------------------------+-------------------------------+
| TO_VARCHAR(F, '999,999.999') | TO_VARCHAR(F, 'S000,000.000') |
+==============================+===============================+
|        1.2                   | +000,001.200                  |
+------------------------------+-------------------------------+
|      123.456                 | +000,123.456                  |
+------------------------------+-------------------------------+
|    1,234.56                  | +001,234.560                  |
+------------------------------+-------------------------------+
| -123,456.789                 | -123,456.789                  |
+------------------------------+-------------------------------+

Copy

数字を揃えるために先行ゼロは必要ありません。デフォルトのFillモードは「fill」です。つまり、先頭の空白を使用して、小数点の位置に基づいて数値を揃えます。

select to_varchar(f, '999,999.999'), to_varchar(f, 'S999,999.999') from sample_numbers;

Copy

出力は次のようになります。

+------------------------------+-------------------------------+
| TO_VARCHAR(F, '999,999.999') | TO_VARCHAR(F, 'S999,999.999') |
+==============================+===============================+
|        1.2                   |       +1.2                    |
+------------------------------+-------------------------------+
|      123.456                 |     +123.456                  |
+------------------------------+-------------------------------+
|    1,234.56                  |   +1,234.56                   |
+------------------------------+-------------------------------+
| -123,456.789                 | -123,456.789                  |
+------------------------------+-------------------------------+

Copy

この例は、 FM （Fillモード）修飾子を使用して「fill」モードから「compact」モードに切り替えた場合、つまり数字を揃える先頭の文字を削除した場合の動作を示しています。

select  to_varchar(f, '999,999.999'), to_varchar(f, 'FM999,999.999') from sample_numbers;

Copy

出力は次のようになります。

+------------------------------+--------------------------------+
| TO_VARCHAR(F, '999,999.999') | TO_VARCHAR(F, 'FM999,999.999') |
+==============================+================================+
|        1.2                   | 1.2                            |
+------------------------------+--------------------------------+
|      123.456                 | 123.456                        |
+------------------------------+--------------------------------+
|    1,234.56                  | 1,234.56                       |
+------------------------------+--------------------------------+
| -123,456.789                 | -123,456.789                   |
+------------------------------+--------------------------------+

Copy

次の例は、指数表記で数値を表示する方法を示しています。

select to_char(1234, '9d999EE'), 'will look like', '1.234E3';

Copy

出力は次のようになります。

+--------------------------+------------------+-----------+
| TO_CHAR(1234, '9D999EE') | 'WILL LOOK LIKE' | '1.234E3' |
+==========================+==================+===========+
| 1.234E3                  |  will look like  |  1.234E3  |
+--------------------------+------------------+-----------+

Copy

これは、出力にリテラルを含める方法を示しています。リテラル部分は二重引用符で囲まれています（二重引用符は文字列を区切る一重引用符内）。

select to_char(12, '">"99"<"');

Copy

出力は次のようになります。

+-------+
| > 12< |
+-------+

Copy

入力例¶

これらの例は、入力に形式モデルを使用する方法を示しています。

次の例は、「0」と「9」を使用して数字の形式を指定することの違いを強調して、いくつかの単純な入力操作を示しています。

フォーマッタとしての数字「9」は、空白または「欠落」先行数字を受け入れます。フォーマッタとしての数字「0」は、空白または欠落している先行ゼロを受け入れません。

-- All of the following convert the input to the number 12,345.67.
SELECT TO_NUMBER('012,345.67', '999,999.99', 8, 2);
SELECT TO_NUMBER('12,345.67', '999,999.99', 8, 2);
SELECT TO_NUMBER(' 12,345.67', '999,999.99', 8, 2);
-- The first of the following works, but the others will not convert.
-- (They are not supposed to convert, so "failure" is correct.)
SELECT TO_NUMBER('012,345.67', '000,000.00', 8, 2);
SELECT TO_NUMBER('12,345.67', '000,000.00', 8, 2);
SELECT TO_NUMBER(' 12,345.67', '000,000.00', 8, 2);

Copy

これは、2つの数値形式（-### または ###-）のいずれかを受け入れる方法を示しています。

-- Create the table and insert data.
create table format1 (v varchar, i integer);
insert into format1 (v) values ('-101');
insert into format1 (v) values ('102-');
insert into format1 (v) values ('103');

-- Try to convert varchar to integer without a
-- format model.  This fails (as expected)
-- with a message similar to:
--    "Numeric value '102-' is not recognized"
update format1 set i = TO_NUMBER(v);

-- Now try again with a format specifier that allows the minus sign
-- to be at either the beginning or the end of the number.
-- Note the use of the vertical bar ("|") to indicate that
-- either format is acceptable.
update format1 set i = TO_NUMBER(v, 'MI999|999MI');
select i from format1;

Copy