Partager via

SYSUTCDATETIME (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison d’analytique SQL dans Microsoft FabricEntrepôt dans Microsoft FabricBase de données SQL dans Microsoft Fabric

Renvoie une valeur datetime2 qui contient la date et l’heure de l’ordinateur sur lequel l’instance de SQL Server s’exécute. La date et l’heure sont renvoyées sous forme d’heure UTC (temps universel coordonné). La spécification de la précision de la fraction de seconde a une plage de 1 à 7 chiffres. La précision par défaut est de 7 chiffres.

Considérer:

  • SYSDATETIME et SYSUTCDATETIME ont plus de précision de fraction de secondes que GETDATE et GETUTCDATE.

  • SYSDATETIMEOFFSET inclut le décalage de fuseau horaire système.

  • SYSDATETIME, SYSUTCDATETIMEet SYSDATETIMEOFFSET peut être affecté à une variable de n’importe quel type de date et d’heure.

Pour obtenir une vue d’ensemble de toutes les fonctions et types de données de date et d’heure Transact-SQL, consultez les types et fonctions de données date et heure.

Conventions de la syntaxe Transact-SQL

Syntax

SYSUTCDATETIME ( )

Types de retour

datetime2

Remarks

Transact-SQL instructions peuvent faire référence à SYSUTCDATETIME n’importe où elles peuvent faire référence à une expression datetime2 .

SYSUTCDATETIME est une fonction non déterministe. Les vues et expressions qui référencent cette fonction dans une colonne ne peuvent pas être indexées.

Note

SQL Server obtient les valeurs de date et d’heure à l’aide de l’API GetSystemTimeAsFileTime() Windows. La précision dépend des composants matériels de l'ordinateur et de la version de Windows sur laquelle s'exécute l'instance de SQL Server. La précision de cette API est fixée à 100 nanosecondes. La précision peut être déterminée à l’aide de l’API GetSystemTimeAdjustment() Windows.

Examples

Les exemples suivants utilisent les six fonctions système SQL Server qui retournent les date et heure actuelles pour retourner la date, l'heure ou les deux. Les valeurs sont retournées en séries ; par conséquent, leurs fractions de seconde peuvent être différentes.

A. Afficher les formats retournés par les fonctions de date et d’heure

L'exemple suivant illustre les différents formats qui sont retournés par les fonctions de date et d'heure.

SELECT SYSDATETIME() AS [SYSDATETIME()],
       SYSDATETIMEOFFSET() AS [SYSDATETIMEOFFSET()],
       SYSUTCDATETIME() AS [SYSUTCDATETIME()],
       CURRENT_TIMESTAMP AS [CURRENT_TIMESTAMP],
       GETDATE() AS [GETDATE()],
       GETUTCDATE() AS [GETUTCDATE()];

Voici le jeu de résultats.

SYSDATETIME()       2025-10-20 13:10:02.0474381
SYSDATETIMEOFFSET() 2025-10-20 13:10:02.0474381 -07:00
SYSUTCDATETIME()    2025-10-20 20:10:02.0474381
CURRENT_TIMESTAMP   2025-10-20 13:10:02.047
GETDATE()           2025-10-20 13:10:02.047
GETUTCDATE()        2025-10-20 20:10:02.047

B. Convertir la date et l’heure en date

L’exemple suivant montre comment convertir des valeurs de date et d’heure en type de données date .

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

Voici le jeu de résultats.

2025-10-20
2025-10-20
2025-10-20
2025-10-20
2025-10-20
2025-10-20

C. Convertir les valeurs de date et d’heure en heure

L’exemple suivant montre comment convertir des valeurs de date et d’heure en type de données d’heure .

DECLARE @DATETIME AS DATETIME = GetDate();
DECLARE @TIME AS TIME;
SELECT @TIME = CONVERT (TIME, @DATETIME);
SELECT @TIME AS 'Time',
       @DATETIME AS 'Date Time';

Voici le jeu de résultats.

Time             Date Time
13:49:33.6330000 2025-10-20 13:49:33.633

Contenu connexe

  • Last updated on