Fungsi TIMEZONE

TIMEZONE mengembalikan timestamp untuk zona waktu tertentu dan nilai timestamp.

Untuk informasi dan contoh tentang cara mengatur zona waktu, lihattimezone.

Untuk informasi dan contoh tentang cara mengonversi zona waktu, lihatCONVERT_TIMEZONE.

Sintaks

TIMEZONE('timezone', { timestamp | timestamptz })

Argumen

zona waktu

Zona waktu untuk nilai kembali. Zona waktu dapat ditentukan sebagai nama zona waktu (seperti 'Africa/Kampala' atau'Singapore') atau sebagai singkatan zona waktu (seperti 'UTC' atau'PDT'). Untuk melihat daftar nama zona waktu yang didukung, jalankan perintah berikut.

select pg_timezone_names();

Untuk melihat daftar singkatan zona waktu yang didukung, jalankan perintah berikut.

select pg_timezone_abbrevs();

Untuk informasi selengkapnya dan contoh tambahan, lihat Catatan penggunaan zona waktu.

stempel waktu | timestamptz

Ekspresi yang menghasilkan tipe TIMESTAMP atau TIMESTAMPTZ, atau nilai yang secara implisit dapat dipaksa ke stempel waktu atau stempel waktu dengan zona waktu.

Jenis pengembalian

TIMESTAMPTZ bila digunakan dengan ekspresi TIMESTAMP.

TIMESTAMP bila digunakan dengan ekspresi TIMESTAMPTZ.

Contoh-contoh

Berikut ini mengembalikan timestamp untuk zona waktu UTC menggunakan timestamp 2008-06-17 09:44:54 dari zona waktu PST.

SELECT TIMEZONE('PST', '2008-06-17 09:44:54');

timezone
-----------------------
2008-06-17 17:44:54+00

Berikut ini mengembalikan timestamp untuk zona waktu PST menggunakan timestamp dengan zona waktu UTC. 2008-06-17 09:44:54+00

SELECT TIMEZONE('PST', timestamptz('2008-06-17 09:44:54+00'));

timezone
-----------------------
2008-06-17 01:44:54