SYSUTCDATETIME (Transact-SQL)

Aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsEndpoint de analítica SQL en Microsoft FabricAlmacén en Microsoft FabricBase de datos SQL en Microsoft Fabric

La SYSUTCDATETIME función Transact-SQL (T-SQL) devuelve un valor datetime2 que contiene la fecha y hora del ordenador en el que se ejecuta la instancia de SQL Server. La fecha y hora se devuelven como una hora universal coordinada (UTC). La especificación de precisión de fracción de segundo tiene un intervalo de 1 a 7 dígitos. La precisión predeterminada es 7 dígitos.

Ten en cuenta:

  • SYSDATETIME y SYSUTCDATETIME tienen más precisión de fracciones de segundos que GETDATE y GETUTCDATE.

  • SYSDATETIMEOFFSET incluye el desplazamiento de zona horaria del sistema.

  • SYSDATETIME, SYSUTCDATETIMEy SYSDATETIMEOFFSET se pueden asignar a una variable de cualquiera de los tipos de fecha y hora.

Para obtener información general sobre todos los tipos y funciones de datos de fecha y hora de Transact-SQL, consulte Tipos y funciones de datos de fecha y hora.

Convenciones de sintaxis de Transact-SQL

Syntax

SYSUTCDATETIME ( )

Tipos de retorno

datetime2

Remarks

Transact-SQL instrucciones pueden hacer referencia a SYSUTCDATETIME cualquier lugar donde puedan hacer referencia a una expresión datetime2 .

SYSUTCDATETIME es una función no determinista. Las vistas y expresiones que hacen referencia a esta función en una columna no se pueden indexar.

Note

SQL Server obtiene los valores de fecha y hora mediante la GetSystemTimeAsFileTime() API de Windows. La exactitud depende del hardware del equipo y de la versión de Windows en las que la instancia de SQL Server se esté ejecutando. La precisión de esta API se fija en 100 nanosegundos. La precisión se puede determinar mediante la GetSystemTimeAdjustment() API de Windows.

Examples

En los ejemplos siguientes se usan las seis funciones del sistema de SQL Server que devuelven la fecha y hora actuales para devolver la fecha, la hora o ambas. Los valores se devuelven en serie; por consiguiente, sus fracciones de segundo podrían ser diferentes.

A. Mostrar los formatos devueltos por las funciones de fecha y hora

En el ejemplo siguiente se muestran los distintos formatos que devuelven las funciones de fecha y hora.

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

Este es el conjunto de resultados.

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. Conversión de fecha y hora a fecha

En el ejemplo siguiente se muestra cómo convertir valores de fecha y hora al tipo de datos date .

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

Este es el conjunto de resultados.

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. Conversión de valores de fecha y hora a hora

En el ejemplo siguiente se muestra cómo convertir valores de fecha y hora en el tipo de datos de hora .

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

Este es el conjunto de resultados.

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

Contenido relacionado

  • Last updated on