SQL Academy · Lekcja

Strefy czasowe: TIMESTAMP a TIMESTAMPTZ

Poznaj różnicę między TIMESTAMP i TIMESTAMPTZ, konwertuj wartości za pomocą AT TIME ZONE i przechowuj czas UTC w aplikacjach przenośnych.

Strefy czasowe: TIMESTAMP a TIMESTAMPTZ to bezpłatna lekcja SQL Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej SQL Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs SQL Academy zawiera 4 lekcji w sumie.

Dwa typy znaczników czasu

PostgreSQL ma DWA typy znaczników czasu:

TIMESTAMP — „naiwny” znacznik czasu, bez informacji o strefie
TIMESTAMPTZ — znacznik czasu ze strefą czasową (wewnętrznie przechowywany jako UTC)

Zasada praktyczna: preferuj TIMESTAMPTZ dla zdarzeń, a TIMESTAMP stosuj do całkowicie abstrakcyjnych godzin, takich jak „9:00 w godzinach pracy”.

Jak działa TIMESTAMPTZ

Wewnętrznie jest zawsze przechowywany jako UTC. Podczas INSERT dane wejściowe są konwertowane ze strefy czasowej sesji na UTC. Podczas SELECT wynik jest konwertowany z powrotem do strefy czasowej sesji.

SET TIME ZONE 'Europe/Berlin';
INSERT INTO events (ts) VALUES ('2024-03-15 12:00:00');
-- stored as 2024-03-15 11:00:00 UTC (Berlin is UTC+1 in winter)

SET TIME ZONE 'UTC';
SELECT ts FROM events;
-- 2024-03-15 11:00:00+00

TIMESTAMP powoduje utratę informacji

Zwykły TIMESTAMP nie zna strefy czasowej. „2024-03-15 12:00:00” może oznaczać dowolny czas lokalny. Gdy użytkownicy zmieniają strefy, znaczenie tej wartości zostaje utracone.

AT TIME ZONE

Konwertowanie między strefami na potrzeby wyświetlania:

SELECT ts AT TIME ZONE 'America/New_York' AS ny_time FROM events;
SELECT ts AT TIME ZONE 'Asia/Tokyo'        AS tokyo_time FROM events;

Przechowywanie UTC i wyświetlanie czasu lokalnego

Najlepsza praktyka: przechowuj dane jako TIMESTAMPTZ, konwertuj je do strefy użytkownika w klauzuli SELECT i nigdy nie rób tego odwrotnie.

SELECT id,
       ts AT TIME ZONE COALESCE(u.tz, 'UTC') AS local_ts
FROM events e
JOIN users u ON u.id = e.user_id;

SESSION TIME ZONE

Można ją ustawić dla sesji, użytkownika albo globalnie:

-- Session:
SET TIME ZONE 'Europe/Berlin';

-- Per-user (PG):
ALTER ROLE alice SET timezone TO 'Europe/Berlin';

-- Server default in postgresql.conf:
-- timezone = 'UTC'

SUPPLY ZONE WITH LITERAL

Umieść strefę w literałach:

SELECT TIMESTAMPTZ '2024-03-15 12:00:00 Europe/Berlin';
SELECT '2024-03-15 12:00:00+02'::TIMESTAMPTZ;

NOW() zwraca TIMESTAMPTZ

NOW() i CURRENT_TIMESTAMP zawsze zwracają TIMESTAMPTZ. Łączenie ich z kolumnami typu TIMESTAMP jest częstym błędem.

Kiedy właściwy jest TIMESTAMP (bez strefy)

W przypadku abstrakcyjnych lub lokalnych godzin, które rzeczywiście nie zależą od strefy — na przykład „sklep otwiera się o 09:00” — należy użyć TIMESTAMP (lub TIME).

CREATE TABLE store_hours (
  store_id BIGINT,
  open_at  TIME NOT NULL,
  close_at TIME NOT NULL
);

Zmiany czasu letniego

TIMESTAMPTZ automatycznie obsługuje zmianę czasu letniego. Dodawanie INTERVAL działa w godzinach zegarowych, chyba że przekroczysz granicę zmiany czasu — wtedy możesz przesunąć czas o 23 lub 25 godzin.

SELECT TIMESTAMPTZ '2024-03-30 23:00:00 Europe/Berlin' + INTERVAL '5 hours';
-- Result accounts for the DST transition on March 31

Nie przechowuj przesunięć, przechowuj nazwy stref

Przesunięcie takie jak +02:00 nie określa, kiedy zaczyna się czas letni. Określa to nazwa strefy, taka jak Europe/Berlin. Przechowując macierzystą strefę użytkownika, zapisuj nazwę IANA.

Podsumowanie

W przypadku zdarzeń domyślnie używaj TIMESTAMPTZ.

Dane są przechowywane jako UTC i wyświetlane w strefie czasowej sesji
Do wyświetlania używaj konwersji AT TIME ZONE
TIMESTAMP (bez strefy) stosuj tylko do abstrakcyjnych godzin lokalnych

Szybki test

Tworzysz globalną usługę SaaS rejestrującą zdarzenia użytkowników. Jakiego typu znacznika czasu należy użyć dla kolumny occurred_at?

Często zadawane pytania

Czy lekcja „Strefy czasowe: TIMESTAMP a TIMESTAMPTZ” jest bezpłatna?

Tak — pełny tekst „Strefy czasowe: TIMESTAMP a TIMESTAMPTZ” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu SQL Academy, przejdź na CoddyKit PRO. Kurs SQL Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Strefy czasowe: TIMESTAMP a TIMESTAMPTZ”?

Poznaj różnicę między TIMESTAMP i TIMESTAMPTZ, konwertuj wartości za pomocą AT TIME ZONE i przechowuj czas UTC w aplikacjach przenośnych. Ćwiczysz SQL Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć SQL Academy?

Nie wymagamy żadnego doświadczenia. SQL Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Strefy czasowe: TIMESTAMP a TIMESTAMPTZ”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji SQL Academy?

Tak. Każda lekcja SQL Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do SQL Academy