Función STATEMENT_TIMESTAMP en PostgreSQL

La función STATEMENT_TIMESTAMP en PostgreSQL es una herramienta práctica que devuelve la fecha y hora exacta, incluyendo el desplazamiento de la zona horaria, en el momento en que se ejecuta una instrucción. A diferencia de otras funciones temporales, STATEMENT_TIMESTAMP ofrece un valor preciso asociado a la ejecución de una consulta específica, lo que la convierte en una opción ideal para registrar eventos o depurar procesos en tiempo real.

Esta función no acepta argumentos, lo que facilita su uso en consultas donde necesitas capturar el momento exacto de la ejecución. Es parte del conjunto de funciones de fecha en PostgreSQL, diseñado para proporcionar un control granular sobre datos temporales en tus aplicaciones y bases de datos.

En este artículo, primero te mostraré la sintaxis básica de STATEMENT_TIMESTAMP y luego repasaremos ejemplos prácticos para que entiendas cómo implementarla eficazmente en distintos escenarios.

Para más información, puedes consultar la documentación oficial de la función STATEMENT_TIMESTAMP en PostgreSQL.

Sintaxis

La sintaxis para utilizar la función STATEMENT_TIMESTAMP en PostgreSQL es la siguiente:

STATEMENT_TIMESTAMP();

Ejemplo

SELECT STATEMENT_TIMESTAMP();

STATEMENT_TIMESTAMP en transacciones

Si utilizas la función STATEMENT_TIMESTAMP en PostgreSQL dentro de transacciones, esta devolverá la fecha y hora exactas del momento en que se ejecuta cada instrucción. A diferencia de otras funciones temporales, su valor cambiará con cada ejecución, reflejando con precisión el tiempo actual de cada consulta individual dentro de la transacción.

BEGIN;
SELECT STATEMENT_TIMESTAMP();
SELECT pg_sleep(3);
SELECT STATEMENT_TIMESTAMP();
COMMIT;