TIMEFROMPARTS (transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Mengembalikan nilai waktu untuk waktu yang ditentukan dan dengan presisi yang ditentukan.

Konvensi sintaks transact-SQL

Sintaksis

TIMEFROMPARTS ( hour, minute, seconds, fractions, precision )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

jam
Ekspresi bilangan bulat menentukan jam.

menit
Ekspresi bilangan bulat yang menentukan menit.

seconds
Ekspresi bilangan bulat yang menentukan detik.

Pecahan
Ekspresi bilangan bulat yang menentukan pecahan.

Presisi
Bilangan bulat literal yang menentukan presisi nilai waktu yang akan dikembalikan.

Jenis Kembalian

time(presisi)

Keterangan

TIMEROMPARTS mengembalikan nilai waktu yang diinisialisasi sepenuhnya. Jika argumen tidak valid, maka kesalahan dimunculkan. Jika salah satu parameter null, null dikembalikan. Namun, jika argumen presisi null, maka kesalahan dimunculkan.

Argumen pecahan tergantung pada argumen presisi . Misalnya, jika presisi adalah 7, maka setiap pecahan mewakili 100 nanodetik; jika presisi adalah 3, maka setiap pecahan mewakili milidetik. Jika nilai presisi adalah nol, maka nilai pecahan juga harus nol; jika tidak, kesalahan dimunculkan.

Fungsi ini dapat di-remote ke server SQL Server 2012 (11.x) dan yang lebih tinggi. Ini tidak dapat di-remote ke server yang memiliki versi yang lebih rendah dari SQL Server 2012 (11.x).

Contoh

J. Contoh sederhana tanpa pecahan detik

SELECT TIMEFROMPARTS ( 23, 59, 59, 0, 0 ) AS Result;

Berikut adalah hasil yang ditetapkan.

Result  
--------------------  
23:59:59.0000000  
  
(1 row(s) affected)

B. Contoh dengan pecahan detik

Contoh berikut menunjukkan penggunaan pecahan dan parameter presisi:

  1. Ketika pecahan memiliki nilai 5 dan presisi memiliki nilai 1, maka nilai pecahan mewakili 5/10 detik.

  2. Ketika pecahan memiliki nilai 50 dan presisi memiliki nilai 2, maka nilai pecahan mewakili 50/100 detik.

  3. Ketika pecahan memiliki nilai 500 dan presisi memiliki nilai 3, maka nilai pecahan mewakili 500/1000 detik.

SELECT TIMEFROMPARTS ( 14, 23, 44, 5, 1 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 50, 2 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 500, 3 );  
GO

Berikut adalah hasil yang ditetapkan.

----------------  
14:23:44.5  
  
(1 row(s) affected)  
  
----------------  
14:23:44.50  
  
(1 row(s) affected)  
  
----------------  
14:23:44.500  
  
(1 row(s) affected)