SYSDATETIME (Transact-SQL)

Artigo
03/07/2014

Retorna um valor datetime2(7) que contém a data e a hora do computador no qual a instância de SQL Server está sendo executada.

Dica

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, consulte tipos de dados e funções de data e hora (Transact-SQL).

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

SYSDATETIME ( )

Tipo de retorno

datetime2(7)

Comentários

As instruções Transact-SQL podem se referir a SYSDATETIME em qualquer lugar no qual eles possam fazer referência a uma expressão datetime2(7).

SYSDATETIMET é uma função não determinística. Não é possível indexar exibições e expressões que fazem referência a essa função em uma coluna.

Dica

O SQL Server 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.Obtendo a data e a hora atuais do sistema

SELECT SYSDATETIME()
    ,SYSDATETIMEOFFSET()
    ,SYSUTCDATETIME()
    ,CURRENT_TIMESTAMP
    ,GETDATE()
    ,GETUTCDATE();
/* Returned:
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.Obtendo a data atual do sistema

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

/* All returned 2007-04-30 */

C.Obtendo a hora atual do sistema

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

/* Returned
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
*/

Consulte também

Referência

CAST e CONVERT (Transact-SQL)

tipos de dados e funções de data e hora (Transact-SQL)

Compartilhar via