PostgreSQL'de iki zaman damgası tipi var. timestamptz (timestamp with time zone) kesin bir anı saklar: girişte UTC'ye çevrilir, çıkışta oturumun saat diliminde gösterilir. timestamp (timestamp without time zone) ise saat dilimi olmadan bir tarih ve duvar saati zamanı saklar. Hiçbiri yazdığın dilimi saklamaz. Zamanın belli bir anında olan her şey için timestamptz kullan.
Aynı girdi 2026-03-01 12:00:00 ve 2026-03-01 21:00:00+09 verir. timestamptz değeri öncekiyle aynı andır, sadece artık Tokyo saatiyle gösterilir. timestamp değerinin dönüştürülecek bir dilimi olmadığı için yerinden oynamaz.
Girdideki saat dilimine ne olur
Girdi bir ofset taşıdığında timestamptz anı bulmak için onu kullanır. timestamp ise onu sessizce atar:
plain değeri 2026-03-01 12:00:00 olur, +02 atılır. with_zone değeri 2026-03-01 10:00:00+00 olur, yani UTC'de aynı an. Saatlerin saatlerce kaymasının sebebi budur: bir uygulama ofsetli bir ISO metnini timestamp sütununa gönderir ve ofset kaybolur.
Hangisi ne zaman kullanılır
| Kullanım | Tip |
|---|---|
| Oluşturuldu, güncellendi, ödendi, giriş yaptı | timestamptz |
| Yerel saati izleyen planlı bir yerel zaman ("kullanıcının diliminde her gün 9:00") | timestamp artı bir dilim adı sütunu |
| Saati olmayan bir takvim günü | date |
| Bir süre | interval |
İki tip de 8 bayt kaplar ve mikrosaniye saklar. Oturum dilimini SET TIME ZONE 'Europe/Paris' ile ayarla. EST gibi kısaltmalar değil, tam dilim adları kullan: kısaltma, yaz saatini yok sayan sabit bir ofsettir.
AT TIME ZONE ile dilimler arasında dönüştürme
AT TIME ZONE iki yönde de çalışır. Bir timestamptz üzerinde o dilimdeki duvar saati zamanını bir timestamp olarak döndürür. Bir timestamp üzerinde ise değeri o dilimdeki yerel saat olarak okur ve timestamptz anını döndürür.
Temmuzda UTC öğlen New York'ta 08:00'dir, Paris'te 9:00 ise UTC'de 07:00'dir. Bir zamanı kullanıcının diliminde göstermek için ilk biçimi, kullanıcının yazdığı yerel saati bir ana çevirmek için ikincisini kullan.
Yaz saati ve interval aritmetiği
Bir timestamptz değerine interval '1 day' eklemek, yaz saati değişikliğinde de aynı yerel saati korur. '24 hours' eklemek ise tam saat ekler. ABD'de saatler 8 Mart 2026'da ileri alınıyor:
İlki 2026-03-08 12:00:00-04, ikincisi 2026-03-08 13:00:00-04 verir. Sonuç oturumun saat dilimine bağlıdır, bu yüzden tarih aritmetiği yapan kodda dilimi açıkça ayarla.
Şu anki zaman
now() ve current_timestamp geçerli transaction'ın başlangıç zamanını timestamptz olarak döndürür; bir komutun dokunduğu her satır için aynı değerdir. clock_timestamp() her çağrıda gerçek zamanı döndürür. current_date bir date, localtimestamp ise bir timestamp döndürür. Tipik bir sütun şöyledir: created_at timestamptz NOT NULL DEFAULT now().
Bir timestamp sütununu timestamptz'ye çevirme
Mevcut bir timestamp sütunu UTC zamanları tutuyorsa onu USING ... AT TIME ZONE 'UTC' ile dönüştür; böylece değerler oturumun diliminde değil, UTC olarak okunur:
Değer artık Berlin saatiyle gösterilen 2026-01-15 09:30:00+01. Değişiklik tabloyu yeniden yazar, bu yüzden büyük bir tabloda sakin bir anda çalıştır (tip değişikliklerini ALTER TABLE anlatır). date_trunc, extract ve age gibi fonksiyonlar tarih fonksiyonları sayfasında, tüm girdi biçimleri ise tarih ve saat tipleri bölümünde yer alır.
Sıkça Sorulan Sorular
PostgreSQL'de timestamptz saat dilimini saklar mı?
Hayır. Girdiyi UTC'ye çevirir ve sadece o anı saklar. Yazdığın dilim kaybolur; çıktı oturumun TimeZone ayarında gösterilir. Dilimi sonra lazım olacaksa adını ayrı bir text sütununda sakla.
now() ile clock_timestamp() arasındaki fark nedir?
now() (current_timestamp ile aynı) geçerli transaction'ın başlangıç zamanını döndürür, bu yüzden içindeki her satır ve komut için aynı kalır. clock_timestamp() çağrıldığı andaki gerçek zamanı döndürür ve tek bir komutun içinde bile değişir.
PostgreSQL'de bugünün tarihini nasıl alırım?
current_date bugünün tarihini oturumun saat diliminde döndürür. now()::date aynı sonucu verir, localtimestamp ise şu anki tarih ve saati dilimsiz bir timestamp olarak döndürür.
PostgreSQL'de bir timestamp ne kadar yer kaplar?
Hem timestamp hem timestamptz için mikrosaniye çözünürlükle 8 bayt. date ise 4 bayt kaplar.