SQLite a D1: časové pásma, polnoc a UTC

Prečo „dnešné“ záznamy v SQLite a Cloudflare D1 občas ukazujú včerajšok, ako vzniká chyba okolo polnoci a letného času a ako to robiť správne.

Tomáš Renčík3 min čítania
Ilustračný obrázok k článku: SQLite a D1: časové pásma, polnoc a UTC
Obsah článku
  1. 1. Základný fakt: datetime('now') je UTC
  2. 2. Typické chyby
  3. 3. Ako to robiť správne
  4. 4. Test, ktorý odhalí väčšinu chýb
  5. 5. Časté otázky
  6. 6. Na záver
  7. 7. Súvisiace články

Stručne: V SQLite aj v Cloudflare D1 vracia datetime('now') čas v UTC, nie slovenský. Preto „dnešné“ záznamy medzi polnocou a druhou ráno patria k včerajšku. Riešenie: v databáze jeden formát a jedno pásmo, pri porovnávaní normalizovať a „dnes“ počítať v miestnom časovom pásme.

Ak ste niekedy riešili chybu typu „záznam zo včera sa zobrazuje dnes“ alebo „niečo nefunguje len medzi polnocou a druhou ráno“, tento článok je pre vás. Časové pásma sú jedna z najzákernejších tried chýb — a SQLite (a teda aj Cloudflare D1) vás v nich nechá kľudne vbehnúť.

Základný fakt: datetime('now') je UTC

SELECT datetime('now');
-- 2026-10-20 06:15:00   ← UTC, nie slovenský čas

SQLite nemá „časové pásmo servera“. Funkcie datetime('now'), date('now') a CURRENT_TIMESTAMP vracajú UTC. Na Slovensku je to v zime o hodinu menej, v lete o dve.

Kým je to len v databáze, nič sa nedeje. Problém nastane, keď ten čas porovnáte s niečím, čo je v miestnom čase — napríklad s dátumom, ktorý zadal používateľ.

Typické chyby

1. „Dnešné“ záznamy

SELECT * FROM hovory WHERE date(zaciatok) = date('now');

Ak zaciatok ukladáte v slovenskom čase, tak medzi polnocou a druhou ráno (v lete) si date('now') ešte myslí, že je včera. Hovor o 0:40 sa neukáže medzi dnešnými.

2. Miešanie formátov

Jeden kód ukladá 2026-10-20T06:15:00Z (ISO s T a Z), iný 2026-10-20 08:15:00 (bez pásma). Porovnávanie textu potom vracia nezmysly, lebo „T“ a medzera sa zoraďujú inak.

3. Letný a zimný čas

Posun „o dve hodiny“ platí len v lete. Kto má v kóde natvrdo +2 hours, ten má raz ročne pol roka chybu.

Ako to robiť správne

Pravidlo 1: v databáze jeden formát, jedno pásmo

Najjednoduchšie: všetko ukladajte v UTC a v jednotnom formáte (ISO 8601). Prevod na miestny čas robte až pri zobrazení.

// uloženie
const kedy = new Date().toISOString()   // "2026-10-20T06:15:00.000Z"

// zobrazenie
new Date(kedy).toLocaleString('sk-SK', { timeZone: 'Europe/Bratislava' })

Pravidlo 2: pri porovnávaní normalizujte

Ak už máte v databáze mix formátov, datetime() ich zjednotí:

SELECT * FROM zaznamy
WHERE datetime(vytvorene) BETWEEN datetime(?) AND datetime(?);

Pravidlo 3: „dnes“ počítajte v miestnom pásme

Hranice dňa (polnoc až polnoc) vypočítajte v aplikácii pre Europe/Bratislava, preveďte na UTC a do dotazu pošlite ako parametre:

import { fromZonedTime } from 'date-fns-tz'

const PASMO = 'Europe/Bratislava'
// dnešný dátum tak, ako ho vidí človek na Slovensku: "2026-10-20"
const den = new Intl.DateTimeFormat('en-CA', { timeZone: PASMO }).format(new Date())

// hranice dňa prevedené do UTC — tie pôjdu do dotazu
const od = fromZonedTime(`${den} 00:00:00`, PASMO).toISOString()
const doo = fromZonedTime(`${den} 23:59:59.999`, PASMO).toISOString()

await db.prepare('SELECT * FROM hovory WHERE zaciatok BETWEEN ? AND ?').bind(od, doo).all()

Prevod „miestna polnoc → UTC“ je presne miesto, kde sa oplatí použiť overenú knižnicu (date-fns-tz, Luxon), nie vlastnú matematiku s „+2 hodiny“. Knižnica vie, kedy platí letný čas. JavaScript postupne dostáva nové API Temporal, ktoré to rieši priamo — kým ho nemáte všade, kde kód beží, siahnite po knižnici.

Pravidlo 4: server nie je na Slovensku

Cloudflare Workers, väčšina cloudov a CI bežia v UTC. Kód, ktorý „na mojom počítači funguje“, lebo váš Mac je v slovenskom čase, na serveri zlyhá. Testujte s nastaveným pásmom:

TZ=UTC npm test

Test, ktorý odhalí väčšinu chýb

Keď robíte čokoľvek s dátumami, vyskúšajte tieto chvíle:

  • 23:30 a 0:40 miestneho času,
  • posledný deň v mesiaci a prvý deň nového,
  • noc zmeny času (koniec marca, koniec októbra),
    1. december → 1. január.

Ak aplikácia prežije tieto štyri situácie, prežije skoro všetko.

Časté otázky

Mám ukladať čas ako text alebo ako číslo?

SQLite podporuje oboje. Text vo formáte ISO 8601 je čitateľný a dobre sa zoraďuje, číslo (Unix čas) sa rýchlo porovnáva. Dôležitejšie než voľba je dodržať ju všade rovnako.

Čo dátum bez času — napríklad deň narodenia alebo splatnosť faktúry?

Ten ukladajte ako čistý dátum YYYY-MM-DD bez časového pásma. Deň splatnosti je v Bratislave aj v Tokiu ten istý deň — nepreťahujte ho cez UTC, inak sa vám pri prevode posunie o deň.

Ako otestujem noc zmeny času bez čakania na október?

Knižnice na prácu s časom vám dovolia dosadiť ľubovoľný „teraz“. V testoch si nastavte konkrétny okamih a pásmo a overte výsledok.

Na záver

Čas vyzerá jednoducho, kým nemáte používateľov, server a databázu v troch rôznych „realitách“. Majte jedno pravidlo — v databáze UTC, na obrazovke miestny čas — a dodržujte ho všade. Ušetríte si noci, ktoré som ja kedysi stratil.

Zdroj: SQLite, Date And Time Functions, sqlite.org/lang_datefunc.html.

  • #SQLite
  • #D1
  • #dátumy
  • #časové pásma
  • #databázy