SYSUTCDATETIME (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsMicrosoft Fabric'te SQL analitiği uç noktasıMicrosoft Fabric'te DepoMicrosoft Fabric'te SQL veritabanı

Transact-SQL (T-SQL) fonksiyonu, SYSUTCDATETIME SQL Server örneğinin çalıştığı bilgisayarın tarih ve saatini içeren bir datetime2 değerini döndürür. Tarih ve saat UTC saati (Eşgüdümlü Evrensel Saat) olarak döndürülür. Kesirli ikinci duyarlık belirtimi 1 ile 7 basamak arasında bir aralığa sahiptir. Varsayılan duyarlık 7 basamaktır.

Aşağıdakileri dikkate alın:

  • SYSDATETIME ve SYSUTCDATETIME değerinden daha fazla kesirli saniye duyarlığı GETDATEGETUTCDATEvardır.

  • SYSDATETIMEOFFSET sistem saat dilimi uzaklığını içerir.

  • SYSDATETIME, SYSUTCDATETIMEve SYSDATETIMEOFFSET tarih ve saat türlerinden herhangi birinin değişkenine atanabilir.

Tüm Transact-SQL tarih ve saat veri türlerine ve işlevlerine genel bakış için bkz. Tarih ve saat veri türleri ve işlevleri.

Transact-SQL söz dizimi kuralları

Syntax

SYSUTCDATETIME ( )

Dönüş türleri

datetime2

Remarks

Transact-SQL deyimleri SYSUTCDATETIME ifadesine başvurabilecekleri her yere başvurabilir.

SYSUTCDATETIME belirsiz bir işlevdir. Bir sütunda bu işleve başvuran görünümler ve ifadeler dizine alınamaz.

Note

SQL Server, Windows API'sini kullanarak GetSystemTimeAsFileTime() tarih ve saat değerlerini alır. Doğruluk, SQL Server örneğinin çalıştığı bilgisayar donanımına ve Windows sürümüne bağlıdır. Bu API'nin duyarlığı 100 nanosaniye olarak sabittir. Doğruluk, Windows API'sini GetSystemTimeAdjustment() kullanarak belirlenebilir.

Examples

Aşağıdaki örneklerde, tarih, saat veya her ikisini birden döndürmek için geçerli tarih ve saati döndüren altı SQL Server sistem işlevi kullanılır. Değerler seri olarak döndürülür; Bu nedenle, kesirli saniyeleri farklı olabilir.

A. Tarih ve saat işlevleri tarafından döndürülen biçimleri gösterme

Aşağıdaki örnekte tarih ve saat işlevleri tarafından döndürülen farklı biçimler gösterilmektedir.

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

Sonuç kümesi aşağıdadır.

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. Tarih ve saati tarihe dönüştürme

Aşağıdaki örnekte tarih ve saat değerlerinin tarih veri türüne nasıl dönüştürüldüğü gösterilmektedir.

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

Sonuç kümesi aşağıdadır.

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. Tarih ve saat değerlerini saate dönüştürme

Aşağıdaki örnekte tarih ve saat değerlerini saat veri türüne nasıl dönüştürdüğünüz gösterilmektedir.

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

Sonuç kümesi aşağıdadır.

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

İlgili içerik

  • Son güncelleştirme: