Geliştirme

PostgreSQL Tarih Filtreleri: BETWEEN ve Yarı Açık Aralıklar

Mehmet Fatih Ünal
12 Kasım 2026
7 dk okuma
#PostgreSQL#SQL#Tarih Filtreleri#timestamptz#Saat Dilimi
PostgreSQL Tarih Filtreleri: BETWEEN ve Yarı Açık Aralıklar

Bir günlük tarih filtresinde hangi sınır kastedilir?

Bir günlük rapor genellikle günün başlangıcını içerir, sonraki günün başlangıcını içermez. Bu, alt sınırı dahil ve üst sınırı hariç bir aralıktır. PostgreSQL'de BETWEEN ise iki uç değeri de dahil eder. Karşılaştırma operatörleri belgesi, bu davranışı açıklar.

Takvim günü ile zaman çizelgesindeki anı ayırmak da gerekir. 12 Kasım, hangi saat dilimindeki gün anlamına geliyor? Kullanıcının dilinden veya veritabanı sunucusunun varsayılanından bu kararı otomatik çıkarmayın. Önce raporun iş saat dilimini ve sınır politikasını belirleyin.

Sınır hatası nasıl görünür hale getirilir?

Aşağıdaki blokları aynı bağlantıda sırayla çalıştırın. Veriler, İstanbul için örnekte kullanılan +03 ofsetiyle gün sınırlarının iki yanını içerir:

CREATE TEMP TABLE date_events (
  id integer PRIMARY KEY,
  occurred_at timestamptz NOT NULL
);
INSERT INTO date_events VALUES
  (1, '2026-11-11 23:59:59+03'),
  (2, '2026-11-12 00:00:00+03'),
  (3, '2026-11-12 12:00:00+03'),
  (4, '2026-11-12 23:59:59.999999+03'),
  (5, '2026-11-13 00:00:00+03');

Başlangıçlar arasında BETWEEN kullanınca ne olduğuna bakın:

SELECT id
FROM date_events
WHERE occurred_at BETWEEN
      TIMESTAMPTZ '2026-11-12 00:00:00+03'
      AND TIMESTAMPTZ '2026-11-13 00:00:00+03'
ORDER BY id;

Sonuç 2, 3, 4 ve 5 olur. Beşinci kayıt sonraki günün tam başlangıcıdır. Aynı mantıkla komşu günleri raporlarsanız sınırdaki kayıt iki raporda da yer alabilir. Sorun verinin kaybolması değil, aralık sözleşmesinin istenen gün tanımından farklı olmasıdır.

Yarı açık aralık nasıl yazılır?

Başlangıcı >=, bitişi < ile karşılaştırın:

SELECT id
FROM date_events
WHERE occurred_at >= TIMESTAMPTZ '2026-11-12 00:00:00+03'
  AND occurred_at <  TIMESTAMPTZ '2026-11-13 00:00:00+03'
ORDER BY id;

Bu kez yalnızca 2, 3 ve 4 döner. Böylece art arda gelen günler sınırda çakışmadan birleştirilebilir. Günün sonunu 23:59:59 olarak yazmak farklı bir çözümdür ve kesirli saniye taşıyan dördüncü kaydı kaçırabilir. Bir son an tahmin etmek yerine sonraki başlangıcı hariç tutmak daha açık bir sözleşme sunar.

Bu örnek timestamptz kullanır. PostgreSQL'in tarih ve saat türleri belgesi, zaman dilimi içeren ve içermeyen değerleri ayırır. Alanınız yalnızca bir takvim tarihi taşıyorsa aynı modelin otomatik olarak uygun olduğunu varsaymayın.

Sınırlar iş saat diliminden nasıl üretilir?

Yerel takvim gününün iki başlangıcını isimli bir saat diliminde yorumlayabilirsiniz. timestamp without time zone değerine AT TIME ZONE uygulandığında sonuç timestamptz olur:

WITH bounds AS (
  SELECT TIMESTAMP '2026-11-12 00:00:00'
           AT TIME ZONE 'Europe/Istanbul' AS starts_at,
         TIMESTAMP '2026-11-13 00:00:00'
           AT TIME ZONE 'Europe/Istanbul' AS ends_at
)
SELECT e.id
FROM date_events AS e
CROSS JOIN bounds AS b
WHERE e.occurred_at >= b.starts_at
  AND e.occurred_at < b.ends_at
ORDER BY e.id;

Sonuç yine 2, 3 ve 4'tür. AT TIME ZONE belgesi, dönüşümün yönünü anlatır. Farklı bir bölgenin takvim gününü hesaplarken UTC anına sabit 24 saat eklemekle yerel sonraki günü seçmeyi eşdeğer saymayın; saat dilimi kuralları gün uzunluğunu etkileyebilir.

Sütunu date'e çevirmek aynı sonucu verir mi?

timestamptz değerini date'e çevirirken oturumun TimeZone ayarı önemlidir. occurred_at::date şeklindeki bir koşul, raporun iş saat dilimiyle aynı günü seçmeyebilir. Ekranda görülen tarihin veya oturumun varsayılanının doğru rapor sınırını garanti ettiğini düşünmeyin.

Sütuna uygulanan dönüşüm, sıradan bir occurred_at indeksinin sorguyla ilişkisini de değiştirebilir. Doğrudan sınır koşulunu incelemek için küçük örneğe indeks ekleyebilirsiniz:

CREATE INDEX date_events_occurred_at_idx ON date_events (occurred_at);
EXPLAIN (COSTS OFF)
SELECT id
FROM date_events
WHERE occurred_at >= TIMESTAMPTZ '2026-11-12 00:00:00+03'
  AND occurred_at <  TIMESTAMPTZ '2026-11-13 00:00:00+03';

Beş satırlık tabloda sıralı tarama seçilebilir. Bu, koşulun yanlış olduğunu veya her sorguda indeks zorlanması gerektiğini göstermez. EXPLAIN rehberindeki yaklaşımı gerçekçi veri ve seçicilikle uygulayın.

Tarih filtresi nasıl test edilmelidir?

Başlangıçtan hemen önce, tam başlangıçta, gün içinde, kesirli son saniyede ve tam bitişte kayıtlar kullanın. Oturum saat dilimini değiştirip açıkça belirlenen sınırların aynı kayıtları seçtiğini doğrulayın. Görüntüleme tarafında ise Intl.DateTimeFormat rehberi aynı anın farklı sunumlarını ele alır.

Sık sorulan sorular

BETWEEN yanlış bir operatör mü? Hayır. İki sınırın da dahil edilmesi isteniyorsa uygundur; tek günlük raporun sözleşmesi farklı olabilir.

Bitişi 23:59:59 yapabilir miyim? Kesirli saniyeler nedeniyle istenen kayıtları kaçırabilirsiniz. Sonraki günün başlangıcını hariç tutmayı değerlendirin.

Sunucunun saat dilimi iş saat dilimiyle aynı olmak zorunda mı? Açık sınırlar kullanan bu örnek onun aynı olmasına dayanmaz.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar