Funciones de fecha y hora

AWS Clean Rooms admite las siguientes funciones de fecha y hora:

Temas

• Resumen de las funciones de fecha y hora
• Funciones de fecha y hora en transacciones
• + Operador (concatenación)
• Función ADD_MONTHS
• Función CONVERT_TIMEZONE
• Función CURRENT_DATE
• Función DATEADD
• Función DATEDIFF
• Función DATE_PART
• Función DATE_TRUNC
• Función EXTRACT
• Función GETDATE
• Función SYSDATE
• Función TIMEOFDAY
• Función TO_TIMESTAMP
• Partes de fecha para funciones de fecha o marca temporal

Resumen de las funciones de fecha y hora

La siguiente tabla ofrece un resumen de las funciones de fecha y hora que se utilizan en AWS Clean Rooms.

Función	Sintaxis	Devuelve
+ Operador (concatenación) Concatena una fecha a una hora a cada lado del símbolo + y devuelve TIMESTAMP o TIMESTAMPTZ.	date + time	TIMESTAMP o TIMESTAMPZ
ADD_MONTHS Agrega la cantidad de meses especificada a una fecha o marca temporal.	ADD_MONTHS ({date|timestamp}, integer)	TIMESTAMP
Función CURRENT_DATE Devuelve una fecha en la zona horaria de la sesión actual (que es UTC de manera predeterminada) para el comienzo de la transacción actual.	CURRENT_DATE	DATE
DATEADD Aumenta una fecha o una hora según un intervalo especificado.	DATEADD (datepart, interval, {date|time|timetz|timestamp})	TIMESTAMP o TIME o TIMETZ
DATEDIFF Devuelve la diferencia entre dos fechas u horas para una parte de fecha dada, como un día o mes.	DATEDIFF (datepart, {date|time|timetz|timestamp}, {date|time|timetz|timestamp})	BIGINT
DATE_PART Extrae el valor de la parte de una fecha a partir de una fecha u hora.	DATE_PART (datepart, {date|timestamp})	DOUBLE
DATE_TRUNC Trunca una marca temporal en función de una parte de fecha.	DATE_TRUNC ('datepart', timestamp)	TIMESTAMP
EXTRACT Extrae una parte de una fecha o una hora a partir de timestamp, timestamptz, time o timetz.	EXTRACT (parte de fecha FROM origen)	INTEGER or DOUBLE
Función GETDATE Devuelve la fecha y hora actual en la zona horaria de la sesión actual (que es UTC de manera predeterminada). Los paréntesis son obligatorios.	GETDATE()	TIMESTAMP
SYSDATE Devuelve la fecha y hora según la zona horaria UTC para el comienzo de la transacción actual.	SYSDATE	TIMESTAMP
TIMEOFDAY Devuelve el día, la fecha y la hora actuales en la zona horaria de la sesión actual (que es UTC de manera predeterminada) como un valor de cadena.	TIMEOFDAY()	VARCHAR
TO_TIMESTAMP Devuelve una marca temporal con zona horaria para el formato de marca temporal y zona horaria especificado.	TO_TIMESTAMP ('timestamp', 'format')	TIMESTAMPTZ

nota

Los segundos de salto no se consideran en los cálculos de tiempo transcurrido.

Funciones de fecha y hora en transacciones

Cuando se ejecutan las siguientes funciones dentro de un bloque de transacción (BEGIN ... END), la función devuelve la fecha u hora de inicio de la transacción actual, no de la instrucción actual.

• SYSDATE

• TIMESTAMP

• CURRENT_DATE

Las siguientes funciones siempre devuelven la fecha u hora de comienzo de la instrucción actual, incluso cuando se encuentran dentro de un bloque de transacción.

• GETDATE

• TIMEOFDAY

+ Operador (concatenación)

Concatena literales numéricos, literales de cadena y/o literales de fecha y hora e intervalo. Están a ambos lados del símbolo + y devuelven diferentes tipos en función de las entradas a cada lado del símbolo +.

Sintaxis

numeric + string

date + time

date + timetz

El orden de los argumentos se puede invertir.

Argumentos

literales numéricos

Los literales o las constantes que representan números pueden ser enteros o números en coma flotante.

literales de cadena

Cadenas, cadenas de caracteres o constantes de caracteres

date

Una columna DATE o una expresión que, implícitamente, se convierte en un valor DATE.

time

Una columna TIME o una expresión que, implícitamente, se convierte en un valor TIME.

timetz

Una columna TIMETZ o una expresión que, implícitamente, se convierte en un valor TIMETZ.

Ejemplo

La siguiente tabla de ejemplo TIME_TEST tiene una columna TIME_VAL (tipo TIME) con tres valores insertados.

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