SYSUTCDATETIME (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsTitik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

Fungsi SYSUTCDATETIME Transact-SQL (T-SQL) mengembalikan nilai datetime2 yang berisi tanggal dan waktu komputer tempat instance SQL Server berjalan. Tanggal dan waktu dikembalikan sebagai waktu UTC (Waktu Universal Terkoordinasi). Spesifikasi presisi kedua pecahan memiliki rentang 1 hingga 7 digit. Presisi default adalah 7 digit.

Pertimbangkan:

  • SYSDATETIME dan SYSUTCDATETIME memiliki lebih banyak presisi detik pecahan daripada GETDATE dan GETUTCDATE.

  • SYSDATETIMEOFFSET termasuk offset zona waktu sistem.

  • SYSDATETIME, SYSUTCDATETIME, dan SYSDATETIMEOFFSET dapat ditetapkan ke variabel dari salah satu jenis tanggal dan waktu.

Untuk gambaran umum semua jenis dan fungsi data tanggal dan waktu Transact-SQL, lihat Jenis dan fungsi data tanggal dan waktu.

Konvensi sintaks transact-SQL

Syntax

SYSUTCDATETIME ( )

Tipe pengembalian

datetime2

Remarks

Transact-SQL pernyataan dapat merujuk ke SYSUTCDATETIME mana saja mereka dapat merujuk ke ekspresi datetime2 .

SYSUTCDATETIME adalah fungsi nondeterministik. Tampilan dan ekspresi yang mereferensikan fungsi ini dalam kolom tidak dapat diindeks.

Note

SQL Server mendapatkan nilai tanggal dan waktu dengan menggunakan GetSystemTimeAsFileTime() Windows API. Akurasi tergantung pada perangkat keras komputer dan versi Windows tempat instans SQL Server berjalan. Presisi API ini diperbaiki pada 100 nanodetik. Akurasi dapat ditentukan dengan menggunakan GetSystemTimeAdjustment() Windows API.

Examples

Contoh berikut menggunakan enam fungsi sistem SQL Server yang mengembalikan tanggal dan waktu saat ini untuk mengembalikan tanggal, waktu, atau keduanya. Nilai dikembalikan dalam seri; oleh karena itu, detik pecahannya mungkin berbeda.

A. Perlihatkan format yang dikembalikan oleh fungsi tanggal dan waktu

Contoh berikut menunjukkan berbagai format yang dikembalikan oleh fungsi tanggal dan waktu.

SELECT SYSDATETIME(),
       SYSDATETIMEOFFSET(),
       SYSUTCDATETIME(),
       CURRENT_TIMESTAMP,
       GETDATE(),
       GETUTCDATE(),
       CURRENT_DATE;

Berikut set hasilnya.

SYSDATETIME()        2026-09-01 16:15:37.7418724
SYSDATETIMEOFFSET()  2026-09-01 16:15:37.7418724 -06:00
SYSUTCDATETIME()     2026-09-01 22:15:37.7418724
CURRENT_TIMESTAMP    2026-09-01 16:15:37.740
GETDATE()            2026-09-01 16:15:37.740
GETUTCDATE()         2026-09-01 22:15:37.740
CURRENT_DATE         2026-09-01

B. Mengonversi tanggal dan waktu ke tanggal

Contoh berikut menunjukkan kepada Anda cara mengonversi nilai tanggal dan waktu ke jenis data tanggal .

SELECT CONVERT (DATE, SYSDATETIME()),
       CONVERT (DATE, SYSDATETIMEOFFSET()),
       CONVERT (DATE, SYSUTCDATETIME()),
       CONVERT (DATE, CURRENT_TIMESTAMP),
       CONVERT (DATE, GETDATE()),
       CONVERT (DATE, GETUTCDATE()),
       CURRENT_DATE;

Berikut set hasilnya.

SYSDATETIME()        2026-09-01
SYSDATETIMEOFFSET()  2026-09-01
SYSUTCDATETIME()     2026-09-01
CURRENT_TIMESTAMP    2026-09-01
GETDATE()            2026-09-01
GETUTCDATE()         2026-09-01
CURRENT_DATE         2026-09-01

C. Mengonversi nilai tanggal dan waktu ke waktu

Contoh berikut menunjukkan kepada Anda cara mengonversi nilai tanggal dan waktu ke jenis data waktu .

SELECT CONVERT (TIME, SYSDATETIME()),
       CONVERT (TIME, SYSDATETIMEOFFSET()),
       CONVERT (TIME, SYSUTCDATETIME()),
       CONVERT (TIME, CURRENT_TIMESTAMP),
       CONVERT (TIME, GETDATE()),
       CONVERT (TIME, GETUTCDATE());

Berikut set hasilnya.

SYSDATETIME()        16:15:37.7418724
SYSDATETIMEOFFSET()  16:15:37.7418724
SYSUTCDATETIME()     22:15:37.7418724
CURRENT_TIMESTAMP    16:15:37.740
GETDATE()            16:15:37.740
GETUTCDATE()         22:15:37.740

Konten terkait

  • Terakhir diperbarui pada