TODATETIMEOFFSET (Transact-SQL)

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

Mengembalikan nilai datetimeoffset yang diterjemahkan dari ekspresi datetime2 .

Konvensi sintaks transact-SQL

Sintaksis

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Catatan

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

Argumen

datetime_expression
Adalah ekspresi yang diselesaikan ke nilai datetime2.

Catatan

Ekspresi tidak boleh berjenis teks, ntext, atau gambar karena jenis ini tidak dapat dikonversi secara implisit ke varchar atau nvarchar.

timezoneoffset_expression
Adalah ekspresi yang mewakili offset zona waktu dalam menit (jika bilangan bulat), misalnya -120, atau jam dan menit (jika string), misalnya '+13:00'. Rentangnya adalah +14 hingga -14 (dalam jam). Ekspresi ditafsirkan dalam waktu lokal untuk timezoneoffset_expression yang ditentukan.

Catatan

Jika ekspresi adalah string karakter, maka harus dalam format {+|-}TZH:THM.

Jenis Hasil

datetimeoffset. Presisi pecahan sama dengan argumen datetime_expression .

Contoh

J. Mengubah offset zona waktu tanggal dan waktu saat ini

Contoh berikut mengubah offset zona dari tanggal dan waktu saat ini ke zona -07:00waktu .

DECLARE @todaysDateTime DATETIME2;  
SET @todaysDateTime = GETDATE();  
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');  
-- RETURNS 2019-04-22 16:23:51.7666667 -07:00  

B. Mengubah offset zona waktu dalam menit

Contoh berikut mengubah zona waktu saat ini menjadi -120 menit.

SELECT TODATETIMEOFFSET(SYSDATETIME(), -120)
-- RETURNS: 2019-04-22 11:39:21.6986813 -02:00  

C. Menambahkan offset zona waktu 13 jam

Contoh berikut menambahkan offset zona waktu 13 jam ke tanggal dan waktu.

SELECT TODATETIMEOFFSET(SYSDATETIME(), '+13:00')
-- RETURNS: 2019-04-22 11:39:29.0339301 +13:00

Lihat Juga

CAST dan CONVERT (Transact-SQL)
Tipe dan Fungsi Data Tanggal dan Waktu (Transact-SQL)
PADA ZONA WAKTU (T-SQL)