Illustration for the article: SQLite a D1: časové pásma, polnoc a UTC

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 read

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.

Súvisiace články

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

More from the blog