Znacznik czasu Unix na datę

Znacznik czasu Unix na datę to bezpłatne narzędzie, które przelicza znacznik czasu Unix na datę w UTC oraz odpowiadającą jej datę w Twojej lokalnej strefie czasowej.

Czym jest znacznik czasu Unix?

Znacznik czasu Unix to liczba określająca czas, jaki upłynął od 1 stycznia 1970 roku, godziny 00:00:00 UTC. Ten punkt początkowy nazywa się epoką Uniksa. Dzięki temu systemy mogą zapisywać i porównywać momenty w czasie w zwięzłej formie, niezależnej od strefy czasowej.

Znaczniki czasu Unix najczęściej podają liczbę sekund, choć niektóre interfejsy API i języki programowania używają milisekund, mikrosekund lub nanosekund. Jednostka nie jest zakodowana w samej liczbie, dlatego trzeba ją ustalić na podstawie dokumentacji lub schematu danych. W przypadku współczesnych dat wartość dziesięciocyfrowa zwykle oznacza sekundy, a trzynastocyfrowa milisekundy. Liczba cyfr jest jednak tylko pomocną wskazówką, a nie formalną gwarancją.

Takie przeliczanie często przydaje się podczas odczytywania odpowiedzi z zewnętrznego API, sprawdzania rekordów w bazie danych i wpisów w logach lub debugowania obliczeń związanych z terminem ważności. Warto też z niego skorzystać przed wdrożeniem, gdy plik konfiguracyjny zapisuje czas aktywacji, wygaśnięcia pamięci podręcznej albo tokenu jako liczbę całkowitą zamiast czytelnej daty.

Jak przeliczyć znacznik czasu Unix na datę?

Wpisz wartość liczbową w polu Znacznik czasu Unix, a następnie odczytaj wyniki dla UTC i Twoja lokalna strefa czasowa. UTC jest stałym punktem odniesienia, natomiast wynik lokalny pokazuje ten sam moment po uwzględnieniu przesunięcia Twojej strefy czasowej.

1. Upewnij się, że wartość źródłowa rzeczywiście jest znacznikiem czasu Unix.
2. Sprawdź, czy jednostką są sekundy, czy mniejsza jednostka, na przykład milisekundy.
3. Porównując systemy, logi lub dane z API, korzystaj z wyniku UTC.
4. Skorzystaj z wyniku lokalnego, jeśli chcesz sprawdzić, jaką godzinę lub datę zobaczyłaby dana osoba.

Jeśli to możliwe, wpisuj wyłącznie liczbę całkowitą. Spacje, separatory tysięcy, etykiety ani skopiowane znaki interpunkcyjne nie należą do formatu znacznika czasu. Na przykład 1,704,067,200 to zapis ułatwiający odczyt człowiekowi, natomiast 1704067200 jest standardową formą przeznaczoną do przetwarzania maszynowego. Litery ze znakami diakrytycznymi i znaki spoza alfabetu łacińskiego nie mają żadnego znaczenia w znaczniku czasu Unix.

Nie określono dokładnie, jak narzędzie obsługuje puste pole, wartości dziesiętne, separatory i wyjątkowo długie liczby. Usuń otaczający tekst i sprawdź jednostkę, zanim uznasz otrzymaną datę za wiarygodną.

Jak interpretować wyniki UTC i czasu lokalnego?

Wartość UTC traktuj jako punkt odniesienia niezależny od strefy czasowej. Wartość lokalna przedstawia ten sam moment po uwzględnieniu Twojej strefy. Nie są to dwa różne zdarzenia.

W Polsce zimą obowiązuje czas środkowoeuropejski, a latem czas środkowoeuropejski letni. Lokalnie znacznik UTC będzie więc wyświetlany godzinę później zimą i dwie godziny później latem. Na sposób prezentowania czasu lokalnego mogą też wpływać historyczne i przyszłe reguły dotyczące stref czasowych, szczególnie poza Polską.

Jeśli otrzymana data różni się od oczekiwanej o kilkadziesiąt lat, najpierw sprawdź, czy nie pomylono sekund z milisekundami. Jeżeli różnica wynosi dokładnie godzinę lub kilka godzin, zweryfikuj założenia dotyczące strefy czasowej, zamiast zmieniać sam znacznik. Przesunięcie daty o jeden dzień często występuje wtedy, gdy moment w UTC przypada blisko północy, a lokalne przesunięcie przenosi go na poprzedni lub następny dzień kalendarzowy.

Nieprawidłowe dane wejściowe mogą zawierać litery, osadzone etykiety, pustą wartość albo liczbę spoza zakresu dat obsługiwanego przez system docelowy. Dokładna treść błędów i obsługiwany zakres liczbowy narzędzia nie są udokumentowane. Jeśli wynik nie pojawi się lub wygląda niewiarygodnie, sprawdź go w systemie źródłowym, zamiast zgadywać.

Przykłady przeliczania znaczników czasu

W poniższych przykładach znaczniki czasu są podane w pełnych sekundach.

Wartość wejściowa 0

Wynik UTC 1 January 1970 at 00:00:00 UTC

Zero wyznacza epokę Uniksa. Wynik lokalny może być inny, jeśli obowiązujące przesunięcie strefy czasowej nie jest równe UTC.

Wartość wejściowa 1704067200

Wynik UTC 1 January 2024 at 00:00:00 UTC

W Polsce ten moment przypada na czas środkowoeuropejski, więc lokalny zegar wskazuje godzinę 01:00. Ten sam znacznik wyświetlony w strefie czasowej położonej na zachód od UTC nadal może przypadać na 31 grudnia 2023 roku.

Ujemne znaczniki czasu oznaczają momenty sprzed epoki Uniksa. Na przykład -1 standardowo oznacza jedną sekundę przed początkiem epoki, czyli 31 grudnia 1969 roku o 23:59:59 UTC. Obsługa wartości ujemnych zależy od środowiska programistycznego, bazy danych i biblioteki dat.

Kiedy przeliczanie znacznika czasu nie jest potrzebne?

Przeliczanie nie jest potrzebne, jeśli wartość będą odczytywać wyłącznie maszyny, a wszystkie uczestniczące systemy używają tej samej jednostki i epoki. Pozostawienie wartości liczbowej pozwala uniknąć wprowadzania sformatowanych dat, które później mogłyby zostać zinterpretowane według niewłaściwych ustawień regionalnych lub strefy czasowej.

• Nie przeliczaj znaczników tylko po to, aby porównać ich kolejność chronologiczną. Wartości liczbowe zapisane w tej samej jednostce można porównać bezpośrednio.
• Nie zastępuj wymaganego przez API liczbowego znacznika sformatowaną datą, chyba że specyfikacja dopuszcza taki format.
• Nie przeliczaj i nie analizuj wielokrotnie tych samych znaczników podczas przetwarzania danych. Zachowaj wartość źródłową i sformatuj ją dopiero na etapie prezentacji.
• Przelicz znacznik podczas debugowania nieznanego rekordu, sprawdzania terminu ważności lub weryfikowania danych zewnętrznych przed importem.

Czytelny wynik nie dowodzi również, że wartość źródłowa jest poprawna. Błędnie wpisany znacznik może dać całkowicie prawidłową datę, dlatego porównaj go ze zdarzeniem biznesowym, kolejnością wpisów w logu lub dokumentacją źródłową.

Najczęściej zadawane pytania

Czy mogę użyć 13-cyfrowego znacznika czasu?

W przypadku współczesnych dat trzynastocyfrowy znacznik zwykle oznacza milisekundy, a nie sekundy. Jeśli konwerter oczekuje sekund, najpierw podziel wartość w milisekundach przez 1000. Resztę zachowaj tylko wtedy, gdy system docelowy obsługuje ułamki sekund. Nie określono, jak to narzędzie obsługuje dane wejściowe w milisekundach, dlatego sprawdź jednostkę niezależnie.

Czy znaczniki czasu Unix uwzględniają sekundy przestępne?

Standardowy czas uniksowy nie przedstawia sekund przestępnych jako osobno numerowanych sekund. Systemy zazwyczaj odwzorowują czas jako ciągłą wartość, przyjmując, że każdy dzień ma 86 400 sekund uniksowych. Sposób synchronizacji zegara może jednak różnić się między platformami. W typowych zastosowaniach rzadko wpływa to na wyświetlany wynik, ale ma znaczenie w specjalistycznych pomiarach czasu.

Czy ten sam znacznik czasu wszędzie wskaże tę samą datę?

Wszędzie wskazuje ten sam moment, ale lokalna data kalendarzowa i godzina mogą się różnić zależnie od strefy czasowej. Znacznik przypadający blisko północy UTC może wskazywać różne daty w Warszawie, Nowym Jorku i Tokio. Wymieniaj znaczniki w UTC, a formatowanie lokalne stosuj wyłącznie podczas wyświetlania.

Dlaczego arkusz kalkulacyjny zmienia mój znacznik czasu?

Arkusze kalkulacyjne mogą wyświetlać długie wartości w notacji naukowej albo stosować format daty przeznaczony dla własnego systemu numerów seryjnych. Zaimportuj kolumnę ze znacznikami jako tekst lub liczby całkowite, jeśli pozwala na to wymagana precyzja, a następnie użyj jawnej formuły przeliczającej. Przed konwersją sprawdź, czy arkusz nie zaokrąglił ostatnich cyfr.

Czy rok 2038 stanowi problem dla znaczników czasu Unix?

Może być problemem w systemach, które zapisują sekundy uniksowe jako 32-bitową liczbę całkowitą ze znakiem. Jej dodatni zakres kończy się w styczniu 2038 roku. Współczesny zapis 64-bitowy pozwala obsługiwać znacznie szerszy zakres, ale starsze bazy danych, urządzenia wbudowane i biblioteki nadal mogą narzucać węższy limit. Przed wdrożeniem sprawdź typ danych i bibliotekę dat używaną przez każdy system odbierający tę wartość.