Что такое unix timestamp — и почему дата уехала в 1970 год

Приложение показывает «21 января 1970». Никто не ломал базу, данные на месте. Просто где-то по дороге число прочитали не в тех единицах — и промахнулись ровно в тысячу раз.
Это самая частая ошибка со временем в коде, и лечится она одним навыком: научиться считать цифры. Сейчас покажу.
Одно число вместо даты
Unix timestamp — это количество секунд, прошедших с полуночи 1 января 1970 года по UTC. Всё. Никаких месяцев, часовых поясов и форматов.
1754870400 → 11 августа 2025, 00:00 UTC
Зачем так, если есть нормальные даты? Потому что с числом удобно всё:
- сравнивать — «позже» это просто «больше»;
- вычитать — разница двух чисел сразу даёт длительность в секундах;
- не спорить о поясах — момент времени один, а в Москве это или в Нью-Йорке, решаем при показе;
- передавать куда угодно — число одинаково выглядит в любом языке. Кстати, в JSON вообще нет отдельного типа для даты — только строки и числа. Поэтому даты в API и приходят либо строкой, либо вот таким числом.
10 цифр или 13 — правило на глаз
А теперь главное. Часть мира считает в секундах, часть — в миллисекундах.
- 10 цифр — секунды.
1754870400. Так отдают Python, PHP, Postgres, большинство API. - 13 цифр — миллисекунды.
1754870400000. Так отдаёт JavaScript:Date.now()— это миллисекунды.
Что происходит, если перепутать:
- Секунды скормили туда, где ждут миллисекунды → получаем момент в 1000 раз ближе к 1970-му.
1754870400как миллисекунды — это 21 января 1970 года. Вот откуда «1970» на экране. - Миллисекунды скормили туда, где ждут секунды → улетаем в будущее примерно на 57-тысячный год. Тоже узнаваемо.
Отсюда привычка: увидел странную дату — посчитай цифры в числе. Десять или тринадцать? Всё, диагноз готов, дальше умножаешь или делишь на 1000. Десятизначных значений нам, кстати, хватит до 2286 года.
Где ты его встретишь
Не только в базе. Timestamp вылезает в самых обычных местах:
- Ответы API:
"created_at": 1754870400. - Токены. Внутри JWT поле
exp— это время истечения в секундах. Хочешь понять, протух ли токен, — сравни с текущим временем. - Лимиты. Сервис отвечает «слишком часто» и отдаёт заголовок вроде
X-RateLimit-Reset— момент, когда ограничение снимется. Тоже число. - Логи и имена файлов — потому что число красиво сортируется само по себе.
Как прочитать число руками
Пригодится каждый раз, когда смотришь в логи или в ответ API. Три способа, все занимают секунду:
# в терминале (Linux)
date -d @1754870400
// в консоли браузера — не забудь про × 1000
new Date(1754870400 * 1000).toString()
-- в базе
SELECT to_timestamp(1754870400);
Обратно, если нужно текущее число: Date.now() в JavaScript даст миллисекунды, date +%s в терминале — секунды.
Проблема 2038 года
Раз уж считаем цифры. В старых системах это число хранили в 32-битном знаковом поле, а туда влезает максимум 2 147 483 647 секунд. Кончится оно 19 января 2038 года, в 03:14:07 UTC — и счётчик уйдёт в минус, то есть в 1901 год.
Паниковать не надо: современные системы давно считают в 64 битах, а этого хватит на миллиарды лет. Но в старом железе и древних библиотеках проблема живая — и теперь ты знаешь, почему у неё такое название.
Как хранить дату в своём проекте
Практический вывод, ради которого всё и затевалось:
- В базе — тип с часовым поясом (
timestamptzв Postgres) или честное число секунд. Всегда UTC, без исключений. - В API — либо число, либо ISO-строка
2026-08-11T00:00:00Z. Главное, напиши в документации, в каких единицах число: половина ошибок случается ровно на этом стыке. - На экране — переводи в местное время в самый последний момент, при выводе.
Дальше начинается отдельное веселье с часовыми поясами — почему дата иногда показывает вчерашний день, разобрано в «Почему дата съезжает на день».
Почему точка отсчёта — 1970 год?
Это договорённость из ранних Unix-систем: выбрали круглую дату недалеко от момента разработки. Никакого сакрального смысла — просто с тех пор так считает половина мира.
Число или строка 2026-08-11T00:00:00Z — что лучше?
Число компактнее, быстрее сравнивается и не оставляет места разночтениям. Строка читается человеком без конвертера — и это её главное достоинство, особенно в логах и в ответах API, которые смотрят глазами. Для внешнего API обычно берут ISO-строку, внутри системы — число. Плохо только смешивать их в одном поле.
Timestamp — это всегда UTC?
Да. Само число не знает ни про какие пояса, оно описывает момент времени. Часовой пояс появляется только тогда, когда ты этот момент показываешь человеку.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





