time (Transact-SQL)
適用対象: SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Microsoft Fabric のSQL 分析エンドポイント
Microsoft Fabric のウェアハウス
1 日の時刻を定義します。 時刻は 24 時間形式で、タイム ゾーンは認識されません。
Note
Informatica の情報は、Informatica コネクタを使っている PDW ユーザーのために提供されます。
time の説明
プロパティ | 値 |
---|---|
構文 | time [ (fractional second scale) ] |
使用法 | DECLARE @MyTime time(7) CREATE TABLE Table1 ( Column1 time(7) ) |
fractional seconds scale | 秒の小数点以下の有効桁数を指定します。 0 ~ 7 の整数を指定できます。 Informatica の場合は、0 ~ 3 の整数を指定できます。 既定の有効桁数は 7 (100 ナノ秒) です。 Microsoft Fabric では、0 から 6 の整数をこれに指定でき、既定値はありません。 Microsoft Fabric では精度を指定する必要があります。 |
既定の文字列リテラル形式 (下位クライアントに使用) |
hh:mm:ss[.nnnnnnn] (Informatica の場合は nnn) 詳細については、「下位クライアントの下位互換性」セクションを参照してください。 |
範囲 | 00:00:00.0000000 ~ 23:59:59.9999999 (Informatica の場合は 00:00:00.000 ~ 23:59:59.999) |
要素範囲 | hh は、0 ~ 23 の時を表す 2 桁の数字です。 mm は、0 ~ 59 の分を表す 2 桁の数字です。 ss は、0 ~ 59 の秒を表す 2 桁の数字です。 n* は、秒の有効桁数を表す 0 ~ 7 桁の数字です (0 ~ 9999999)。 Informatica の場合は、n* は 0 ~ 3 桁の数字です (0 ~ 999)。 |
文字長 | 8 文字 (hh:mm:ss) 以上、16 文字 (hh:mm:ss.nnnnnnn) 以下。 Informatica の場合は、最大 12 文字 (hh:mm:ss.nnn) です。 |
有効桁数、小数点以下桁数 (ユーザーは小数点以下桁数のみ指定) |
次の表を参照してください。 |
ストレージ サイズ | 既定では 5 バイト固定 (秒部分の既定の有効桁数は 100ns) です。 Informatica の場合は、既定では 4 バイト固定 (秒部分の既定の有効桁数は 1 ミリ秒) です。 |
精度 | 100 ナノ秒 (Informatica では 1 ミリ秒) |
既定値 | 00:00:00 この値は、date から datetime2 または datetimeoffset への暗黙的な変換で、付加的な時刻要素として使用されます。 |
ユーザー定義の 1 秒未満の秒の有効桁数 | はい |
タイム ゾーン オフセットへの対応と保持 | いいえ |
夏時間への対応 | いいえ |
指定した小数点以下桁数 | 結果 (有効桁数、小数点以下桁数) | 列長 (バイト) | 1 秒未満の seconds 精度 |
---|---|---|---|
time | (16,7) (Informatica では (12,3)) | 5 (Informatica では 4) | 7 (Informatica では 3) |
time(0) | (8,0) | 3 | 0-2 |
time(1) | (10,1) | 3 | 0-2 |
time(2) | (11,2) | 3 | 0-2 |
time(3) | (12,3) | 4 | 3-4 |
time(4)* | (13,4) | 4 | 3-4 |
time(5)* | (14,5) | 5 | 5-7 |
time(6)* | (15,6) | 5 | 5-7 |
time(7)* + | (16,7) | 5 | 5-7 |
* Informatica ではサポートされていません。
+ Microsoft Fabric ではサポートされていません。
time でサポートされる文字列リテラル形式
次の表は、time データ型に使用できる有効な文字列リテラル形式を示しています。
SQL Server | 説明 |
---|---|
hh:mm[:ss][:fractional seconds][AM][PM] hh:mm[:ss][.fractional seconds][AM][PM] hhAM[PM] hh AM[PM] |
AM を指定したかどうかに関係なく、時刻値 0 は午前 0 時を表します。 時刻値が 0 のときに PM を指定することはできません。 AM と PM のどちらも指定していない場合、01 から 11 までの時刻値は午前の時刻を表します。 これらの値は、AM を指定した場合も午前の時刻を表します。 PM を指定すると、午後の時刻を表します。 AM と PM のどちらも指定していない場合、時刻値 12 は正午を表します。 AM を指定すると、午前の時刻を表します。 PM を指定すると、正午を表します。 たとえば、12:01 という値は、12:01 PM では正午を 1 分過ぎた時刻、12:01 AM では午前 0 時を 1 分過ぎた時刻を表します。 12:01 AM と指定することは、00:01 または 00:01 AM と指定することと同じです。 13 から 23 までの時刻値は、AM または PM を指定していなくても、午後の時刻を表します。 また、PM を指定した場合も午後の時刻を表します。 時刻値が 13 から 23 までの場合、AM を指定することはできません。 24 という時刻値は無効です。 午前 0 時を表すには、12:00 AM または 00:00 を使います。 ミリ秒の前には、コロン (:) またはピリオド (.) を付けます。 コロンを付けると、その数値は 1000 分の 1 秒単位になります。 ピリオドを付けると、数字が 1 桁なら 10 分の 1 秒単位に、2 桁なら 100 分の 1 秒単位に、3 桁なら 1000 分の 1 秒単位になります。 たとえば、12:30:20:1 は 12 時 30 分を 20 と 1000 分の 1 秒過ぎた時刻を表し、12:30:20.1 は 12 時 30 分を 20 と 10 分の 1 秒過ぎた時刻を表します。 |
ISO 8601 | メモ |
---|---|
hh:mm:ss hh:mm[:ss][.fractional seconds] |
hh は、タイム ゾーン オフセットの時間数を表す、0 から 23 までの 2 桁の数字です。 mm は、タイム ゾーン オフセットの追加の分数を表す、0 から 59 までの 2 桁の数字です。 |
ODBC | メモ |
---|---|
{t 'hh:mm:ss[.fractional seconds]'} | ODBC API 固有です。 |
ANSI および ISO 8601 への準拠
ISO 8601 (5.3.2 および 5.3) では、午前 0 時を表す時刻値 24 や、59 を超えるうるう秒の使用が定義されていますが、こうした用法は、下位互換性および既存の日付時刻型との一貫性を保つためサポート対象外となります。
下位クライアントに使用される既定の文字列リテラル形式は、hh:mm:ss[.nnnnnnn] として定義されている SQL 標準形式に準拠しています。 この形式は、1 秒未満の秒を除き、TIME に対する ISO 8601 の定義と似ています。
下位クライアントの下位互換性
一部の下位レベル クライアントは、time、date、datetime2、datetimeoffset データ型をサポートしていません。 SQL Server の上位インスタンスと下位クライアントの間のデータ型マッピングを次の表に示します。
SQL Server のデータ型 | 下位クライアントに渡される既定の文字列リテラル形式 | 下位 ODBC | 下位 OLEDB | 下位 JDBC | 下位 SQLCLIENT |
---|---|---|---|---|---|
time | hh:mm:ss[.nnnnnnn] | SQL_WVARCHAR または SQL_VARCHAR | DBTYPE_WSTR または DBTYPE_STR | Java.sql.String | String または SqString |
date | YYYY-MM-DD | 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 |
datetimeoffset | YYYY-MM-DD hh:mm:ss[.nnnnnnn] [+|-]hh:mm | SQL_WVARCHAR または SQL_VARCHAR | DBTYPE_WSTR または DBTYPE_STR | Java.sql.String | String または SqString |
日付と時刻のデータ型の変換
日付と時刻のデータ型に変換する場合、SQL Server で日付または時刻と認識できない値はすべて拒否されます。 CAST 関数および CONVERT 関数で日付と時刻のデータを使用する方法については、「CAST および CONVERT (Transact-SQL)」をご覧ください。
time(n) データ型から他の日付/時刻データ型への変換
ここでは、time データ型が他の日付/時刻データ型に変換される場合の処理について説明します。
time(n) への変換では、時、分、秒がコピーされます。 変換先の有効桁数が、ソースの有効桁数よりも小さい場合、秒の小数部は変換先の有効桁数に合わせて切り上げられます。 次の例は、time(4)
値を time(3)
値に変換した結果を示しています。
DECLARE @timeFrom TIME(4) = '12:34:54.1237';
DECLARE @timeTo TIME(3) = @timeFrom;
SELECT @timeTo AS 'time(3)', @timeFrom AS 'time(4)';
結果セットは次のようになります。
time(3) time(4)
------------ -------------
12:34:54.124 12:34:54.1237
date に変換すると、変換は失敗し、エラー メッセージ 206"オペランド型の不整合: date は time と互換性がありません" が発生します。
変換先が datetime の場合は、時、分、秒の値がコピーされ、日付部分が "1900-01-01" に設定されます。 time(n) 値の秒の小数部の有効桁数が 3 桁より大きい場合、datetime の結果は切り捨てられます。 次のコードは、time(4)
値を datetime
値に変換した結果を示しています。
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime DATETIME = @time;
SELECT @time AS '@time', @datetime AS '@datetime';
結果セットは次のようになります。
@time @datetime
------------- -----------------------
12:15:04.1237 1900-01-01 12:15:04.123
変換先が smalldatetime の場合は、日付が "1900-01-01" に設定され、時間と分の値が切り上げられます。 秒と秒の小数部は 0 に設定されます。 次のコードは、time(4)
値を smalldatetime
値に変換した結果を示しています。
分の値の切り上げを表示します。
DECLARE @time TIME(4) = '12:15:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
結果セットは次のようになります。
@time @smalldatetime
---------------- -----------------------
12:15:59.9999 1900-01-01 12:16:00--
時間値の切り上げを表示します。
DECLARE @time TIME(4) = '12:59:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
結果セットは次のようになります。
@time @smalldatetime
---------------- -----------------------
12:59:59.9999 1900-01-01 13:00:00
変換先が datetimeoffset(n) の場合は、日付が "1900-01-01" に設定され、時刻がコピーされます。 タイム ゾーン オフセットが +00:00 に設定されます。 time(n) の値の秒の小数部の有効桁数が datetimeoffset(n) の値の有効桁数を超える場合、値はその桁数に合わせて切り上げられます。 次の例は、time(4)
値を datetimeoffset(3)
型に変換した結果を示しています。
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetimeoffset DATETIMEOFFSET(3) = @time;
SELECT @time AS '@time', @datetimeoffset AS '@datetimeoffset';
結果セットは次のようになります。
@time @datetimeoffset
------------- ------------------------------
12:15:04.1237 1900-01-01 12:15:04.124 +00:00
変換先が datetime2(n) の場合は、日付が "1900-01-01"' に設定され、時刻部分がコピーされ、タイム ゾーン オフセットが 00:00 に設定されます。 datetime2(n) 値の秒の小数部の有効桁数が time(n) 値を超える場合、値はその桁数に合わせて切り上げられます。 次の例は、time(4)
値を datetime2(2)
値に変換した結果を示しています。
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime2 DATETIME2(3) = @time;
SELECT @datetime2 AS '@datetime2', @time AS '@time';
結果セットは次のようになります。
@datetime2 @time
----------------------- -------------
1900-01-01 12:15:04.124 12:15:04.1237
文字列リテラルの time(n) への変換
文字列リテラルから日付/時刻データ型への変換は、文字列のすべての部分が有効な形式になっている場合に可能になります。 それ以外の場合は実行時エラーが発生します。 日付/時刻データ型から文字列リテラルへの暗黙的な変換や、スタイルを指定しない明示的な変換では、現在のセッションの既定の形式が使用されます。 次の表では、文字列リテラルを time データ型に変換する規則を示します。
入力文字列リテラル | 変換規則 |
---|---|
ODBC DATE | ODBC 文字列リテラルは、datetime データ型にマップされます。 ODBC 日付時刻リテラルから time 型への代入演算を行うと、datetime 型とこれらの型との間で、変換規則で定義されている暗黙的な変換が行われます。 |
ODBC TIME | 上記の ODBC 日付の規則を参照してください。 |
ODBC DATETIME | 上記の ODBC 日付の規則を参照してください。 |
DATE のみ | 既定値が指定されます。 |
TIME のみ | 単純変換 |
タイム ゾーンのみ | 既定値が指定されます。 |
DATE + TIME | 入力文字列の時刻部分が使用される |
DATE + TIMEZONE | 許可されていません。 |
TIME + TIMEZONE | 入力文字列の時刻部分が使用される |
DATE + TIME + TIMEZONE | ローカル datetime の時刻部分が使用されます。 |
例
A. date と time のデータ型を比較する
次の例では、文字列をそれぞれの date および time データ型にキャストした結果を比較します。
SELECT CAST('2007-05-08 12:35:29. 1234567 +12:15' AS TIME(7)) AS 'time',
CAST('2007-05-08 12:35:29. 1234567 +12:15' AS DATE) AS 'date',
CAST('2007-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
CAST('2007-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
CAST('2007-05-08 12:35:29. 1234567 +12:15' AS DATETIME2(7)) AS 'datetime2',
CAST('2007-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset';
データ型 | 出力 |
---|---|
time | 12:35:29. 1234567 |
date | 2007-05-08 |
smalldatetime | 2007-05-08 12:35:00 |
datetime | 2007-05-08 12:35:29.123 |
datetime2 | 2007-05-08 12:35:29. 1234567 |
datetimeoffset | 2007-05-08 12:35:29.1234567 +12:15 |
B. 有効な時刻文字列リテラルを time(7) 列に挿入する
次の表では、time(7) データ型の列に挿入可能な各種の文字列リテラルと、その列に格納される値を示します。
文字列リテラル形式の種類 | 挿入する文字列リテラル | 格納される time(7) 値 | 説明 |
---|---|---|---|
SQL Server | '01:01:01:123AM' | 01:01:01.1230000 | 秒の小数部の有効桁数の前にコロン (:) を付けた場合、小数点以下桁数が 3 桁を超えると、エラーが発生します。 |
SQL Server | '01:01:01.1234567 AM' | 01:01:01.1234567 | AM または PM を指定した場合、時刻は 24 時間形式で格納され、リテラルの AM または PM は格納されません。 |
SQL Server | '01:01:01.1234567 PM' | 13:01:01.1234567 | AM または PM を指定した場合、時刻は 24 時間形式で格納され、リテラルの AM または PM は格納されません。 |
SQL Server | '01:01:01.1234567PM' | 13:01:01.1234567 | AM または PM の前の空白は省略できます。 |
SQL Server | '01AM' | 01:00:00.0000000 | 時だけを指定した場合、他のすべての値は 0 になります。 |
SQL Server | '01 AM' | 01:00:00.0000000 | AM または PM の前の空白は省略できます。 |
SQL Server | '01:01:01' | 01:01:01.0000000 | 秒の小数部の有効桁数を指定しなかった場合、データ型で定義されている各桁が 0 になります。 |
ISO 8601 | '01:01:01.1234567' | 01:01:01.1234567 | ISO 8601 に準拠するには、AM または PM ではなく、24 時間形式を使用します。 |
ISO 8601 | '01:01:01.1234567 +01:01' | 01:01:01.1234567 | 入力ではオプションでタイム ゾーンの差 (TZD) を使えますが、保存はされません。 |
C. date 型と time 型のそれぞれの列に対して時間の文字列リテラルを挿入する
次の表の 1 列目は、2 列目に示した date データ型または time データ型のデータベース テーブル列に挿入する時間の文字列リテラルを示しています。 3 列目は、データベース テーブル列に格納される値を示しています。
挿入する文字列リテラル | 列のデータ型 | 列に格納される値 | 説明 |
---|---|---|---|
'12:12:12.1234567' | time(7) | 12:12:12.1234567 | 秒の小数部の有効桁数が列に指定された値を超えている場合、エラーなしで文字列が切り詰められます。 |
'2007-05-07' | date | NULL | time 値により、INSERT ステートメントが失敗します。 |
'12:12:12' | smalldatetime | 1900-01-01 12:12:00 | 1 秒未満の秒の有効桁数の値によって、INSERT ステートメントが失敗します。 |
'12:12:12.123' | datetime | 1900-01-01 12:12:12.123 | 秒の有効桁数が 3 桁を超えると、INSERT ステートメントが失敗します。 |
'12:12:12.1234567' | datetime2(7) | 1900-01-01 12:12:12.1234567 | 秒の小数部の有効桁数が列に指定された値を超えている場合、エラーなしで文字列が切り詰められます。 |
'12:12:12.1234567' | datetimeoffset(7) | 1900-01-01 12:12:12.1234567 +00:00 | 秒の小数部の有効桁数が列に指定された値を超えている場合、エラーなしで文字列が切り詰められます。 |