hora (Transact-SQL)

  • Artigo

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.

time Description

Propriedade

Value

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

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 de clientes de nível inferior" a seguir.

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 caracteres

Mínimo de 8 posições (hh:mm:ss) até o máximo de 16 (hh:mm:ss. nnnnnnn)

Precisão, escala

(usuário especifica apenas escala)

Escala especificada

Resultado (precisão, escala)

Comprimento de coluna (bytes)

Fracionário

segundos

precisão

time

(16,7)

5

7

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

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.

Precisã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 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

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

Observações

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

Específico à API ODBC.

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

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 2012

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 data e hora data, consulte 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.

Tipo de dados para converter em

Detalhes da conversão

time(n)

A hora, o minuto e os segundos são copiados. Quando a precisão do destino é menor do que a precisão da origem, as frações de segundo são arredondadas para cima de forma a se ajustarem à precisão do 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)';
--Results
--time(3)      time(4)
-------------- -------------
--12:34:54.124 12:34:54.1237
--
--(1 row(s) affected)

date

A conversão falha e a mensagem de erro 206 é gerada: "Conflito no tipo de operando: a data é incompatível com a hora".

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 frações de segundos do valor time(n) é maior do que três dígitos, o resultado datetime é 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';
--Result
--@time         @datetime
--------------- -----------------------
--12:15:04.1237 1900-01-01 12:15:04.123
--
--(1 row(s) affected)

smalldatetime

A data é definida como '1900-01-01' e os valores de hora e minuto são arredondados para cima. 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.

-- Shows rounding up of the minute value.
DECLARE @time time(4) = '12:15:59.9999'; 
DECLARE @smalldatetime smalldatetime= @time;  
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime'; 
--Result
@time            @smalldatetime
---------------- -----------------------
12:15:59.9999    1900-01-01 12:16:00--
--(1 row(s) affected)
-- Shows rounding up of the hour value.
DECLARE @time time(4) = '12:59:59.9999'; 
DECLARE @smalldatetime smalldatetime= @time;  
SELECT @time AS '@time', @smalldatetime AS '@smalldatetime';
@time            @smalldatetime
---------------- -----------------------
12:59:59.9999    1900-01-01 13:00:00
(1 row(s) affected)

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 fracionária dos segundos referente ao valor time(n) é maior do que 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 datetimeoffset(3).

DECLARE @time time(4) = '12:15:04.1237';
DECLARE @datetimeoffset datetimeoffset(3) = @time;
SELECT @time AS '@time', @datetimeoffset AS '@datetimeoffset';
--Result
--@time         @datetimeoffset
--------------- ------------------------------
--12:15:04.1237 1900-01-01 12:15:04.124 +00:00
--
--(1 row(s) affected)

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 frações de segundo do valor datetime2(n) é maior do que time(n), o valor é arredondado para 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';
--Result
--@datetime2              @time
------------------------- -------------
--1900-01-01 12:15:04.124 12:15:04.1237
--
--(1 row(s) affected)

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 tempo de execução. 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 de ODBC são mapeados para o tipo de dados datetime. Qualquer operação de atribuição de literais de ODBC DATETIME em tipos time provocará 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.

Somente DATE

Os valores padrão são fornecidos.

Somente 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 para cada tipo de dados de 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.

Consulte também

Referência

CAST e CONVERT (Transact-SQL)