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.

Descrição de time

* 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.

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.

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.

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';

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.

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.

Consulte Também

CAST e CONVERT (Transact-SQL)