Timestamp (znacznik czasu) to zapis konkretnego momentu w czasie, najczęściej jako liczba. W finansach i krypto spotkasz go w danych świec, historii transakcji, zapytaniach do API giełd i w nagłówkach bloków. Najpopularniejszy format to Unix timestamp – liczba sekund, które upłynęły od 1 stycznia 1970 roku, godziny 00:00:00 UTC.
Jak czytać Unix timestamp
Przykład: znacznik 1790208000 oznacza 24 września 2026 roku, godzinę 00:00:00 UTC, czyli 02:00 czasu polskiego (w okresie czasu letniego). Wiele giełd podaje czas w milisekundach – ten sam moment zapisze jako 1790208000000, z trzema zerami więcej.
| Zapis | Jednostka | Gdzie spotkasz |
|---|---|---|
| 1790208000 | sekundy | systemy Unix, część API, bloki |
| 1790208000000 | milisekundy | API większości giełd krypto, JavaScript |
| 2026-09-24T00:00:00Z | format ISO 8601 | raporty, pliki eksportu, logi |
Litera Z na końcu formatu ISO oznacza czas UTC. Zapis 2026-09-24T02:00:00+02:00 to ten sam moment w czasie polskim letnim.
Timestamp w API giełd
Każde podpisane zapytanie do API giełdy zawiera zwykle znacznik czasu. Giełda sprawdza, czy różni się on od jej zegara najwyżej o kilka sekund (okno ważności zapytania). Dzięki temu przechwyconego zapytania nie da się powtórzyć później. W praktyce oznacza to, że komputer lub serwer z botem musi mieć dobrze zsynchronizowany zegar. Jeśli zegar spieszy się lub późni, giełda odrzuca zapytania z błędem dotyczącym znacznika czasu – a bot przestaje składać zlecenia, często w najmniej odpowiednim momencie.
Timestamp świecy
Na wykresach i w danych historycznych każda świeca ma znacznik czasu. Najczęściej jest to czas otwarcia świecy, rzadziej zamknięcia – warto sprawdzić, jaką konwencję stosuje źródło danych. Świeca dzienna na większości giełd krypto zaczyna się o 00:00 UTC, czyli o 01:00 lub 02:00 czasu polskiego, zależnie od pory roku. Przy testowaniu strategii pomyłka w tej konwencji o jedną świecę daje fałszywie dobre wyniki, bo strategia „widzi” zamknięcie świecy, zanim ono nastąpiło.
Timestamp w blokach
Każdy blok Bitcoina ma w nagłówku znacznik czasu ustawiany przez górnika. Nie musi on być idealnie dokładny: protokół wymaga, żeby był późniejszy niż mediana czasów 11 poprzednich bloków i nie wyprzedzał czasu sieci o więcej niż dwie godziny. Dlatego kolejne bloki mogą mieć czasy „nie po kolei”. W Ethereum po przejściu na Proof of Stake czas bloku wynika ze slotu, a sloty trwają po 12 sekund.
Blockchain Bitcoina służy też do znakowania czasem dokumentów: skrót (hash) pliku zapisany w transakcji dowodzi, że plik istniał najpóźniej w chwili wydobycia bloku.
Przykład: przeliczenie czasu transakcji
Załóżmy, że eksport z giełdy pokazuje transakcję ze znacznikiem 1790204400000. To 23 września 2026 roku, 23:00 UTC, czyli 24 września, 01:00 czasu polskiego. Data transakcji w Polsce to więc 24 września, a nie 23. Ma to znaczenie przy rozliczeniu podatku: do przeliczenia kwot w walucie obcej stosuje się średni kurs NBP z ostatniego dnia roboczego przed dniem transakcji. Pomyłka o jeden dzień może zmienić kurs, a tym samym wynik w złotych. Wynik podatku policzysz w kalkulatorze podatku Belki.
Najczęstsze błędy
- Mylenie sekund z milisekundami – data wychodzi wtedy w odległej przyszłości albo w 1970 roku.
- Traktowanie czasu UTC z eksportu jako czasu polskiego.
- Pomijanie zmiany czasu letniego i zimowego przy porównywaniu godzin.
- Niezsynchronizowany zegar na serwerze z botem.
- Przyjęcie złej konwencji znacznika świecy (otwarcie zamiast zamknięcia) w backteście.
Perspektywa tradera
Dla tradera timestamp to przede wszystkim porządek w danych. Dziennik transakcji, eksport do rozliczeń i dane do testów strategii powinny mieć jedną, jasno określoną strefę czasową – najlepiej UTC – i przeliczenie na czas polski tylko tam, gdzie wymaga tego podatek. Przy handlu wokół publikacji danych makro liczą się sekundy, więc warto wiedzieć, o której dokładnie w UTC wypadają dane i o której zamyka się świeca, na której opierasz sygnał.
Najczęstsze pytania
Jak zamienić timestamp na datę?
W arkuszu kalkulacyjnym, w konwerterach online albo w języku programowania. Pamiętaj, żeby sprawdzić, czy wartość jest w sekundach, czy w milisekundach, i w jakiej strefie czasowej chcesz wynik.
Dlaczego API giełdy odrzuca moje zapytania z powodu timestampu?
Najczęściej zegar komputera lub serwera różni się od zegara giełdy bardziej, niż pozwala okno ważności zapytania. Pomaga włączenie automatycznej synchronizacji czasu w systemie.
Co to jest problem roku 2038?
Systemy zapisujące Unix timestamp jako 32-bitową liczbę ze znakiem przepełnią się 19 stycznia 2038 roku o 03:14:07 UTC. Nowoczesne systemy używają liczb 64-bitowych, które tego problemu nie mają.
Czy czas bloku Bitcoina jest dokładny?
Tylko w przybliżeniu. Górnik ustawia go sam w granicach dozwolonych przez protokół, więc może różnić się od rzeczywistego czasu nawet o godzinę lub więcej.
Tekst ma charakter edukacyjny i nie stanowi rekomendacji inwestycyjnej.
