Backend geliştirmede en sık duyulan tavsiyelerden biri şudur:

Tarihleri her zaman UTC olarak sakla.

Doğru bir tavsiye. Ama eksik.

Çünkü yazılımda “tarih” dediğimiz şey aslında birkaç farklı kavram. Hepsini aynı şekilde saklamak, bazılarında hata yapmak demek.

Bir an ile bir takvim tarihi aynı şey değil

Bir siparişin oluşturulma zamanı bir andır. Dünyanın neresinde olursanız olun aynı anı ifade eder:

2026-10-20T16:52:00Z

Bunu UTC olarak saklamak doğrudur. Gösterirken kullanıcının saat dilimine çevirirsiniz.

Ama bir kullanıcının doğum günü bir an değildir.

1990-05-14

Bu tarihi UTC’ye çevirmeye çalışırsanız, örneğin gece yarısı olarak kabul edip timestamp’e dönüştürürseniz, farklı bir saat diliminde gösterildiğinde 13 Mayıs olarak görünebilir. Doğum günleri, tatil günleri, fatura vade tarihleri bir takvim tarihidir ve saat dilimi bilgisi olmadan DATE olarak saklanmalıdır.

Java tarafında bu ayrım Instant ile LocalDate arasındaki farktır.

Gelecekteki randevular

Daha ince bir durum var.

Bir kullanıcı İstanbul’da, bir yıl sonrası için saat 10:00’da bir randevu oluşturuyor.

Bunu bugün UTC’ye çevirip saklarsanız 07:00Z olarak kaydedersiniz.

Peki bu arada saat dilimi kuralları değişirse?

Bu teorik bir risk değil. Türkiye 2016’da kalıcı yaz saatine geçerek UTC+3’te sabitlendi. Birçok ülke yaz saati uygulamasını kaldırdı, başlattı veya tarihlerini değiştirdi. IANA timezone veritabanı bu yüzden yılda birkaç kez güncelleniyor.

Kural değiştiğinde, UTC olarak saklanmış randevu artık yanlış yerel saate denk gelir. Kullanıcı 10:00 yazdı, sistem 09:00 gösterir.

Gelecekteki yerel olaylar için daha doğru yaklaşım, kullanıcının niyetini saklamaktır:

local_datetime: 2027-10-20T10:00
zone_id:        Europe/Istanbul

UTC karşılığı gerektiğinde güncel kurallarla hesaplanır. İsterseniz sorgulama kolaylığı için hesaplanmış UTC değeri de ayrı bir kolonda tutulabilir, ama kaynak yerel değer ve bölge adıdır.

Burada +03:00 gibi bir offset değil, Europe/Istanbul gibi bir bölge adı saklamak önemlidir. Offset bir anın özelliğidir. Bölge ise kurallar bütünüdür.

Veritabanı tipleri

PostgreSQL’de iki tip var ve isimleri kafa karıştırıcı.

timestamp (without time zone) saat dilimi bilgisi taşımaz. Ne yazarsanız onu saklar.

timestamptz ise girdiyi UTC’ye çevirerek saklar ve okurken session’ın saat dilimine göre gösterir. Adına rağmen saat dilimini saklamaz.

Anları saklamak için timestamptz kullanmak neredeyse her zaman doğru tercihtir. timestamp kullanıldığında, uygulama sunucusunun ve veritabanı session’ının saat dilimi ayarları sessizce sonuca karışır.

MySQL tarafında DATETIME ve TIMESTAMP arasında benzer bir fark var. Ayrıca TIMESTAMP tipinin 2038 sınırı da hâlâ dikkat edilmesi gereken bir konu.

Sunucunun saat dilimi

Bir diğer klasik hata, uygulamanın sunucunun varsayılan saat dilimine güvenmesidir.

new Date()
LocalDateTime.now()

Geliştiricinin makinesinde Europe/Istanbul, container’da UTC, eski bir sunucuda başka bir şey.

Aynı kod ortamdan ortama farklı sonuç üretir. “Bugünün siparişleri” raporu Türkiye’de gece 00:00 ile 03:00 arasında verilen siparişleri bir önceki güne yazar.

Benim tercihim sunucuları ve JVM’i UTC’de çalıştırmak, saat dilimini her zaman açıkça vermek ve zamanı Clock gibi enjekte edilebilir bir kaynaktan almak. Bu son madde testlerde zamanı kontrol edebilmeyi de sağlıyor.

“Gün” de bir saat dilimi kavramıdır

Bir kullanıcının günlük limiti olduğunu düşünün. Gün ne zaman başlıyor?

UTC gece yarısı mı? Kullanıcının yerel gece yarısı mı? Şirketin merkezinin bulunduğu yerin gece yarısı mı?

Bu bir teknik karar değil, iş kuralıdır ve açıkça yazılması gerekir. Yazılmadığında her geliştirici farklı bir varsayım yapar.

Zaman, yazılımda en çok “basit” sanılıp en çok hata çıkaran konulardan biri.

Bir tarih alanı eklerken sorulacak ilk soru şu: bu bir an mı, yoksa bir takvim tarihi mi?