SYSUTCDATETIME (Transact-SQL)
Devuelve un valor datetime2 que contiene la fecha y hora del equipo en el que la instancia de SQL Server se está ejecutando. 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.
[!NOTA]
SYSDATETIME y SYSUTCDATE tienen más precisión de fracciones de segundo que GETDATE y GETUTCDATE. SYSDATETIMEOFFSET incluye el desplazamiento de zona horaria del sistema. SYSDATETIME, SYSUTCDATE y SYSDATETIMEOFFSET pueden asignarse a una variable de cualquier tipo de fecha y hora.
Para ver información de todos los tipos de datos y funciones de fecha y hora de Transact-SQL, vea Funciones y tipos de datos de fecha y hora. Para obtener información y ejemplos comunes a los tipos de datos y funciones de fecha y hora, vea Usar datos de fecha y hora.
Sintaxis
SYSUTCDATETIME ( )
Tipo devuelto
datetime2
Notas
Las instrucciones Transact-SQL pueden hacer referencia a SYSUTCDATETIME en cualquier punto desde el que puedan hacer referencia a una expresión datetime2.
SYSUTCDATETIME es una función no determinista. Las vistas y las expresiones que hacen referencia a esta función en una columna no se pueden indizar.
[!NOTA]
SQL Server 2008 obtiene los valores de fecha y hora utilizando la API de Windows GetSystemTimeAsFileTime(). 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 API de Windows GetSystemTimeAdjustment().
Ejemplos
Los ejemplos siguientes usan las seis funciones de 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 que devuelven 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() AS SYSDATETIME
,SYSDATETIMEOFFSET() AS SYSDATETIMEOFFSET
,SYSUTCDATETIME() AS SYSUTCDATETIME
,CURRENT_TIMESTAMP AS CURRENT_TIMESTAMP
,GETDATE() AS GETDATE
,GETUTCDATE() AS GETUTCDATE;
Éste es el conjunto de resultados.
SYSDATETIME() 2007-04-30 13:10:02.0474381
SYSDATETIMEOFFSET()2007-04-30 13:10:02.0474381 -07:00
SYSUTCDATETIME() 2007-04-30 20:10:02.0474381
CURRENT_TIMESTAMP 2007-04-30 13:10:02.047
GETDATE() 2007-04-30 13:10:02.047
GETUTCDATE() 2007-04-30 20:10:02.047
B. Convertir valores de fecha y hora en date
En el ejemplo siguiente se muestra cómo convertir los valores de fecha y hora en date.
SELECT CONVERT (date, SYSDATETIME())
,CONVERT (date, SYSDATETIMEOFFSET())
,CONVERT (date, SYSUTCDATETIME())
,CONVERT (date, CURRENT_TIMESTAMP)
,CONVERT (date, GETDATE())
,CONVERT (date, GETUTCDATE());
Éste es el conjunto de resultados.
2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30
C. Convertir valores de fecha y hora en time
En el ejemplo siguiente se muestra cómo convertir los valores de fecha y hora en time.
SELECT CONVERT (time, SYSDATETIME()) AS SYSDATETIME()
,CONVERT (time, SYSDATETIMEOFFSET()) AS SYSDATETIMEOFFSET()
,CONVERT (time, SYSUTCDATETIME()) AS SYSUTCDATETIME()
,CONVERT (time, CURRENT_TIMESTAMP) AS CURRENT_TIMESTAMP
,CONVERT (time, GETDATE()) AS GETDATE()
,CONVERT (time, GETUTCDATE()) AS GETUTCDATE();
Éste es el conjunto de resultados.
SYSDATETIME() 13:18:45.3490361
SYSDATETIMEOFFSET()13:18:45.3490361
SYSUTCDATETIME() 20:18:45.3490361
CURRENT_TIMESTAMP 13:18:45.3470000
GETDATE() 13:18:45.3470000
GETUTCDATE() 20:18:45.3470000
Vea también