Zaman Damgası ve Saat Dilimi Tuzakları
Gece yarısına yakın bir satış yanlış güne düşüyor. UTC ile yerel saat, yaz saati ve saatsiz tarih alanları: veri ambarında günlük rakamları bozan tuzaklar.

Bir satış 23:40'ta kesildi. Raporda ertesi güne yazılmış. Ya da tersi: günlük rakam, kaynak sistemdeki günlük toplamla uyuşmuyor ve fark her gün aynı saatlerdeki işlemlerden geliyor. Çoğu zaman sebep hesap hatası değil, zamanın iki farklı saat diliminde tutulmasıdır.
Dört sık tuzak
- UTC ile yerel saat karışıyor: bir sistem UTC, öbürü yerel saat tutar; gün sınırı birinde gece yarısı, ötekinde üç saat sonra olur.
- Saatsiz tarih alanı: bazı kaynak alanlar yalnızca tarih taşır. Aynı gün içindeki sıralamayı ya da "değişiklik saat kaçta oldu" bilgisini bu alandan çıkaramazsınız.
- Yaz saati: geçiş gününde bir saat ya hiç yoktur ya da iki kez yaşanır. Saat bazlı toplamlarda sapma yapar. Yaz saati uygulayan ülkelerdeki kaynaklarla çalışıyorsanız bu sizin için gerçek bir konudur.
- Metin olarak saklanan tarih: "09.11.2026" ile "2026-11-09" aynı metin sıralamasına girmez; biçim karışırsa sıralama bozulur.
Bir kural: hep UTC sakla, gösterirken çevir
Teknik zaman damgalarını (yükleme zamanı, çekim zamanı, olay zamanı) tek bir saat diliminde, genellikle UTC'de saklayın. Kullanıcıya gösterirken yerel saate çevirin. İş tarihi ayrı bir konudur: fatura tarihi gibi bir değer saat dilimine bağlı bir an değil, takvim günüdür; onu dönüştürmeyin, olduğu gibi saklayın.
Gün sınırı nerede?
Raporlama için "gün" tanımını yazın: kaynaktaki belge tarihi mi, ambara yüklenme günü mü, yerel takvim günü mü? Üç tanım üç farklı günlük toplam verir. Hangisinin kullanıldığı rapor açıklamasında görünmelidir.
Hızlı sınama
- Gece 23:00-01:00 arasındaki işlemleri kaynak sistemdeki raporla bire bir karşılaştırın.
- Yaz saati geçiş haftasının günlük toplamlarını ayrıca kontrol edin.
- Saat dilimi bilgisi olmayan her zaman alanının hangi dilimde olduğunu yazın.
Floemdata'da durum
Kodda doğruladıklarımız: çıkarım katmanı her kayda UTC çekim zamanı damgalar (_extracted_at). Zaman damgalı API kaynaklarında gün sınırları UTC olarak hesaplanır. Anlık görüntü tablolarının günü UTC'dir. Proje notlarımıza göre SAP B1 belgelerinin güncelleme tarihi alanı saat içermez; bu yüzden artımlı çekim bir gün örtüşme bırakır.
Doğrulamadık: yerel saatle UTC günü arasındaki farkın, sahada alacak yaşlandırma gibi "bugüne göre" hesaplayan raporlarda gece yarısı civarında bir günlük kaymaya yol açıp açmadığını ölçmedik. Müşteri sahasında saat dilimi ayarını kontrol eden bir adım da bulamadık.
Başlangıç için son haftanın günlük toplamını kaynak raporla karşılaştırın ve farkın hangi saatlerden geldiğine bakın. Sorularınız için Floemdata ekibine info@floemdata.com adresinden yazabilirsiniz.