Artigo
04/01/2012

hora (Transact-SQL)

Define uma hora de um dia. A hora se encontra sem reconhecimento de fuso horário e se baseia em um relógio de 24 horas.

Para obter uma visão geral de todos os tipos de dados e funções de data e hora do Transact-SQL, consulte Funções Date e Time (Transact-SQL). Para obter informações e exemplos comuns aos tipos de dados e funções de data e hora, consulte Usando dados de data e hora.

time Description

Propriedade	Valor
Sintaxe	time [ (fractional second precision) ]
Uso	DECLARE @MyTime time(7) CREATE TABLE Table1 ( Column1 time(7) )
fractional seconds precision	Especifica o número de dígitos para a parte fracionária dos segundos. Pode ser um inteiro de 0 a 7. A precisão fracionária padrão é de 7 (100 ns).
Uso	DECLARE @MyTime time(7) CREATE TABLE Table1 ( Column1 time(7) )
Formato literal de cadeia de caracteres padrão (usado para cliente de nível inferior)	hh:mm:ss[.nnnnnnn] Para obter mais informações, consulte a seção Compatibilidade com versões anteriores para clientes de nível inferior em Usando dados de data e hora.
Intervalo	00:00:00.0000000 a 23:59:59.9999999
Intervalos de elementos	hh são dois dígitos, variando de 0 a 23, que representam a hora. mm são dois dígitos, variando de 0 a 59, que representam o minuto. ss são dois dígitos, variando de 0 a 59, que representam o segundo. n* é de zero a sete dígitos, variando de 0 a 9999999, que representa as frações de segundo.
Comprimento de caractere	Mínimo de 8 posições (hh:mm:ss) até um máximo de 16 (hh:mm:ss.nnnnnnn)
Precisão, escala (usuário especifica apenas escala)	Escala especificadaResultado (precisão, escala)Comprimento de coluna (bytes)Fracionário segundos precisão time (16,7)57 time(0) (8,0)30-2 time(1) (10,1)30-2 time(2) (11,2)30-2 time(3) (12,3)43-4 time(4) (13,4)43-4 time(5) (14,5)55-7 time(6) (15,6)55-7 time(7) (16,7)55-7
Tamanho de armazenamento	5 bytes, fixos, são o padrão com o padrão de precisão de frações de segundo de 100 ns.
Exatidão	100 nanossegundos
Valor padrão	00:00:00 Este valor é usado para a parte da hora anexada para conversão implícita de date em datetime2 ou datetimeoffset.
Precisão de frações de segundo definida pelo usuário	Sim
Reconhecimento e preservação do deslocamento de fuso horário	Não
Reconhecimento de horário de verão	Não

Há suporte para formatos de literais de cadeia de caracteres para hora

A tabela a seguir mostra os formatos de literais de cadeia de caracteres válidos para o tipo de dados time.

SQL Server	Descrição
hh:mm[:ss][:segundos fracionários][AM][PM] hh:mm[:ss][.segundos fracionários][AM][PM] hhAM[PM] hh AM [PM]	O valor de hora 0 representa a hora depois da meia-noite (AM), independentemente de AM ter sido especificado. PM não pode ser especificado quando a hora é igual a 0. Os valores de hora de 01 a 11 representam as horas antes do meio-dia, se não for especificado AM nem PM. Os valores também representam as horas antes do meio-dia quando AM é especificado. Os valores representarão as horas depois do meio-dia, se PM for especificado. O valor de hora 12 representa a hora que começa ao meio-dia, se não for especificado AM nem PM. Se AM for especificado, o valor representará a hora que começa à meia-noite. Se PM for especificado, o valor representará a hora que começa ao meio-dia. Por exemplo, 12:01 é 1 minuto depois do meio-dia, assim como 12:01 PM; e 12:01 AM é 1 minuto depois da meia-noite. Especificar 12:01 AM é igual a especificar 00:01 ou 00:01 AM. Os valores de hora de 13 a 23 representam as horas após o meio-dia, se AM nem PM estiverem especificados. Os valores também representam as horas após o meio-dia quando PM é especificado. AM não pode ser especificado quando o valor de hora é de 13 a 23. Um valor de hora de 24 não é válido. Para representar meia-noite, use 12:00 AM ou 00:00. Os milissegundos podem ser precedidos por ou dois-pontos (:) ou ponto (.). Se for usado dois-pontos, o número significa milésimos de segundo. Se for usado um ponto, um único dígito significa décimos de segundo, dois dígitos significa centésimos de segundo e três dígitos, milésimos de segundo. Por exemplo, 12:30:20:1 indica vinte e um milésimos de segundo após 12:30; 12:30:20.1 indica vinte e um décimos de segundo após 12:30.

hh:mm[:ss][:segundos fracionários][AM][PM]

hh:mm[:ss][.segundos fracionários][AM][PM]

hhAM[PM]

hh AM [PM]

O valor de hora 0 representa a hora depois da meia-noite (AM), independentemente de AM ter sido especificado. PM não pode ser especificado quando a hora é igual a 0.

Os valores de hora de 01 a 11 representam as horas antes do meio-dia, se não for especificado AM nem PM. Os valores também representam as horas antes do meio-dia quando AM é especificado. Os valores representarão as horas depois do meio-dia, se PM for especificado.

O valor de hora 12 representa a hora que começa ao meio-dia, se não for especificado AM nem PM. Se AM for especificado, o valor representará a hora que começa à meia-noite. Se PM for especificado, o valor representará a hora que começa ao meio-dia. Por exemplo, 12:01 é 1 minuto depois do meio-dia, assim como 12:01 PM; e 12:01 AM é 1 minuto depois da meia-noite. Especificar 12:01 AM é igual a especificar 00:01 ou 00:01 AM.

Os valores de hora de 13 a 23 representam as horas após o meio-dia, se AM nem PM estiverem especificados. Os valores também representam as horas após o meio-dia quando PM é especificado. AM não pode ser especificado quando o valor de hora é de 13 a 23.

Um valor de hora de 24 não é válido. Para representar meia-noite, use 12:00 AM ou 00:00.

Os milissegundos podem ser precedidos por ou dois-pontos (:) ou ponto (.). Se for usado dois-pontos, o número significa milésimos de segundo. Se for usado um ponto, um único dígito significa décimos de segundo, dois dígitos significa centésimos de segundo e três dígitos, milésimos de segundo. Por exemplo, 12:30:20:1 indica vinte e um milésimos de segundo após 12:30; 12:30:20.1 indica vinte e um décimos de segundo após 12:30.

ISO 8601	Notas
hh:mm:ss hh:mm[:ss][.segundos fracionários]	hh são dois dígitos, variando de 0 a 14, que representam o número de horas no deslocamento de fuso horário. mm são dois dígitos, variando de 0 a 59, que representam o número de minutos adicionais no deslocamento de fuso horário.

hh:mm:ss

hh:mm[:ss][.segundos fracionários]

hh são dois dígitos, variando de 0 a 14, que representam o número de horas no deslocamento de fuso horário.
mm são dois dígitos, variando de 0 a 59, que representam o número de minutos adicionais no deslocamento de fuso horário.

ODBC	Notas
{t 'hh:mm:ss[.segundos fracionários]'}	Específico à API ODBC. Funções em SQL Server 2008 como em SQL Server 2005.

{t 'hh:mm:ss[.segundos fracionários]'}

Específico à API ODBC.

Funções em SQL Server 2008 como em SQL Server 2005.

Conformidade de hora com os padrões ANSI e ISO 8601

Não há suporte para o uso da hora 24 para representar a meia-noite e saltar o segundo em 59, como definido pelo ISO 8601 (5.3.2 e 5.3), para a manutenção de compatibilidade retroativa e consistência com os tipos de data e hora existentes. Eles não estão definidos pelo padrão 2003 do SQL.

O formato de literais de cadeia de caracteres padrão (usado para cliente de nível inferior) se alinhará com o formulário padrão do SQL, que está definido como hh:mm:ss[.nnnnnnn]. Esse formato se assemelha à definição do ISO 8601 para TIME que exclui segundos fracionários.

Exemplos

A. Comparando tipos de dados de data e hora

O exemplo a seguir compara os resultados da conversão de uma cadeia de caracteres para cada tipo de dados date e time.

SELECT 
     CAST('2007-05-08 12:35:29. 1234567 +12:15' AS time(7)) AS 'time' 
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS date) AS 'date' 
    ,CAST('2007-05-08 12:35:29.123' AS smalldatetime) AS 
        'smalldatetime' 
    ,CAST('2007-05-08 12:35:29.123' AS datetime) AS 'datetime' 
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS datetime2(7)) AS 
        'datetime2'
    ,CAST('2007-05-08 12:35:29.1234567 +12:15' AS datetimeoffset(7)) AS 
        'datetimeoffset';

Tipo de dados	Saída
time	12:35:29. 1234567
date	2007-05-08
smalldatetime	2007-05-08 12:35:00
datetime	2007-05-08 12:35:29.123
datetime2	2007-05-08 12:35:29. 1234567
datetimeoffset	2007-05-08 12:35:29.1234567 +12:15

B. Inserindo literais de cadeia de caracteres válidos na coluna time(7)

A tabela a seguir lista os diferentes literais de cadeia de caracteres que podem ser inseridos em uma coluna de tipo de dados time(7) com os valores que, então, são armazenados nessa coluna.

Tipo de formato de literal de cadeia de caracteres	Literal de cadeia de caracteres inserido	valor de time(7) que é armazenado	Descrição
SQL Server	'01:01:01:123AM'	01:01:01.1230000	Quando dois pontos (:) precedem a precisão de frações de segundo, a escala não pode exceder três posições ou ocorrerá um erro.
SQL Server	'01:01:01.1234567 AM'	01:01:01.1234567	Quando AM ou PM é especificado, a hora é armazenada em formato de 24 horas sem o literal AM ou PM
SQL Server	'01:01:01.1234567 PM'	13:01:01.1234567	Quando AM ou PM é especificado, a hora é armazenada em formato de 24 horas sem o literal AM ou PM
SQL Server	'01:01:01.1234567PM'	13:01:01.1234567	Um espaço antes de AM ou PM é opcional.
SQL Server	'01AM'	01:00:00.0000000	Quando só a hora é especificada, todos os outros valores são 0.
SQL Server	'01 AM'	01:00:00.0000000	Um espaço antes de AM ou PM é opcional.
SQL Server	'01:01:01'	01:01:01.0000000	Quando a precisão das frações de segundo não é especificada, cada posição definida pelo tipo de dados é 0.
ISO 8601	'01:01:01.1234567'	01:01:01.1234567	Para estar de acordo com o ISO 8601, use o formato de 24 horas, e não AM ou PM.
ISO 8601	'01:01:01.1234567 +01:01'	01:01:01.1234567	A diferença de fuso horário (TZD) opcional é permitida na entrada, mas não é armazenada.

C. Inserindo o literal de cadeia de caracteres nas colunas de cada tipo de data e hora

Na tabela a seguir, a primeira coluna mostra um literal de cadeia de caracteres de hora a ser inserido em uma coluna da tabela do banco de dados do tipo de dados de data e hora exibido na segunda coluna. A terceira coluna mostra o valor que será armazenado na coluna da tabela do banco de dados.

Literal de cadeia de caracteres inserido	Tipo de dados da coluna	Valor que é armazenado na coluna	Descrição
'12:12:12.1234567'	time(7)	12:12:12.1234567	Se a precisão das frações de segundo exceder o valor especificado para a coluna, a cadeia de caracteres será truncada sem erro.
'2007-05-07'	date	NULL	Qualquer valor de hora fará a instrução INSERT falhar.
'12:12:12'	smalldatetime	1900-01-01 12:12:00	Qualquer valor de precisão de fração de segundo fará a instrução INSERT falhar.
'12:12:12.123'	datetime	1900-01-01 12:12:12.123	Qualquer precisão de segundo mais extensa do que três posições fará a instrução INSERT falhar.
'12:12:12.1234567'	datetime2(7)	1900-01-01 12:12:12.1234567	Se a precisão das frações de segundo exceder o valor especificado para a coluna, a cadeia de caracteres será truncada sem erro.
'12:12:12.1234567'	datetimeoffset(7)	1900-01-01 12:12:12.1234567 +00:00	Se a precisão das frações de segundo exceder o valor especificado para a coluna, a cadeia de caracteres será truncada sem erro.

Partilhar via

hora (Transact-SQL)

time Description

Há suporte para formatos de literais de cadeia de caracteres para hora

Conformidade de hora com os padrões ANSI e ISO 8601

Exemplos

A. Comparando tipos de dados de data e hora

B. Inserindo literais de cadeia de caracteres válidos na coluna time(7)

C. Inserindo o literal de cadeia de caracteres nas colunas de cada tipo de data e hora

Consulte também

Referência

Conceitos

Recursos adicionais