SYSUTCDATETIME (Transact-SQL)
Retorna um valor datetime2 que contém a data e a hora do computador no qual a instância do SQL Server está sendo executada. A data e hora é retornada como hora UTC (Tempo Universal Coordenado). A especificação de precisão de segundo fracionária tem um intervalo de 1 a 7 dígitos. A precisão padrão é 7 dígitos.
Observação |
---|
SYSDATETIME e SYSUTCDATE têm mais precisão de segundos fracionários que GETDATE e GETUTCDATE. SYSDATETIMEOFFSET inclui o deslocamento de fuso horário do sistema. SYSDATETIME, SYSUTCDATE e SYSDATETIMEOFFSET podem ser atribuídos a uma variável de qualquer um dos tipos de data e hora. |
Para obter uma visão geral de todos os tipos de dados e funções de data e hora do Transact-SQL, consulte Tipos de dados e funções de data e hora.
Convenções da sintaxe Transact-SQL
Sintaxe
SYSUTCDATETIME ( )
Tipo de retorno
datetime2
Comentários
Instruções Transact-SQL podem fazer referência a SYSUTCDATETIME em qualquer lugar onde possam fazer referência a uma expressão datetime2.
SYSUTCDATETIME é uma função não determinística. Exibições e expressões que fazem referência a essa função em uma coluna não podem ser indexadas.
Observação |
---|
O SQL Server 2012 obtém os valores de data e hora usando a API GetSystemTimeAsFileTime() do Windows. A precisão depende do hardware do computador e da versão do Windows no qual a instância do SQL Server está sendo executada. A precisão desta API está fixada em 100 nanosegundos. A precisão pode ser determinada usando a API GetSystemTimeAdjustment() do Windows. |
Exemplos
Os exemplos a seguir usam as seis funções de sistema do SQL Server que retornam a data e a hora atuais para retornar a data, a hora ou ambas. Os valores são retornados em série; portanto, seus segundos fracionários podem ser diferentes.
A.Mostrando os formatos que são retornados pelas funções de data e hora
O exemplo a seguir mostra os diferentes formatos que são retornados pelas funções de data e hora.
SELECT SYSDATETIME() AS SYSDATETIME
,SYSDATETIMEOFFSET() AS SYSDATETIMEOFFSET
,SYSUTCDATETIME() AS SYSUTCDATETIME
,CURRENT_TIMESTAMP AS CURRENT_TIMESTAMP
,GETDATE() AS GETDATE
,GETUTCDATE() AS GETUTCDATE;
Aqui está o 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.Convertendo data e hora em data
O exemplo a seguir mostra como converter valores de data e hora em date.
SELECT CONVERT (date, SYSDATETIME())
,CONVERT (date, SYSDATETIMEOFFSET())
,CONVERT (date, SYSUTCDATETIME())
,CONVERT (date, CURRENT_TIMESTAMP)
,CONVERT (date, GETDATE())
,CONVERT (date, GETUTCDATE());
Aqui está o conjunto de resultados.
2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30
C.Convertendo valores de data e hora em hora
O exemplo a seguir mostra como converter valores de data e hora em time.
DECLARE @DATETIME DATETIME = GetDate();
DECLARE @TIME TIME
SELECT @TIME = CONVERT(time, @DATETIME)
SELECT @TIME AS 'Time', @DATETIME AS 'Date Time'
Aqui está o conjunto de resultados.
Time Date Time
13:49:33.6330000 2009-04-22 13:49:33.633