En PostgreSQL, el localtime
La función devuelve la hora local del día, sin el desplazamiento de la zona horaria.
Si necesita la compensación de la zona horaria, use current_time()
en su lugar.
Sintaxis
Puede usarlo de cualquiera de las siguientes maneras:
localtime
localtime(x)
Donde x
es un parámetro de precisión opcional, que hace que el resultado se redondee a x
número de dígitos fraccionarios en el campo de segundos.
Sin un parámetro de precisión (la primera sintaxis), el resultado se da con la precisión total disponible.
Ejemplo:precisión total
Aquí hay un ejemplo básico para demostrar un resultado usando la precisión disponible completa.
SELECT localtime;
Resultado:
15:50:25.314626
Ejemplo:precisión específica
Aquí hay un ejemplo para demostrar cómo especificar la precisión.
SELECT localtime(0);
Resultado:
15:50:44
En este ejemplo, especifiqué una precisión de cero, lo que significa que no se devolvieron fracciones de segundo.
Aquí hay otro ejemplo donde especifico un número de segundos fraccionarios.
SELECT localtime(3);
Resultado:
15:50:59.039
Transacciones
La hora real se basa en la hora de inicio de la transacción actual. Por lo tanto, no cambia a medida que avanza la transacción.
Esto permite que una sola transacción tenga una noción consistente de la hora "actual", de modo que múltiples modificaciones dentro de la misma transacción lleven la misma marca de tiempo.
Aquí hay un ejemplo que demuestra esto.
BEGIN;
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
COMMIT;
Aquí está el resultado completo de mi terminal al ejecutar esa transacción en psql:
postgres=# BEGIN; BEGIN postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (1 row) postgres=# COMMIT; COMMIT
Los tres valores de tiempo son idénticos, aunque pg_sleep()
se utilizó la función para retrasar la ejecución entre cada declaración dentro de la transacción.
Esto contrasta con statement_timestamp()
que hace cambiar con cada afirmación.
Múltiples llamadas dentro de una declaración
Tampoco cambia a medida que avanza la declaración.
\x
SELECT
localtime,
pg_sleep(5),
localtime,
pg_sleep(5),
localtime;
Resultado (usando salida vertical):
localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559
Los tres valores de tiempo son idénticos, aunque pg_sleep()
La función se usó para retrasar la ejecución entre cada llamada a localtime
.
Esto contrasta con clock_timestamp()
función, que hace cambia a medida que avanza a través de la declaración.
Por cierto, utilicé la salida vertical (también conocida como salida expandida) para que los resultados fueran un poco más compactos.
Puede alternar la salida expandida en psql usando \x
.