PostgreSQL ma dwa typy znaczników czasu. timestamptz (timestamp with time zone) przechowuje dokładny moment: przy wejściu przeliczany na UTC, przy wyjściu pokazywany w strefie czasowej sesji. timestamp (timestamp without time zone) przechowuje datę i czas zegarowy bez strefy. Żaden z nich nie zapisuje strefy, którą podałeś. Do wszystkiego, co wydarzyło się w konkretnym momencie, używaj timestamptz.
To samo wejście daje 2026-03-01 12:00:00 i 2026-03-01 21:00:00+09. Wartość timestamptz to ten sam moment co wcześniej, teraz pokazany w czasie Tokio. Wartość timestamp nie ma strefy, z której można ją przeliczyć, więc się nie przesuwa.
Co dzieje się ze strefą czasową na wejściu
Gdy wejście zawiera przesunięcie, timestamptz używa go do ustalenia momentu. timestamp po cichu je odrzuca:
plain to 2026-03-01 12:00:00, a +02 zostało wyrzucone. with_zone to 2026-03-01 10:00:00+00, ten sam moment w UTC. Tak właśnie czasy rozjeżdżają się o kilka godzin: aplikacja wysyła tekst ISO z przesunięciem do kolumny timestamp, a przesunięcie znika.
Kiedy którego użyć
| Zastosowanie | Typ |
|---|---|
| Utworzono, zaktualizowano, opłacono, zalogowano | timestamptz |
| Zaplanowany czas lokalny, który idzie za lokalnym zegarem („codziennie o 9:00 w strefie użytkownika”) | timestamp plus kolumna z nazwą strefy |
| Dzień kalendarzowy bez godziny | date |
| Czas trwania | interval |
Oba typy zajmują 8 bajtów i przechowują mikrosekundy. Strefę sesji ustawiasz przez SET TIME ZONE 'Europe/Paris'. Używaj pełnych nazw stref, a nie skrótów takich jak EST: skrót to stałe przesunięcie, które ignoruje czas letni.
Przeliczanie stref przez AT TIME ZONE
AT TIME ZONE działa w obie strony. Na timestamptz zwraca czas zegarowy w tej strefie jako timestamp. Na timestamp czyta wartość jako czas lokalny w tej strefie i zwraca moment timestamptz.
Południe UTC to w lipcu w Nowym Jorku 08:00, a 9:00 w Paryżu to 07:00 UTC. Pierwszej formy używasz, żeby pokazać czas w strefie użytkownika, a drugiej, żeby zamienić wpisany przez użytkownika czas lokalny na moment.
Czas letni i działania na interwałach
Dodanie interval '1 day' do timestamptz zachowuje tę samą lokalną godzinę mimo zmiany czasu. Dodanie '24 hours' dodaje dokładne godziny. W Stanach Zjednoczonych zegary przestawia się do przodu 8 marca 2026:
Pierwsze daje 2026-03-08 12:00:00-04, drugie 2026-03-08 13:00:00-04. Wynik zależy od strefy czasowej sesji, więc ustawiaj ją jawnie w kodzie, który liczy na datach.
Bieżący czas
now() i current_timestamp zwracają czas rozpoczęcia bieżącej transakcji jako timestamptz, tę samą wartość dla każdego wiersza, którego dotyka polecenie. clock_timestamp() zwraca rzeczywisty czas przy każdym wywołaniu. current_date zwraca date, a localtimestamp timestamp. Typowa kolumna to created_at timestamptz NOT NULL DEFAULT now().
Konwersja kolumny timestamp na timestamptz
Jeśli istniejąca kolumna timestamp przechowuje czasy UTC, przekonwertuj ją przez USING ... AT TIME ZONE 'UTC', żeby wartości zostały odczytane jako UTC, a nie w strefie sesji:
Wartość to teraz 2026-01-15 09:30:00+01, pokazana w czasie Berlina. Zmiana przepisuje tabelę, więc przy dużej tabeli uruchom ją w spokojnym momencie (zmiany typu omawia ALTER TABLE). Funkcje takie jak date_trunc, extract i age są na stronie o funkcjach dat, a rozdział o typach daty i czasu podaje wszystkie formaty wejściowe.
Najczęściej zadawane pytania
Czy timestamptz zapisuje strefę czasową w PostgreSQL?
Nie. Zamienia wejście na UTC i zapisuje tylko ten moment. Strefa, którą podałeś, przepada; wynik jest pokazywany według ustawienia TimeZone sesji. Jeśli będziesz jej potrzebować później, zapisz nazwę strefy w osobnej kolumnie text.
Czym różni się now() od clock_timestamp()?
now() (to samo co current_timestamp) zwraca czas rozpoczęcia bieżącej transakcji, więc jest taki sam dla każdego wiersza i polecenia w niej. clock_timestamp() zwraca rzeczywisty czas w chwili wywołania i zmienia się nawet w obrębie jednego polecenia.
Jak uzyskać bieżącą datę w PostgreSQL?
current_date zwraca dzisiejszą datę w strefie czasowej sesji. now()::date daje to samo, a localtimestamp zwraca bieżącą datę i godzinę jako timestamp bez strefy.
Ile miejsca zajmuje znacznik czasu w PostgreSQL?
8 bajtów, zarówno timestamp, jak i timestamptz, z dokładnością do mikrosekund. date zajmuje 4 bajty.