Menu

timestamp vs timestamptz PostgreSQL (with time zone)

timestamptz menyimpan satu momen waktu dan menampilkannya di zona waktu sesi; timestamp menyimpan waktu jam dinding tanpa zona. Keduanya tidak menyimpan zona yang kamu tulis. Pakai timestamptz untuk hampir semuanya.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

PostgreSQL punya dua tipe timestamp. timestamptz (timestamp with time zone) menyimpan momen yang pasti: dikonversi ke UTC saat input, ditampilkan di zona waktu sesi saat output. timestamp (timestamp without time zone) menyimpan tanggal dan waktu jam dinding tanpa zona. Keduanya tidak menyimpan zona yang kamu tulis. Untuk apa pun yang terjadi pada satu titik waktu, pakai timestamptz.

Input yang sama menghasilkan 2026-03-01 12:00:00 dan 2026-03-01 21:00:00+09. Nilai timestamptz tetap momen yang sama seperti sebelumnya, sekarang ditampilkan dalam waktu Tokyo. Nilai timestamp tidak punya zona untuk dikonversi, jadi tidak bergeser.

Apa yang terjadi pada zona waktu di input

Saat input membawa offset, timestamptz memakainya untuk menentukan momennya. timestamp membuangnya diam-diam:

plain bernilai 2026-03-01 12:00:00, dengan +02 dibuang. with_zone bernilai 2026-03-01 10:00:00+00, momen yang sama dalam UTC. Beginilah waktu bisa meleset beberapa jam: aplikasi mengirim string ISO dengan offset ke kolom timestamp, dan offset-nya hilang.

Kapan memakai masing-masing

KegunaanTipe
Waktu dibuat, diperbarui, dibayar, logintimestamptz
Waktu lokal terjadwal yang mengikuti jam setempat ("pukul 9.00 setiap hari di zona pengguna")timestamp plus kolom nama zona
Hari kalender tanpa waktudate
Lama waktuinterval

Kedua tipe memakai 8 byte dan menyimpan mikrodetik. Atur zona sesi dengan SET TIME ZONE 'Europe/Paris'. Pakai nama zona lengkap, bukan singkatan seperti EST: singkatan adalah offset tetap yang mengabaikan daylight saving.

Konversi antarzona dengan AT TIME ZONE

AT TIME ZONE bekerja dua arah. Pada timestamptz, ia mengembalikan waktu jam dinding di zona itu, sebagai timestamp. Pada timestamp, ia membaca nilainya sebagai waktu lokal di zona itu dan mengembalikan momen timestamptz.

Pukul 12.00 UTC adalah 08:00 di New York pada bulan Juli, dan pukul 9.00 di Paris adalah 07:00 UTC. Pakai bentuk pertama untuk menampilkan waktu di zona pengguna, dan bentuk kedua untuk mengubah waktu lokal yang diketik pengguna menjadi sebuah momen.

Daylight saving dan aritmetika interval

Menambahkan interval '1 day' ke timestamptz mempertahankan jam lokal yang sama saat terjadi pergantian daylight saving. Menambahkan '24 hours' menambah jam yang pasti. Di Amerika Serikat, jam dimajukan pada 8 Maret 2026:

Yang pertama menghasilkan 2026-03-08 12:00:00-04, yang kedua 2026-03-08 13:00:00-04. Hasilnya bergantung pada zona waktu sesi, jadi atur secara eksplisit di kode yang melakukan aritmetika tanggal.

Waktu saat ini

now() dan current_timestamp mengembalikan waktu mulai transaksi saat ini sebagai timestamptz, nilai yang sama untuk setiap baris yang disentuh sebuah pernyataan. clock_timestamp() mengembalikan waktu sebenarnya di setiap pemanggilan. current_date mengembalikan date, dan localtimestamp mengembalikan timestamp. Kolom yang umum adalah created_at timestamptz NOT NULL DEFAULT now().

Mengonversi kolom timestamp ke timestamptz

Jika kolom timestamp yang ada menyimpan waktu UTC, konversi dengan USING ... AT TIME ZONE 'UTC', supaya nilainya dibaca sebagai UTC, bukan di zona sesi:

Nilainya sekarang 2026-01-15 09:30:00+01, ditampilkan dalam waktu Berlin. Perubahan ini menulis ulang tabel, jadi jalankan di waktu sepi untuk tabel besar (ALTER TABLE membahas perubahan tipe). Fungsi seperti date_trunc, extract, dan age ada di halaman fungsi tanggal, dan bab tipe date/time memuat format input lengkapnya.

Pertanyaan yang sering diajukan

Apakah timestamptz menyimpan zona waktu di PostgreSQL?

Tidak. Tipe ini mengonversi input ke UTC dan hanya menyimpan momen itu. Zona yang kamu tulis hilang; output ditampilkan sesuai pengaturan TimeZone sesi. Simpan nama zona di kolom text terpisah jika nanti kamu membutuhkannya.

Apa perbedaan now() dan clock_timestamp()?

now() (sama dengan current_timestamp) mengembalikan waktu mulai transaksi saat ini, jadi nilainya tetap sama untuk setiap baris dan pernyataan di dalamnya. clock_timestamp() mengembalikan waktu sebenarnya saat dipanggil dan berubah bahkan di dalam satu pernyataan.

Bagaimana cara mendapatkan tanggal hari ini di PostgreSQL?

current_date mengembalikan tanggal hari ini di zona waktu sesi. now()::date memberi hasil yang sama, dan localtimestamp mengembalikan tanggal dan waktu saat ini sebagai timestamp tanpa zona.

Berapa banyak ruang yang dipakai timestamp di PostgreSQL?

8 byte untuk timestamp maupun timestamptz, dengan resolusi mikrodetik. date memakai 4 byte.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai