リリース情報

|43.9 GRAPHIC タイプと DATE/TIME/TIMESTAMP の互換性

|以下のセクションでは、日時値の「文字ストリング」表記という言い方は、「ストリング」表記に |変更されています。DB2 は、ユニコード・データベースに限り、日時値の「漢字ストリング」表記をサポートするようになりました。

|43.9.1 日時値のストリング表記

|データ・タイプが DATE、TIME、または TIMESTAMP の値は、ユーザーがすぐに理解できる形の内部形式で表されます。 |しかし、日付値、時刻値、およびタイム・スタンプ値も、ストリングで表すことができます。 |データ・タイプが DATE、TIME、または TIMESTAMP の定数または変数は存在しないため、 |ストリングで表すことができるのは便利です。 |日時値を検索するには、その前に、その日時値がストリング変数に割り当てられている必要があります。CHAR 関数 |または GRAPHIC 関数 (ユニコード・データベースのみ) は、 |日時値をストリング表記に変更するために使用できます。 |ストリング表記は、プログラムがプリコンパイルされるかデータベースにバインドされるときに DATETIME オプションの指定によってオーバーライドされない限り、 |通常は、データベースの国別/地域別コードに関連した、日時値のデフォルト形式です。

|その長さにかかわらず、ラージ・オブジェクト・ストリング、LONG VARCHAR 値または LONG VARGRAPHIC 値を、日時値を表すために使用することはできません (SQLSTATE 42884)。

|内部日時値の操作で日時値の有効なストリング表記が使用される場合、 |そのストリング表記は、操作の前に、日付、時刻、またはタイム・スタンプの内部形式に変換されます。

|日付、時刻、およびタイム・スタンプのストリングに、文字と数字以外は含めることはできません。

|43.9.1.1 日付ストリング、時刻ストリング、および日時ストリング

|これらの用語の定義が少し変更されています。 |「文字ストリング」表記という言い方は、「ストリング」表記に変更されました。

|43.9.2 データ・タイプ間のキャスト

|DATE、TIME、および TIMESTAMP を GRAPHIC および VARGRAPHIC にキャストできるように |なりました。GRAPHIC および VARGRAPHIC を DATE、TIME、および TIMESTAMP にキャストできるようになりました。 |漢字ストリングはユニコード・データベースでのみサポートされます。

|43.9.3 割り当てと比較

|割り当てと比較において、 |漢字ストリングと、DATE 値、TIME 値、および TIMESTAMP 値の間でデータ・タイプの互換性ができました。 |漢字ストリングはユニコード・データベースでのみサポートされます。

|43.9.4 日時の割り当て

|日時の割り当てにおける基本ルールは、DATE 値、TIME 値、または TIMESTAMP 値は、 |一致するデータ・タイプ (DATE、TIME、または TIMESTAMP のそれぞれ) の列か、 |あるいは、固定長または可変長ストリング変数またはストリング列にのみ割り当てることができる |ということです。LONG VARCHAR、CLOB、LONG VARGRAPHIC、 |DBCLOB、または BLOB 変数または列に割り当てることはできません。 | |

|ターゲットがホスト変数の場合、以下のルールが適用されます。 |

|DATE: 変数の長さが 10 文字より短い場合、エラーになります。
|TIME: USA フォーマットが使用されている場合、変数の長さは、8 文字以上である必要があります。 |その他のフォーマットの場合、長さは 5 文字以上である必要があります。

|ISO または JIS フォーマットを使用する場合で、ホスト変数の長さが 8 文字未満であれば、 |時刻の「秒」部分は結果から省略され、標識変数があれば、 |そこに割り当てられます。SQLCA の SQLWARN1 フィールドが設定されて、省略されたことが示されます。
|TIMESTAMP: ホスト変数が 19 文字未満の場合、エラーになります。 |長さが 19 文字以上、26 文字未満の場合、値の「マイクロ秒」部分の末尾桁は省略されます。 |SQLCA の SQLWARN1 フィールドが設定されて、省略されたことが示されます。 |

|43.9.5 DATE

| | |

|>>-DATE--(--expression--)--------------------------------------><
| 
|

|スキーマは SYSIBM です。

|DATE 関数は、値からの日付を戻します。

|引き数は、日付、タイム・スタンプ、3 652 059 以下の正数、日付またはタイム・スタンプの有効なストリング表記、 |または、LONG VARCHAR、CLOB、LONG VARGRAPHIC、DBCLOB、BLOB 以外の、長さが 7 のストリングである必要があります。

|ユニコード・データベースだけが、日付またはタイム・スタンプの漢字ストリング表記の引き数をサポートします。

|引き数が長さ 7 のストリングである場合、そのストリングは yyyynnn 形式で、有効な日付を表している必要があります。 |ここで、yyyy は年を表す数字で、nnn は年間通算日を表す 001 から 366 の間の数字です。

|この関数の結果は日付です。 |引き数が NULL となる可能性がある場合、結果が NULL となる可能性があります。 |引き数が NULL であれば、結果は NULL 値になります。

|その他のルールは、引き数のデータ・タイプによって異なります。 |

|引き数が日付またはタイム・スタンプ、あるいは、日付またはタイム・スタンプを表す有効なストリングである場合: |
- |結果は、値の日付部分です。 |
|引き数が数値である場合: |
- |結果は、1 月 1 日 (0001) 以後の日付で、n-1 です。n は数値の整数部分です。 |
|引き数が長さ 7 のストリングである場合: |
- |結果は、ストリングが表す日付です。 |
|

|例:

|列 RECEIVED (タイム・スタンプ) の内部値が '1988-12-25-17.12.30.000000' を表していると想定します。 |

|この例では、'1988-12-25' の内部表記になります。
```
|   DATE(RECEIVED)
```
|この例では、'1988-12-25' の内部表記になります。
```
|   DATE('1988-12-25')
```
|この例では、'1988-12-25' の内部表記になります。
```
|   DATE('25.12.1988')
```
|この例では、'0001-02-04' の内部表記になります。
```
|   DATE(35)
```
|

|43.9.6 GRAPHIC

| | |

|>>-GRAPHIC--(--graphic-expression--+------------+--)-----------><
|                                   '-,--integer-'
| 
|

|スキーマは SYSIBM です。

|GRAPHIC 関数は、漢字ストリング・タイプの GRAPHIC 表記、あるいは日時タイプの GRAPHIC 表記を戻します。 |

|graphic-expression: |漢字ストリング値を戻す式です。
|integer: |結果の GRAPHIC データ・タイプの長さ属性を指定する整数値です。 |値は 1 から 127 の間でなければなりません。integer が指定されなければ、 |結果の長さは、1 番目の引き数の長さと同じになります。 |

|この関数の結果は GRAPHIC です。引き数が NULL となる可能性がある場合、結果が NULL となる可能性があります。 |引き数が NULL であれば、結果は NULL 値になります。

|日時から漢字:

|>>-GRAPHIC--(--datetime-expression--+--------------+--)--------><
|                                    '-,--+-ISO---+-'
|                                         +-------+
|                                         +-EUR---+
|                                         +-JIS---+
|                                         '-LOCAL-'
| 
|

|日時から漢字

|datetime-expression

|次の 3 つのデータ・タイプのいずれかの式です。

|日付: |結果は、2 番目の引き数で指定された形式で表された、日付の漢字ストリング表記です。 |結果の長さは 10 です。2 番目の引き数が指定されており、かつそれが有効な値でない場合は、エラーになります (SQLSTATE 42703)。
|時刻: |結果は、2 番目の引き数で指定された形式で表された、時刻の漢字ストリング表記です。 |結果の長さは 8 です。2 番目の引き数が指定されており、かつそれが有効な値でない場合は、エラーになります (SQLSTATE 42703)。
|タイム・スタンプ: |このタイプには 2 番目の引き数は当てはまりません。指定しないでください (SQLSTATE 42815)。 |結果は、タイム・スタンプの漢字ストリング表記です。 |結果の長さは 26 です。 |

|ストリングのコード・ページは、アプリケーション・サーバーでのデータベースのコード・ページです。 |

|43.9.7 TIME

| | | | | |

|>>-TIME--(--expression--)--------------------------------------><
| 
|

|スキーマは SYSIBM です。

|TIME 関数は、値からの時刻を戻します。

|引き数は、時刻またはタイム・スタンプであるか、または LONG VARCHAR、CLOB、 |LONG VARGRAPHIC、DBCLOB、BLOB を除く、時刻またはタイム・スタンプを表す有効なストリング表記である必要があります。

|ユニコード・データベースだけが、時刻またはタイム・スタンプの漢字ストリング表記の引き数をサポートします。

|この関数の結果は時刻です。 |引き数が NULL となる可能性がある場合、結果が NULL となる可能性があります。 |引き数が NULL であれば、結果は NULL 値になります。

|その他のルールは、引き数のデータ・タイプによって異なります。 |

|引き数が時刻である場合: |
- |結果は、その時刻です。 |
|引き数がタイム・スタンプである場合: |
- |結果は、そのタイム・スタンプの時刻部分です。 |
|引き数がストリングである場合: |
- |結果は、そのストリングが表す時刻です。 |
|

|例: |

|サンプルの IN_TRAY 表から、1 日のうち (任意の日)、受信してから現在時刻まで、少なくとも 1 時間以上経過したメモをすべて選択します。
```
|   SELECT * FROM IN_TRAY
|     WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR
```
|

|43.9.8 TIMESTAMP

| | | | | |

|>>-TIMESTAMP--(--expression--+-------------+--)----------------><
|                             '-,expression-'
| 
|

|スキーマは SYSIBM です。

|TIMESTAMP 関数は、1 つの値または 1 組の値から、タイム・スタンプを戻します。

|ユニコード・データベースだけが、日付、時刻、またはタイム・スタンプが漢字ストリングで表記された引き数をサポートします。

|引き数のルールは、2 番目の引き数が指定されたかどうかによって異なります。 |

|引き数が 1 つだけ指定された場合: |
- |その引き数は、タイム・スタンプ、タイム・スタンプの有効なストリング表記、 |または、LONG VARCHAR、CLOB、LONG VARGRAPHIC、DBCLOB、または BLOB を除く、長さが 14 のストリングである必要があります。
  
  |長さが 14 のストリングは、有効な日時を表す yyyyxxddhhmmss の形式の数字のストリングである必要があります。 |ここで yyyy は年、xx は月、dd は日、hh は時、mm は分、ss は秒です。 |
|両方の引き数が指定された場合: |
- |1 番目の引き数は日付または日付を表す有効なストリングであり、2 番目のストリングは、 |時刻または時刻を表す有効なストリングである必要があります。 |
|

|この関数の結果はタイム・スタンプです。 |どちらかの引き数が NULL となる可能性がある場合、結果が NULL となる可能性があります。 |どちらかの引き数が NULL であれば、結果は NULL 値になります。

|もう一方のルールは、2 番目の引き数が指定されたかどうかによって異なります。 |

|両方の引き数が指定された場合: |
- |結果は、1 番目の引き数で指定された日付と、2 番目の引き数で指定された時刻が入ったタイム・スタンプです。 |タイム・スタンプのマイクロ秒の部分はゼロです。 |
|引き数が 1 つだけ指定され、それがタイム・スタンプである場合: |
- |結果は、そのタイム・スタンプです。 |
|引き数が 1 つだけ指定され、それがストリングである場合: |
- |結果は、そのストリングが表すタイム・スタンプです。 |引き数が長さ 14 のストリングの場合、タイム・スタンプのマイクロ秒の部分はゼロになります。 |
|

|例: |

|列 START_DATE (日付) が 1988-12-25 の値で、列 START_TIME (時刻) が 17.12.30 の値を表していると想定します。
```
|   TIMESTAMP(START_DATE, START_TIME)
```
|値 '1988-12-25-17.12.30.000000' が戻されます。 |

|43.9.9 VARGRAPHIC

| | | | | | | |

|文字から Vargraphic:

|>>-VARGRAPHIC--(--character-string-expression--)---------------><
| 
|

|日時から Vargraphic:

|>>-VARGRAPHIC--(--datetime-expression--)-----------------------><
| 
|

|漢字から Vargraphic:

|>>-VARGRAPHIC--(--graphic-string-expression--+------------+----->
|                                             '-,--integer-'
| 
|>--)-----------------------------------------------------------><
| 
|

|スキーマは SYSIBM です。

|VARGRAPHIC 関数は、次のものの漢字ストリング表記を戻します。 |

|1 バイト文字から 2 バイト文字に変換した、文字ストリング値
|日時値 (ユニコード・データベースのみがサポート)
|1 番目の引き数が漢字ストリングのタイプであれば、漢字ストリング値 |

|この関数の結果は、いろいろな長さの漢字ストリング (VARGRAPHIC データ・タイプ) です。 |1 番目の引き数が NULL となる可能性がある場合、結果が NULL となる可能性があります。 |1 番目の引き数が NULL であれば、結果は NULL 値になります。

|文字から Vargraphic

|character-string-expression: |値が LONG VARCHAR または CLOB 以外の文字ストリングのデータ・タイプであり、かつ最大長が 16 336 バイト未満の式でなければなりません。 |

|結果の長さ属性は、引き数の長さ属性と同じです。

|以下は、変換に関する追加の考慮事項です。 |

|ユニコード・データベースの場合、この関数は、文字ストリングを、オペランドのコード・ページから UCS-2 に変換します。 |オペランドに指定された文字は、DBCS 文字も含めて、すべて変換されます。2 番目の |引き数が指定された場合、それによって、結果の UCS-2 ストリングの必要な長さ (UCS-2 文字の数) が指定されます。
|VARGRAPHIC 関数による 2 バイト・コード・ポイントへの変換は、オペランドのコード・ページに基づいて行われます。
|オペランドの 2 バイト文字は変換されません。 |それ以外の文字はすべて、それぞれ対応する 2 バイト表現に変換されます。 |対応する 2 バイト表現がない場合、そのコード・ページの 2 バイトの置換文字が使用されます。
|結果に置換文字が 1 つ以上戻されると、警告またはエラー・コードは生成されません。 |

|日時から Vargraphic

|datetime-expression: |値が DATE、TIME、または TIMESTAMP データ・タイプである式です。 |

|漢字から Vargraphic

|graphic-string-expression: |漢字ストリング値を戻す式です。
|integer: |いろいろな長さとなる結果の漢字ストリングの長さ属性です。 |値は 0 から 16 336 の間でなければなりません。 |この引き数が指定されなければ、結果の長さは、1 番目の引き数の長さと同じになります。 |

|graphic-string-expression の長さが結果の長さ属性よりも長い場合、 |切り捨てられる文字がすべてブランクで、 |しかも graphic-string-expression が長ストリング (LONG VARGRAPHIC または DBCLOB) でない限り、 |切り捨てが行われ、警告が戻されます (SQLSTATE 01004)。

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]