時刻値が SQL Server の時刻列から PIC X 文字出力ホスト変数に返される際に使用する明示的な時刻形式を指定します。
DETECTDATE に加えて使用すると、文字出力ホスト変数で認識する明示的な時刻フォーマットを指定します。
注: 本トピックでは、HCOSS SQL コンパイラ指示オプションとして使用する TIME について説明するため、ユーザーが DIALECT=MAINFRAME を設定したものと想定しています。汎用 SQL コンパイラ指令オプションとしての TIME の使用の詳細については、「
SQL コンパイラ指令オプション」の「
TIME」を参照してください。DIALECT HCOSS SQL コンパイラ指令オプションの詳細については、「
DIALECT」を参照してください。
構文：
TIME={ODBC | ISO | USA | EUR | JIS}
パラメーター：
- ODBC
- hh:mm:ss (SQL Server のデフォルト形式)
- ISO
- hh.mm.ss (メインフレームのデフォルト形式)
- USA
- hh:mm{AM|PM}
- EUR
- hh.mm.ss
- JIS
- hh:mm:ss
プロパティ：
| デフォルト： |
ISO (メインフレームのデフォルト形式) |
依存関係：
入力ホスト パラメーターに対して DETECTDATE HCOSS SQL コンパイラ指令も設定する必要があります。
範囲：
| コンパイル時の使用： |
あり |
| 実行時の動作： |
ソース ファイル |
詳細については、「範囲 - HCOSS SQL コンパイラ指令オプション」を参照してください。
説明：
TIME は出力ホスト変数の表示形式を指定に従って変更します。
注: TIME を使用して代替フォーマットを指定しない場合、本トピックの「
プロパティ」セクションで指定されているとおり、HCOSS はデフォルトでメインフレーム ISO 形式を使用して SQL Server 時刻列を出力文字ホスト変数に返します。
TIME および DETECTDATE の両方を指定した場合、HCOSS は TIME を使用して、入力ホスト変数の時刻値を認識します。詳細については、「DETECTDATE」を参照してください。
次の内容は USA フォーマットに当てはまります。
- 分は省略できます。たとえば、1 PM は 1:00 PM を意味します。
- AM と PM に大文字と小文字の区別はありません。
- AM または PM の前に空白が必要です。
- 時間は 12 を超えてはならず、00:00 AM の特例を除き時間に 0 を指定できません。