datetime2 (Transact-SQL)

構文

datetime2 [ (fractional seconds precision) ]

既定の文字列リテラル形式

(下位のクライアントに使用)

YYYY-MM-DD hh:mm:ss[.fractional seconds]

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

時刻範囲

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)。

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

0 ～ 7 桁で、精度は 100ns です。 既定の有効桁数は 7 桁です。

精度

100 ナノ秒

カレンダー

グレゴリオ暦

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

不可

YYYY-MM-DDThh:mm:ss[. nnnnnnn]

YYYY-MM-DDThh:mm:ss[. nnnnnnn]

この形式は、セッションのロケール設定である SET LANGUAGE および SET DATEFORMAT の影響を受けません。 文字列リテラルには、T、コロン (:)、およびピリオド (.) が含まれます (例 : '2007-05-02T19:58:47.1234567')。

{ ts 'yyyy-mm-dd hh:mm:ss[.fractional seconds]' }

ODBC API 固有です。

• 1 秒未満の秒を表す小数点の右側の桁数は、0 ～ 7 (100 ナノ秒) の範囲で指定できます。

• SQL Server 2012 では、互換性レベルを 10 に設定した場合、リテラルが内部的に新しい time 型にマップされます。

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

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

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

DECLARE @datetime2 datetime2(4) = '12-10-25 12:32:10.1234';
DECLARE @date date = @datetime2;
SELECT @datetime2 AS '@datetime2', @date AS 'date';
--Result
--@datetime2               date
-------------------------- ----------
--2025-12-10 12:32:10.1234 2025-12-10
--
--(1 row(s) affected)

datetime

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

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

DECLARE @datetime2 datetime2 = '12-10-25 12:32:10.1234567'
DECLARE @datetime datetime = @datetime2;
SELECT @datetime2 AS '@datetime2', @datetime AS '@datetime';
--Result
--@datetime2                  @datetime
----------------------------- -----------------------
@datetime2             @datetime
---------------------- -----------------------
2025-12-10 12:32:10.12 2025-12-10 12:32:10.123
--
--(1 row(s) affected)

datetimeoffset(n)

datetime2(n) 値が datetimeoffset(n) 値にコピーされます。 タイム ゾーン オフセットが +00:0 に設定されます。 datetime2(n) 値の有効桁数が datetimeoffset(n) 値の有効桁数を超える場合、値はその桁数に合わせて切り上げられます。

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

D DECLARE @datetime2 datetime2(3) = '12-10-25 12:32:10.12999';
DECLARE @datetimeoffset datetimeoffset(2) = @datetime2;
SELECT @datetime2 AS '@datetime2', @datetimeoffset AS '@datetimeoffset(2)';
--Result
--@datetime2              @datetimeoffset(2)
------------------------- -----------------------------
2025-12-10 12:32:10.13           2025-12-10 12:32:10.13 +00:00
--
--(1 row(s) affected)

ODBC 日付

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

ODBC 日付時刻

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

時刻のみ

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

日付 + 時刻

単純変換

時刻 + タイム ゾーン

日付部分は既定値の 1900-1-1 に設定される。 タイム ゾーンの入力は無視される。

time

12:35:29. 1234567

smalldatetime

2007-05-08 12:35:00

datetime2

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