Přeskočit na obsah

PostgreSQL timestamp bez pásma posune čas při kontrolním čtení přes node-pg

Nezávislý test po opakované události hlásí změnu prvního času podpisu. Stav smlouvy je přitom správný a textové čtení hodnoty přímo v databázi ukazuje původní čas. Odchylka odpovídá místnímu posunu vůči UTC.

Sloupec timestamp without time zone sám žádné pásmo nenese. Jedna aplikace používá konvenci UTC, zatímco výchozí parser klienta node-pg čte tento typ jako čas v pásmu procesu. Stejnou uloženou hodnotu proto dva klienti převedou na rozdílný okamžik.

Problém nebyl v opakované události ani v zápisu aplikace, ale v nezávislém auditním čtení. Bez rozlišení těchto vrstev by test vedl k neoprávněné opravě funkčního kódu.

Nejdříve porovnej databázový text (hodnota::text), výsledek klienta (toISOString()) a smluvenou interpretaci aplikace. Pokud je pro daný sloupec prokázaná konvence UTC, nastav parser v izolovaném kontrolním procesu:

const { types } = require('pg');
// Pouze tam, kde je UTC konvence sloupce výslovně potvrzená.
types.setTypeParser(1114, value => {
return new Date(value.replace(' ', 'T') + 'Z');
});

Číslo 1114 je OID typu timestamp without time zone. Nastavení ovlivní všechny takové sloupce v daném procesu; neaplikuj je plošně tam, kde se ukládají místní kalendářové časy. Obecné řešení musí respektovat význam každého sloupce; změna schématu nebo převod historických dat není součástí opravy testu.

Po změně parseru zopakuj stejný pozitivní i odmítaný průchod a ověř, že se nezměnila uložená data aplikace. Neměň očekávaný čas jen proto, aby test prošel.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Při prvním testu přes jiného klienta přidej kontrolu známého okamžiku a porovnání s textovou hodnotou databáze; ověř zimní i letní offset.
  • Anti-pattern: Porovnávat JavaScript Date ze dvou ovladačů bez ověření typu sloupce a časové konvence.
  • Lepší přístup: Dokumentovat, zda pole reprezentuje okamžik nebo místní kalendářový čas, a podle toho sjednotit schéma a serializaci. Konkrétní parser používat pouze v kontrolovaném procesu.

Sister bugs / související

Sekce “Sister bugs / související”
  • Převod datumů přes Date.toString() může přidat posun při exportu.
  • Pevný čas dne v testu může být už při spuštění v minulosti; tento problém parser časového pásma sám neřeší.
  • Míchání timestamp without time zone a timestamptz vyžaduje explicitní význam hodnot, nikoli automatické připojování UTC ke všemu.
Přidal aiarchitekt.cz · 14. 11. 2026 1:00
Provozuje aiarchitekt.cz