datetimeoffset (Transact-SQL)

構文

datetimeoffset [ (fractional seconds precision) ]

既定の文字列リテラル形式 (下位クライアント用)

YYYY-MM-DD hh:mm:ss[. nnnnnnn] [{+|-}hh:mm]

詳細については、以下の「下位クライアントの下位互換性」セクションを参照してください。

時刻範囲

00:00:00 ～ 23:59:59.9999999

要素範囲

YYYY は、0001 ～ 9999 の年を表す 4 桁の数字です。

MM は、指定された年の 01 ～ 12 の月を表す 2 桁の数字です。

DD は、指定された月の (月に応じて) 01 ～ 31 の日を表す 2 桁の数字です。

hh は、00 ～ 23 の時を表す 2 桁の数字です。

mm は、00 ～ 59 の分を表す 2 桁の数字です。

ss は、00 ～ 59 の秒を表す 2 桁の数字です。

n* は、秒の有効桁数を表す 0 ～ 7 桁の数字です (0 ～ 9999999)。

hh は、-14 ～ +14 までの 2 桁の数字です。

mm は、00 ～ 59 の 2 桁の数字です。

有効桁数、小数点以下桁数

精度

100 ナノ秒

カレンダー

グレゴリオ暦

タイム ゾーン オフセットへの対応と保持

可

YYYY-MM-DDThh:mm:ss[. nnnnnnn][{+|-}hh:mm]

この 2 つの形式は、セッションのロケール設定である SET LANGUAGE および SET DATEFORMAT の影響を受けません。 datetimeoffset 部分と datetime 部分の間にスペースは使用できません。

time

hh:mm:ss[. nnnnnnn]

SQL_WVARCHAR または SQL_VARCHAR

DBTYPE_WSTR または DBTYPE_STR

Java.sql.String

String または SqString

datetime2

YYYY-MM-DD hh:mm:ss[. nnnnnnn]

SQL_WVARCHAR または SQL_VARCHAR

DBTYPE_WSTR または DBTYPE_STR

Java.sql.String

String または SqString

date

年、月、日がコピーされます。

次のコードは、datetimeoffset(4) 値を date 値に変換した結果を示しています。

DECLARE @datetimeoffset datetimeoffset(4) = '12-10-25 12:32:10 +01:00';
DECLARE @date date= @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset ', @date AS 'date';
--Result
--@datetimeoffset                date
-------------------------------- ----------
--2025-12-10 12:32:10.0000 +01:0 2025-12-10
--
--(1 row(s) affected)

datetime

日付と時刻の値がコピーされ、タイム ゾーンが切り捨てられます。 datetimeoffset(n) 値の小数部の有効桁数が 3 桁を超える場合、値は切り捨てられます。

次のコードは、datetimeoffset(4) 値を datetime 値に変換した結果を示しています。

DECLARE @datetimeoffset datetimeoffset(4) = '12-10-25 12:32:10.1237 +01:0';
DECLARE @datetime datetime = @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset ', @datetime AS 'datetime';
--Result
--@datetimeoffset                datetime
-------------------------------- -----------------------
--2025-12-10 12:32:10.1237 +01:0 2025-12-10 12:32:10.123
--
--(1 row(s) affected)

datetime2(n)

日付と時刻が datetime2 値にコピーされ、タイム ゾーンが切り捨てられます。 datetime2(n) 値の有効桁数が datetimeoffset(n) 値の有効桁数を超える場合、秒の小数部はその桁数に合わせて切り捨てられます。

次のコードは、datetimeoffset(4) 値を datetime2(3) 値に変換した結果を示しています。

DECLARE @datetimeoffset datetimeoffset(4) = '1912-10-25 12:24:32.1277 +10:0';
DECLARE @datetime2 datetime2(3)=@datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset', @datetime2 AS '@datetime2';
--Result
@datetimeoffset                    @datetime2
---------------------------------- ----------------------
1912-10-25 12:24:32.1277 +10:00    1912-10-25 12:24:32.12
--(1 row(s) affected)

ODBC 日付

ODBC 文字列リテラルは、datetime データ型にマップされます。 ODBC 日付時刻リテラルから datetimeoffset 型への代入演算を行うと、datetime 型とこれらの型との間で、変換規則で定義されている暗黙的な変換が行われます。

ODBC 日付時刻

上記の ODBC 日付の規則を参照。

時刻のみ

日付部分は既定値の 1900-1-1 に設定される タイム ゾーンは既定値の +00:00 に設定される

日付 + 時刻

タイム ゾーンは既定値の +00:00 に設定される

時刻 + タイム ゾーン

日付部分は既定値の 1900-1-1 に設定される

Time

12:35:29. 1234567

Smalldatetime

2007-05-08 12:35:00

datetime2

2007-05-08 12:35:29. 1234567