DATETIMEOFFSET データ型

DATETIMEOFFSET データ型は TIMESTAMP WITH TIME ZONE のエイリアスであり、日付、時刻、およびタイムゾーン情報の格納に使用されます。

構文

DATETIMEOFFSET

備考

DATETIMEOFFSET 値は、年、月、日、時、分、秒、秒の小数位、および協定世界時 (UTC: Coordinated Universal Time) との差異を示す分数を含んでいます。秒以下は 6 桁まで格納されます。

アプリケーションが文字列として DATETIMEOFFSET 値を取得するときの形式は、timestamp_with_time_zone_format オプションの設定によって決まります。たとえば、DATETIMEOFFSET 値 2010/04/01T23:59:59.999999-6:00 は、timestamp_with_time_zone_format オプション設定に従い、アプリケーションに 2010/04/01 23:59:59 -6:00 または April 1, 2010 23:59:59.999999 -06:00 として返されます。

DATETIMEOFFSET 値には 10 バイトの記憶領域が必要です。

DATETIMEOFFSET データ型では、DATE 型と同じく 0001 ～ 9999 年の日付を格納できますが、DATETIMEOFFSET データ型の有効範囲は 1600-02-28 23:59:59 ～ 7911-01-01 00:00:00 です。DATETIMEOFFSET 値では、この範囲より前または後の時間および分の部分は保持されません。

DATETIMEOFFSET は計算カラムまたはマテリアライズドビューには使用しないでください。時刻を制御する time_zone_adjustment オプションの値が、場所に基づく接続と日付によって異なるためです。

2 つの DATETIMEOFFSET 値が UTC において同じ時刻を表す場合、適用されている TIME ZONE オフセットに関係なく同じ時刻と見なされます。たとえば、次の文では、結果が同じと見なされるため、Yes が返されます。

IF CAST('2009-07-15 08:00:00 -08:00' AS DATETIMEOFFSET) = 
CAST('2009-07-15 11:00:00 -05:00' AS DATETIMEOFFSET) THEN 
SELECT  'Yes'
ELSE
SELECT 'No'
END IF;

DATETIMEOFFSET 値からタイムゾーンオフセットを省略すると、タイムスタンプが日付と時刻を標準時間または夏時間のいずれで表していても、クライアントの現在の UTC オフセットがデフォルト設定されます。たとえば、クライアントが東部標準タイムゾーンに属しており、夏時間が有効なときに次の文を実行した場合、大西洋標準タイムゾーン (UTC から -4 時間) に該当するタイムゾーンでタイムスタンプが返されます。

SELECT CAST('2009/01/30 12:34:55' AS DATETIMEOFFSET);

DATETIMEOFFSET 値をタイムゾーン付きではないタイムスタンプと比較することはおすすめしません。これは、クライアントのデフォルトのタイムゾーンオフセットは、クライアントの地理的な場所および日付によって異なるためです。

クライアントの現在のタイムゾーンオフセットを分単位で判別するには、次の文を実行します。

SELECT CONNECTION_PROPERTY( 'TimeZoneAdjustment' );

注意

TimeZoneAdjustment 接続プロパティは、Ultra Light データベースではサポートされません。

参照

標準と互換性

SQL/2008 DATETIMEOFFSET の特定の使用方法はベンダー拡張です。SQL/2008 と互換性を保つには、TIMESTAMP WITH TIME ZONE を使用します。TIMESTAMP WITH TIME ZONE 型は、SQL/2008 標準のオプションの SQL 言語機能 F411 です。

DocCommentXchange で意見交換できます