hora (Transact-SQL)
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric
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.
Observação
As informações do Informatica são fornecidas para clientes do PDW que usam o Conector do Informatica.
Descrição de time
| Propriedade | Valor |
|---|---|
| Sintaxe | time [ (escala de segundos fracionários) ] |
| Uso | DECLARE @MyTime time(7) CREATE TABLE Table1 ( Column1 time(7) ) |
| escala de segundos fracionários | Especifica o número de dígitos para a parte fracionária dos segundos. Pode ser um inteiro de 0 a 7. Para o Informatica, isso pode ser um inteiro de 0 a 3. A escala fracionária padrão é de 7 (100ns). No Microsoft Fabric, isso pode ser um inteiro de 0 a 6, sem padrão. A precisão deve ser especificada no Microsoft Fabric. |
| Formato literal de cadeia de caracteres padrão (usado para cliente de nível inferior) |
hh:mm:ss[.nnnnnnn] para o Informatica) Para saber mais, confira a seção Compatibilidade com versões anteriores para clientes de nível inferior. |
| Intervalo | 00:00:00.0000000 a 23:59:59.9999999 (00:00:00.000 a 23:59:59.999 para o Informatica) |
| 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. Para o Informatica, n* é de zero a três dígitos, variando de 0 a 999. |
| Comprimento de caracteres | Mínimo de 8 posições (hh:mm:ss) até um máximo de 16 (hh:mm:ss.nnnnnnn). Para o Informatica, o máximo é de 12 (hh:mm:ss.nnn). |
| Precisão, escala (usuário especifica apenas escala) |
Veja a tabela abaixo. |
| 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. No Informatica, o padrão é de 4 bytes, fixos, com o padrão de precisão de segundos fracionários de 1ms. |
| Precisão | 100 nanossegundos (1 milissegundo no Informatica) |
| Valor padrão | 00:00:00 Esse valor é usado para a parte de hora acrescentada para conversão implícita de date em datetime2 ou datetimeoffset. |
| Precisão de segundo fracionário definida pelo usuário | Sim |
| Preservação e reconhecimento de deslocamento de fuso horário | Não |
| Reconhecimento de horário de verão | Não |
| Escala especificada | Resultado (precisão, escala) | Comprimento de coluna (bytes) | Fracionário segundos precisão |
|---|---|---|---|
| time | (16.7) [(12.3) no Informatica] | 5 (4 no Informatica) | 7 (3 no Informatica) |
| time(0) | (8.0) | 3 | 0-2 |
| time(1) | (10.1) | 3 | 0-2 |
| time(2) | (11.2) | 3 | 0-2 |
| time(3) | (12.3) | 4 | 3-4 |
| time(4)* | (13.4) | 4 | 3-4 |
| time(5)* | (14.5) | 5 | 5-7 |
| time(6)* | (15.6) | 5 | 5-7 |
| time(7)* + | (16,7) | 5 | 5-7 |
* Não compatível com o Informatica.
+ Não compatível com o Microsoft Fabric.
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. |
| ISO 8601 | Observações |
|---|---|
| hh:mm:ss hh:mm[:ss][.segundos fracionários] |
hh equivale a dois dígitos, variando de 0 a 23, 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 | Observações |
|---|---|
| {t 'hh:mm:ss[.segundos fracionários]'} | Específico à API ODBC. |
Conformidade 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.
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.
Compatibilidade com versões anteriores de clientes de nível inferior
Alguns clientes de nível inferior não dão suporte aos tipos de dados time, date, datetime2 e datetimeoffset. A tabela a seguir mostra o mapeamento de tipos entre uma instância de nível superior do SQL Server e clientes de nível inferior.
| Tipos de dados do SQL Server | Formato de literal de cadeia de caracteres padrão passado ao cliente de nível inferior | ODBC de nível inferior | OLEDB de nível inferior | JDBC de nível inferior | SQLCLIENT de nível inferior |
|---|---|---|---|---|---|
| time | hh:mm:ss[.nnnnnnn] | SQL_WVARCHAR ou SQL_VARCHAR | DBTYPE_WSTR ou DBTYPE_STR | Java.sql.String | Cadeia de caracteres ou SqString |
| date | AAAA-MM-DD | SQL_WVARCHAR ou SQL_VARCHAR | DBTYPE_WSTR ou DBTYPE_STR | Java.sql.String | Cadeia de caracteres ou SqString |
| datetime2 | AAAA-MM-DD hh:mm:ss[.nnnnnnn] | SQL_WVARCHAR ou SQL_VARCHAR | DBTYPE_WSTR ou DBTYPE_STR | Java.sql.String | Cadeia de caracteres ou SqString |
| datetimeoffset | AAAA-MM-DD hh:mm:ss[.nnnnnnn] [+|-]hh:mm | SQL_WVARCHAR ou SQL_VARCHAR | DBTYPE_WSTR ou DBTYPE_STR | Java.sql.String | Cadeia de caracteres ou SqString |
Convertendo dados date e time
Ao fazer a conversão em tipos de dados de data e hora, o SQL Server rejeita todos os valores que não pode reconhecer como datas ou horas. Para obter informações sobre como usar as funções CAST e CONVERT com os dados de data e hora, confira CAST e CONVERT (Transact-SQL)
Convertendo tipo de dados time(n) em outros tipos de data e hora
A tabela a seguir descreve o que ocorre quando um tipo de dados time é convertido em outros tipos de dados de data e hora.
Quando a conversão é feita em time(n), a hora, os minutos e os segundos são copiados. Quando a precisão de destino é menor que a precisão da origem, os segundos fracionários são arredondados para cima, de forma a se ajustarem à precisão de destino. O exemplo a seguir mostra os resultados da conversão de um valor time(4) em um valor time(3).
DECLARE @timeFrom TIME(4) = '12:34:54.1237';
DECLARE @timeTo TIME(3) = @timeFrom;
SELECT @timeTo AS 'time(3)', @timeFrom AS 'time(4)';
Veja a seguir o conjunto de resultados.
time(3) time(4)
------------ -------------
12:34:54.124 12:34:54.1237
Se a conversão for para data, a conversão falhará e a mensagem de erro 206 será gerada: "Conflito no tipo de operando: a data é incompatível com a hora".
Quando a conversão é feita em datetime, os valores de hora, minuto e segundo são copiados e o componente de data é definido como '1900-01-01'. Quando a precisão de segundos fracionários do valor de time(n) for maior que três dígitos, o resultado de datetime será truncado. O código a seguir mostra os resultados da conversão de um valor time(4) em um valor datetime.
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime DATETIME = @time;
SELECT @time AS '@time', @datetime AS '@datetime';
Veja a seguir o conjunto de resultados.
@time @datetime
------------- -----------------------
12:15:04.1237 1900-01-01 12:15:04.123
Quando a conversão é feita em smalldatetime, a data é definida como '1900-01-01' e os valores de hora e minuto são arredondados. Os segundos e as frações de segundo são definidos como 0. O código a seguir mostra os resultados da conversão de um valor time(4) em um valor smalldatetime.
Mostrar arredondamento do valor do minuto:
DECLARE @time TIME(4) = '12:15:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
Veja a seguir o conjunto de resultados.
@time @smalldatetime
---------------- -----------------------
12:15:59.9999 1900-01-01 12:16:00--
Mostrar arredondamento do valor da hora:
DECLARE @time TIME(4) = '12:59:59.9999';
DECLARE @smalldatetime SMALLDATETIME = @time;
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
Veja a seguir o conjunto de resultados.
@time @smalldatetime
---------------- -----------------------
12:59:59.9999 1900-01-01 13:00:00
Se a conversão é feita em datetimeoffset(n), a data é definida como '1900-01-01' e a hora é copiada. O deslocamento de fuso horário é definido como +00:00. Quando a precisão de segundos fracionários do valor de time(n) é maior que a precisão do valor de datetimeoffset(n), o valor é arredondado para cima, de forma a ser ajustado. O exemplo a seguir mostra os resultados da conversão de um valor time(4) em um tipo de valor datetimeoffset(3).
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetimeoffset DATETIMEOFFSET(3) = @time;
SELECT @time AS '@time', @datetimeoffset AS '@datetimeoffset';
Veja a seguir o conjunto de resultados.
@time @datetimeoffset
------------- ------------------------------
12:15:04.1237 1900-01-01 12:15:04.124 +00:00
Ao fazer a conversão em datetime2(n), a data é definida como '1900-01-01', o componente de hora é copiado e o deslocamento de fuso horário é definido como 00:00. Quando a precisão de segundos fracionários do valor de datetime2(n) for maior que de time(n), o valor será arredondado, de forma a ser ajustado. O exemplo a seguir mostra os resultados da conversão de um valor time(4) em um valor datetime2(2).
DECLARE @time TIME(4) = '12:15:04.1237';
DECLARE @datetime2 DATETIME2(3) = @time;
SELECT @datetime2 AS '@datetime2', @time AS '@time';
Veja a seguir o conjunto de resultados.
@datetime2 @time
----------------------- -------------
1900-01-01 12:15:04.124 12:15:04.1237
Convertendo literais de cadeia de caracteres em time(n)
Serão permitidas conversões de literais de cadeia de caracteres para tipos de data e hora se todas as partes da cadeia de caracteres estiverem em formatos válidos. Caso contrário, será gerado um erro de runtime. As conversões implícitas ou explícitas que não especificam um estilo, de tipos de data e hora em literais de cadeia de caracteres estarão no formato padrão da sessão atual. A tabela a seguir mostra as regras de conversão de uma literal de cadeia de caracteres no tipo de dados time.
| Literal de cadeia de caracteres de entrada | Regra de conversão |
|---|---|
| ODBC DATE | Os literais de cadeia de caracteres do ODBC são mapeados para o tipo de dados datetime. Qualquer operação de atribuição de literais de ODBC DATETIME em tipos time causará uma conversão implícita entre datetime e esse tipo, conforme definido pelas regras de conversão. |
| ODBC TIME | Consulte a regra ODBC DATE acima. |
| ODBC DATETIME | Consulte a regra ODBC DATE acima. |
| Apenas DATE | Os valores padrão são fornecidos. |
| Apenas TIME | Trivial |
| Apenas TIMEZONE | Os valores padrão são fornecidos. |
| DATE + TIME | A parte TIME da cadeia de caracteres de entrada é usada. |
| DATE + TIMEZONE | Não permitido. |
| TIME + TIMEZONE | A parte TIME da cadeia de caracteres de entrada é usada. |
| DATE + TIME + TIMEZONE | A parte TIME de DATETIME local será usada. |
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 em 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, em seguida, 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' | 1: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 | '01:00:00' | 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' | 1: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' | 1: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 de 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 | NULO | 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. |