Perfis de data e hora

AWS Clean Rooms suporta as seguintes funções de data e hora:

Tópicos

• Resumo das funções de data e hora
• Funções de data e hora em transações
• Operador + (Concatenação)
• Função ADD_MONTHS
• Função CONVERT_TIMEZONE
• Função CURRENT_DATE
• Função DATEADD
• Função DATEDIFF
• Função DATE_PART
• Função DATE_TRUNC
• Função EXTRACT
• Função do GETDATE
• Função SYSDATE
• Função TIMEOFDAY
• Função TO_TIMESTAMP
• Partes da data para funções de data ou de timestamp

Resumo das funções de data e hora

A tabela a seguir fornece um resumo das funções de data e hora que são usadas em AWS Clean Rooms.

Função	Sintaxe	Retornos
Operador + (Concatenação) Concatena uma data para uma hora em ambos os lados do símbolo + e retorna um TIMESTAMP ou TIMESTAMPTZ.	date + time	TIMESTAMP ou TIMESTAMPZ
ADD_MONTHS Adiciona o número especificado de meses a uma data ou timestamp.	ADD_MONTHS ({date|timestamp}, integer)	TIMESTAMP
Função CURRENT_DATE Retorna uma data no fuso horário da sessão atual (UTC por padrão) para o início da transação atual.	CURRENT_DATE	DATE
DATEADD Incrementa uma data ou hora com um intervalo especificado.	DATEADD (datepart, interval, {date|time|timetz|timestamp})	TIMESTAMP ou TIME ou TIMETZ
DATEDIFF Retorna a diferença entre as duas datas ou horas para determinada parte da data, tal como um dia ou mês.	DATEDIFF (datepart, {date|time|timetz|timestamp}, {date|time|timetz|timestamp})	BIGINT
DATE_PART Extrai um valor da parte de data de uma data ou hora.	DATE_PART (datepart, {date|timestamp})	DOUBLE
DATE_TRUNC Trunca um timestamp com base em uma parte da data.	DATE_TRUNC ('datepart', timestamp)	TIMESTAMP
EXTRACT Extrai uma parte da data ou hora de um timestamp, timestamptz, time ou timetz.	EXTRACT (datepart FROM source)	INTEGER or DOUBLE
Função do GETDATE Retorna a atual data e hora no fuso horário da sessão atual (UTC por padrão). Os parênteses são necessários.	GETDATE()	TIMESTAMP
SYSDATE Retorna a data e hora em UTC para o início da transação atual.	SYSDATE	TIMESTAMP
TIMEOFDAY Retorna o atual dia da semana, data e hora no fuso horário da sessão atual (UTC por padrão) com um valor de string.	TIMEOFDAY()	VARCHAR
TO_TIMESTAMP Retorna um timestamp com fuso horário para o formato de timestamp e fuso horário especificados.	TO_TIMESTAMP ('timestamp', 'format')	TIMESTAMPTZ

nota

Segundos intercalados não são considerados em cálculos tempo decorrido.

Funções de data e hora em transações

Quando você executa as seguintes funções em um bloco de transação (BEGIN… END), a função retorna a data ou hora de início da transação atual, não o início da instrução atual.

• SYSDATE

• TIMESTAMP

• CURRENT_DATE

As seguintes funções sempre retornam a data ou hora de início da atual instrução, mesmo quando estiverem em um bloco de transação.

• GETDATE

• TIMEOFDAY

Operador + (Concatenação)

Concatena literais numéricos, literais de sequência de caracteres e/ou literais de data e hora e intervalo. Eles estão em ambos os lados do símbolo + e retornam tipos diferentes com base nas entradas em cada lado do símbolo +.

Sintaxe

numeric + string

date + time

date + timetz

A ordem dos argumentos pode ser invertida.

Argumentos

literais numéricos

Literais ou constantes que representam números podem ser números inteiros ou de ponto flutuante.

literais de string

Cadeias de caracteres, cadeias de caracteres ou constantes de caracteres

data

Uma coluna DATE ou expressão que é convertida implicitamente em um arquivo DATE.

time

Uma coluna TIME ou expressão que é convertida implicitamente em um arquivo TIME.

timetz

Uma coluna TIMETZ ou expressão que é convertida implicitamente em um arquivo TIMETZ.

Exemplo

A tabela de exemplo TIME_TEST a seguir possui uma coluna TIME_VAL (tipo TIME) com três valores inseridos.

select date '2000-01-02' + time_val as ts from time_test;