SYSUTCDATETIME (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Retorna um valor de datetime2 que contém a data e a hora do computador no qual a instância de SQL Server está sendo executada. A data e hora são retornadas 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 SYSUTCDATETIME têm mais precisão de segundos fracionários que GETDATE e GETUTCDATE. SYSDATETIMEOFFSET inclui o deslocamento de fuso horário do sistema. SYSDATETIME, SYSUTCDATETIME 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, confira Tipos de dados e funções de data e hora.

Convenções de sintaxe de Transact-SQL

Sintaxe

SYSUTCDATETIME ( )

Tipo de retorno

datetime2

Comentários

As instruções Transact-SQL podem fazer referência a SYSUTCDATETIME em qualquer lugar em que 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

SQL Server obtém os valores de data e hora usando a API do Windows GetSystemTimeAsFileTime(). 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 do Windows GetSystemTimeAdjustment().

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()];

Veja a seguir 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());

Veja a seguir 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'

Veja a seguir o conjunto de resultados.

Time             Date Time  
13:49:33.6330000 2009-04-22 13:49:33.633

Confira também

CAST e CONVERT (Transact-SQL)
tipos de dados e funções de data e hora (Transact-SQL)
AT TIME ZONE (Transact-SQL)