time (Transact-SQL)
Berlaku untuk:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric
Mendefinisikan waktu dalam sehari. Waktunya tanpa kesadaran zona waktu dan didasarkan pada jam 24 jam.
Catatan
Informasi informatica disediakan untuk pelanggan PDW yang menggunakan Koneksi or Informatica.
Deskripsi waktu
| Properti | Nilai |
|---|---|
| Sintaks | time [ (skala kedua pecahan) ] |
| Penggunaan | DEKLARASIKAN waktu @MyTime (7) CREATE TABLE Table1 ( Column1 time(7) ) |
| skala detik pecahan | Menentukan jumlah digit untuk bagian pecahan detik. Ini bisa menjadi bilangan bulat dari 0 hingga 7. Untuk Informatica, ini bisa menjadi bilangan bulat dari 0 hingga 3. Skala pecahan default adalah 7 (100n). Di Microsoft Fabric, ini bisa menjadi bilangan bulat dari 0 hingga 6, tanpa default. Presisi harus ditentukan dalam Microsoft Fabric. |
| Format literal string default (digunakan untuk klien tingkat bawah) |
hh:mm:ss[.nnnnnnn] untuk Informatica) Untuk informasi selengkapnya, lihat bagian Kompatibilitas Mundur untuk Klien Tingkat Bawah. |
| Rentang | 00:00:00.0000000 hingga 23:59:59.9999999 (00:00:00.000 hingga 23:59:59.999 untuk Informatica) |
| Rentang elemen | hh adalah dua digit, mulai dari 0 hingga 23, yang mewakili jam. mm adalah dua digit, mulai dari 0 hingga 59, yang mewakili menit. ss adalah dua digit, mulai dari 0 hingga 59, yang mewakili yang kedua. n* adalah nol hingga tujuh digit, mulai dari 0 hingga 9999999, yang mewakili detik pecahan. Untuk Informatica, n* adalah nol hingga tiga digit, mulai dari 0 hingga 999. |
| Panjang karakter | 8 posisi minimum (hh:mm:ss) hingga maksimum 16 (hh:mm:ss.nnnnnnn). Untuk Informatica, maksimum adalah 12 (hh:mm:ss.nnn). |
| Presisi, skala (pengguna hanya menentukan skala) |
Lihat tabel di bawah. |
| Ukuran penyimpanan | 5 byte, tetap, adalah default dengan default presisi kedua pecahan 100ns. Di Informatica, defaultnya adalah 4 byte, tetap, dengan default presisi kedua pecahan 1ms. |
| Akurasi | 100 nanodetik (1 milidetik di Informatica) |
| Nilai default | 00:00:00 Nilai ini digunakan untuk bagian waktu yang ditambahkan untuk konversi implisit dari tanggal ke datetime2 atau datetimeoffset. |
| Presisi kedua pecahan yang ditentukan pengguna | Ya |
| Sadar dan pelestarian offset zona waktu | No |
| Kesadaran musim panas | No |
| Skala yang ditentukan | Hasil (presisi, skala) | Panjang kolom (byte) | Pecahan seconds presisi |
|---|---|---|---|
| time | (16,7) [(12,3) di Informatica] | 5 (4 di Informatica) | 7 (3 di Informatica) |
| 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 |
* Tidak didukung di Informatica.
+ Tidak didukung di Microsoft Fabric.
Format Literal String yang Didukung untuk waktu
Tabel berikut ini memperlihatkan format literal string yang valid untuk jenis data waktu .
| Server SQL | Deskripsi |
|---|---|
| hh:mm[:ss][:detik pecahan][AM][PM] hh:mm[:ss][.fractional seconds][AM][PM] hhAM[PM] hh AM[PM] |
Nilai jam 0 mewakili jam setelah tengah malam (AM), terlepas dari apakah AM ditentukan. PM tidak dapat ditentukan ketika jam sama dengan 0. Nilai jam dari 01 hingga 11 mewakili jam sebelum siang jika am maupun PM tidak ditentukan. Nilai mewakili jam sebelum siang hari ketika AM ditentukan. Nilai mewakili jam setelah siang hari jika PM ditentukan. Nilai jam 12 menunjukkan jam yang dimulai pada siang hari jika AM maupun PM tidak ditentukan. Jika AM ditentukan, nilai mewakili jam yang dimulai pada tengah malam. Jika PM ditentukan, nilai mewakili jam yang dimulai pada siang hari. Misalnya, 12:01 adalah 1 menit setelah siang, seperti pukul 12:01 PM; dan 12:01 am adalah satu menit setelah tengah malam. Menentukan 12:01 SAMA dengan menentukan 00:01 atau 00:01 AM. Nilai jam dari 13 hingga 23 mewakili jam setelah siang jika AM atau PM tidak ditentukan. Nilai juga mewakili jam setelah siang hari ketika PM ditentukan. AM tidak dapat ditentukan ketika nilai jam adalah dari 13 hingga 23. Nilai jam 24 tidak valid. Untuk mewakili tengah malam, gunakan pukul 12.00 atau 00.00. Milidetik dapat didahului dengan titik dua (:) atau titik (.). Jika titik dua digunakan, angka tersebut berarti seribu detik. Jika periode digunakan, satu digit berarti persepuluh detik, dua digit berarti seratus detik, dan tiga digit berarti seribu detik. Misalnya, 12:30:20:1 menunjukkan 20 dan seribu detik lewat 12:30; 12:30:20.1 menunjukkan 20 dan sesepuluh detik lewat 12:30. |
| ISO 8601 | Catatan |
|---|---|
| hh:mm:ss hh:mm[:ss][.fractional seconds] |
hh adalah dua digit, mulai dari 0 hingga 23, yang mewakili jumlah jam dalam offset zona waktu. mm adalah dua digit, mulai dari 0 hingga 59, yang mewakili jumlah menit tambahan dalam offset zona waktu. |
| ODBC | Catatan |
|---|---|
| {t 'hh:mm:ss[.fractional seconds]'} | ODBC API spesifik. |
Kepatuhan terhadap Standar ANSI dan ISO 8601
Menggunakan jam 24 untuk mewakili tengah malam dan lompatan kedua lebih dari 59 seperti yang didefinisikan oleh ISO 8601 (5.3.2 dan 5.3) tidak didukung untuk kompatibel mundur dan konsisten dengan jenis tanggal dan waktu yang ada.
Format literal string default (digunakan untuk klien tingkat bawah) akan selaras dengan bentuk standar SQL, yang didefinisikan sebagai hh:mm:ss[.nnnnnnn]. Format ini menyerupan definisi ISO 8601 untuk TIME tidak termasuk detik fraksional.
Kompatibilitas Mundur untuk Klien Tingkat Bawah
Beberapa klien tingkat bawah tidak mendukung jenis data waktu, tanggal, tanggalwaktu2, dan datetimeoffset. Tabel berikut menunjukkan pemetaan jenis antara instans tingkat atas SQL Server dan klien tingkat bawah.
| Tipe data SQL Server | Format literal string default diteruskan ke klien tingkat bawah | ODBC tingkat bawah | OLEDB tingkat bawah | JDBC tingkat bawah | SQLCLIENT tingkat bawah |
|---|---|---|---|---|---|
| time | hh:mm:ss[.nnnnnnn] | SQL_WVARCHAR atau SQL_VARCHAR | DBTYPE_WSTRor DBTYPE_STR | Java.sql.String | String atau SqString |
| date | YYYY-MM-DD | SQL_WVARCHAR atau SQL_VARCHAR | DBTYPE_WSTRor DBTYPE_STR | Java.sql.String | String atau SqString |
| datetime2 | YYYY-MM-DD hh:mm:ss[.nnnnnnn] | SQL_WVARCHAR atau SQL_VARCHAR | DBTYPE_WSTRor DBTYPE_STR | Java.sql.String | String atau SqString |
| datetimeoffset | YYYY-MM-DD hh:mm:ss[.nnnnnnn] [+|-]hh:mm | SQL_WVARCHAR atau SQL_VARCHAR | DBTYPE_WSTRor DBTYPE_STR | Java.sql.String | String atau SqString |
Mengonversi Data Tanggal dan Waktu
Saat Anda mengonversi ke jenis data tanggal dan waktu, SQL Server menolak semua nilai yang tidak dapat dikenali sebagai tanggal atau waktu. Untuk informasi tentang menggunakan fungsi CAST dan CONVERT dengan data tanggal dan waktu, lihat CAST dan CONVERT (Transact-SQL)
Mengonversi Jenis Data waktu(n) ke Jenis Tanggal dan Waktu Lainnya
Bagian ini menjelaskan apa yang terjadi ketika jenis data waktu dikonversi ke jenis data tanggal dan waktu lainnya.
Ketika konversi adalah ke waktu(n), jam, menit, dan detik disalin. Ketika presisi tujuan kurang dari presisi sumber, detik pecahan dibulatkan ke atas agar sesuai dengan presisi tujuan. Contoh berikut menunjukkan hasil konversi nilai menjadi time(4)time(3) nilai.
DECLARE @timeFrom TIME(4) = '12:34:54.1237';
DECLARE @timeTo TIME(3) = @timeFrom;
SELECT @timeTo AS 'time(3)', @timeFrom AS 'time(4)';
Berikut adalah hasil yang ditetapkan.
time(3) time(4)
------------ -------------
12:34:54.124 12:34:54.1237
Jika konversi hingga saat ini, konversi gagal, dan pesan kesalahan 206 dinaikkan: "Jenis operand bentrok: tanggal tidak kompatibel dengan waktu".
Saat konversi adalah nilai tanggalwaktu, jam, menit, dan detik disalin; dan komponen tanggal diatur ke '1900-01-01'. Ketika presisi detik pecahan dari nilai waktu(n) lebih besar dari tiga digit, hasil tanggalwaktu akan dipotong. Kode berikut menunjukkan hasil konversi nilai menjadi time(4)datetime nilai.
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime DATETIME = @time;
SELECT @time AS '@time', @datetime AS '@datetime';
Berikut adalah hasil yang ditetapkan.
@time @datetime
------------- -----------------------
12:15:04.1237 1900-01-01 12:15:04.123
Saat konversi adalah smalldatetime, tanggal diatur ke '1900-01-01', dan nilai jam dan menit dibulatkan ke atas. Detik dan detik pecahan diatur ke 0. Kode berikut menunjukkan hasil konversi nilai menjadi time(4)smalldatetime nilai.
Perlihatkan pembulatan nilai menit:
DECLARE @time TIME(4) = '12:15:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
Berikut adalah hasil yang ditetapkan.
@time @smalldatetime
---------------- -----------------------
12:15:59.9999 1900-01-01 12:16:00--
Perlihatkan pembulatan ke atas dari nilai jam:
DECLARE @time TIME(4) = '12:59:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
Berikut adalah hasil yang ditetapkan.
@time @smalldatetime
---------------- -----------------------
12:59:59.9999 1900-01-01 13:00:00
Jika konversi ke datetimeoffset(n), tanggal diatur ke '1900-01-01', dan waktu disalin. Offset zona waktu diatur ke +00:00. Ketika presisi detik pecahan dari nilai waktu(n) lebih besar dari presisi nilai datetimeoffset(n), nilai dibulatkan ke atas agar pas. Contoh berikut menunjukkan hasil konversi nilai menjadi time(4)datetimeoffset(3) jenis.
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetimeoffset DATETIMEOFFSET(3) = @time;
SELECT @time AS '@time', @datetimeoffset AS '@datetimeoffset';
Berikut adalah hasil yang ditetapkan.
@time @datetimeoffset
------------- ------------------------------
12:15:04.1237 1900-01-01 12:15:04.124 +00:00
Saat mengonversi ke datetime2(n), tanggal diatur ke '1900-01-01', komponen waktu disalin, dan offset zona waktu diatur ke 00:00. Ketika presisi detik pecahan dari nilai datetime2(n) lebih besar dari nilai time(n), nilai akan dibulatkan ke atas agar pas. Contoh berikut menunjukkan hasil konversi nilai menjadi time(4)datetime2(2) nilai.
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime2 DATETIME2(3) = @time;
SELECT @datetime2 AS '@datetime2', @time AS '@time';
Berikut adalah hasil yang ditetapkan.
@datetime2 @time
----------------------- -------------
1900-01-01 12:15:04.124 12:15:04.1237
Mengonversi Literal String ke waktu(n)
Konversi dari literal string ke jenis tanggal dan waktu diizinkan jika semua bagian string dalam format yang valid. Jika tidak, kesalahan runtime muncul. Konversi implisit atau konversi eksplisit yang tidak menentukan gaya, dari jenis tanggal dan waktu hingga literal string akan berada dalam format default sesi saat ini. Tabel berikut ini memperlihatkan aturan untuk mengonversi string harfiah ke jenis data waktu .
| String input literal | Aturan Konversi |
|---|---|
| TANGGAL ODBC | Literal string ODBC dipetakan ke jenis data tanggalwaktu . Setiap operasi penugasan dari LITERAL ODBC DATETIME ke dalam jenis waktuakan menyebabkan konversi implisit antara tanggalwaktu dan jenis ini seperti yang didefinisikan oleh aturan konversi. |
| WAKTU ODBC | Lihat aturan TANGGAL ODBC di atas. |
| TANGGALWAKTU ODBC | Lihat aturan TANGGAL ODBC di atas. |
| HANYA TANGGAL | Nilai default disediakan. |
| Hanya WAKTU | Trivial |
| TimeZONE saja | Nilai default disediakan. |
| TANGGAL + WAKTU | Bagian TIME dari string input digunakan. |
| DATE + TIMEZONE | Tidak diperbolehkan. |
| TIME + TIMEZONE | Bagian TIME dari string input digunakan. |
| TANGGAL + WAKTU + ZONA WAKTU | Bagian WAKTU dari DATETIME lokal akan digunakan. |
Contoh
J. Membandingkan Tipe Data tanggal dan waktu
Contoh berikut membandingkan hasil transmisi string dengan setiap jenis data tanggal dan waktu .
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';
| Jenis data | Hasil |
|---|---|
| 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. Menyisipkan Literal String Waktu yang Valid ke dalam Kolom waktu(7)
Tabel berikut mencantumkan literal string berbeda yang dapat disisipkan ke dalam kolom waktu jenis data(7) dengan nilai yang kemudian disimpan di kolom tersebut.
| Jenis format literal string | String literal yang disisipkan | nilai time(7) yang disimpan | Deskripsi |
|---|---|---|---|
| Server SQL | '01:01:01:123SAM' | 01:01:01.1230000 | Ketika titik dua (:) datang sebelum presisi detik pecahan, skala tidak boleh melebihi tiga posisi atau kesalahan akan muncul. |
| Server SQL | '01:01:01.1234567 AM' | 01:01:01.1234567 | Ketika AM atau PM ditentukan, waktu disimpan dalam format 24 jam tanpa AM atau PM harfiah |
| Server SQL | '01:01:01.1234567 PM' | 13:01:01.1234567 | Ketika AM atau PM ditentukan, waktu disimpan dalam format 24 jam tanpa AM atau PM harfiah |
| Server SQL | '01:01:01.1234567PM' | 13:01:01.1234567 | Spasi sebelum AM atau PM bersifat opsional. |
| Server SQL | '01AM' | 01:00:00.0000000 | Ketika hanya jam yang ditentukan, semua nilai lainnya adalah 0. |
| Server SQL | '01 AM' | 01:00:00.0000000 | Spasi sebelum AM atau PM bersifat opsional. |
| Server SQL | '01:01:01' | 01:01:01.0000000 | Ketika presisi detik pecahan tidak ditentukan, setiap posisi yang ditentukan oleh jenis data adalah 0. |
| ISO 8601 | '01:01:01.1234567' | 01:01:01.1234567 | Untuk mematuhi ISO 8601, gunakan format 24 jam, bukan AM atau PM. |
| ISO 8601 | '01:01:01.1234567 +01:01' | 01:01:01.1234567 | Perbedaan zona waktu opsional (TZD) diizinkan dalam input tetapi tidak disimpan. |
C. Menyisipkan String Waktu Literal ke Dalam Kolom Dari Setiap Tanggal dan Waktu Jenis Tanggal
Dalam tabel berikut, kolom pertama memperlihatkan string waktu harfiah untuk disisipkan ke dalam kolom tabel database dari tipe data tanggal atau waktu yang diperlihatkan di kolom kedua. Kolom ketiga memperlihatkan nilai yang akan disimpan di kolom tabel database.
| String literal yang disisipkan | Jenis data kolom | Nilai yang disimpan dalam kolom | Deskripsi |
|---|---|---|---|
| '12:12:12.1234567' | time(7) | 12:12:12.1234567 | Jika presisi detik pecahan melebihi nilai yang ditentukan untuk kolom, string akan dipotong tanpa kesalahan. |
| '2007-05-07' | date | NULL | Setiap kali nilai akan menyebabkan pernyataan INSERT gagal. |
| '12:12:12' | smalldatetime | 1900-01-01 12:12:00 | Nilai presisi detik pecahan apa pun akan menyebabkan pernyataan INSERT gagal. |
| '12:12:12.123' | datetime | 1900-01-01 12:12:12.123 | Presisi kedua apa pun yang lebih panjang dari tiga posisi akan menyebabkan pernyataan INSERT gagal. |
| '12:12:12.1234567' | datetime2(7) | 1900-01-01 12:12:12.1234567 | Jika presisi detik pecahan melebihi nilai yang ditentukan untuk kolom, string akan dipotong tanpa kesalahan. |
| '12:12:12.1234567' | datetimeoffset(7) | 1900-01-01 12:12:12.1234567 +00:00 | Jika presisi detik pecahan melebihi nilai yang ditentukan untuk kolom, string akan dipotong tanpa kesalahan. |
Lihat Juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk