Menu

PostgreSQL timestamp vs timestamptz (ze strefą czasową)

timestamptz przechowuje moment w czasie i pokazuje go w strefie czasowej sesji; timestamp przechowuje czas zegarowy bez strefy. Żaden nie zapisuje strefy, którą podałeś. Prawie zawsze używaj timestamptz.

Na tej stronie są działające edytory: edytuj, uruchamiaj i od razu zobacz wynik.

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ć

ZastosowanieTyp
Utworzono, zaktualizowano, opłacono, zalogowanotimestamptz
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 godzinydate
Czas trwaniainterval

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.

Ilustracja języków programowania w Coddy

Ucz się programowania z Coddy

Zacznij