Как конвертировать Unix-метки времени в читаемые даты

Введение

Unix timestamp (также epoch time или POSIX time) — количество секунд с 1970-01-01 00:00:00 UTC (Unix epoch), исключая leap seconds. Это lingua franca времени в computing, так как это одиночный integer, timezone-independent и тривиально сортируемый. Большинство систем используют секунды; JavaScript и многие базы данных — миллисекунды.

Шаг за шагом

1. Понять секунды и миллисекунды

   Большинство серверных систем и APIs используют секунды (10-значные отметки времени до 2286). Дата в JavaScript и Instant в Java используют миллисекунды (13 цифр). Всегда проверяйте, какую единицу измерения ожидает API — их смешивание сдвигает дату в 1000 раз (на ~31 год).

2. Преобразование отметки времени в читаемую дату

   Вставьте временную метку в конвертер временных меток. Он определяет секунды и миллисекунды по длине (10 или 13 цифр) и отображает дату в формате UTC и ваш местный часовой пояс. В коде: new Date(1700000000 * 1000).toISOString() возвращает '2023-11-14T22:13:20.000Z'.

3. Преобразование даты в метку времени

   Введите дату и время в конвертер; он возвращает метку времени Unix. В коде: Math.floor(new Date('2026-08-28T12:00:00Z').getTime() / 1000) возвращает секунды эпохи. Всегда указывайте часовой пояс (Z или смещение), чтобы избежать неоднозначности местного времени.

4. Правильно обрабатывайте часовые пояса

   Временные метки Unix всегда указаны в формате UTC — у них нет часового пояса. Преобразование в локальное отображение только на уровне представления. Никогда не сохраняйте местное время как временную метку; сохраните UTC и преобразуйте на дисплее. Используйте имена часовых поясов IANA (Америка/Нью-Йорк) с Intl.DateTimeFormat для правильной обработки летнего времени.

5. Рассчитать разницу между датами

   Вычтите две временные метки, чтобы получить разницу в секундах (или миллисекундах). Разделите на 60 для минут, 3600 для часов, 86400 для дней. Используйте наш инструмент «Разница в датах» для определения диапазона, удобного для человека, или калькулятор возраста для определения возраста на основе даты рождения.

Примеры

Распространенные проблемы

• Путаница между секундами и миллисекундами: 10-значная временная метка, читаемая в миллисекундах, дает дату в 1970 году; 13-значная временная метка, считываемая как секунды, переполняет 32-битное целое число. Определите единицу измерения по количеству цифр или задокументируйте ее явно в файле API.
• Сохранение местного времени в виде отметки времени: отметки времени имеют формат UTC. Если вы вычислите Date.now() в браузере, для которого установлено значение UTC-5, и обработаете результат как локальный, переходы на летнее время будут сдвигать ваши данные на час два раза в год.
• 32-битное переполнение 19 января 2038 г., 03:14:07 UTC (2038 г.): системы, использующие подписанную 32-битную временную метку секунд, не могут представлять даты после этой точки. В новых системах используйте 64-битные или миллисекундные метки времени.
• Дополнительные секунды игнорируются: временные метки Unix пропускают дополнительные секунды, поэтому разница между двумя временными метками не равна количеству прошедших секунд SI. Большинство приложений могут игнорировать это; высокоточная астрономия и финансы не могут.

Советы

• Всегда храните и передайте временные метки в формате UTC; конвертировать в местное время только на уровне отображения, используя Intl.DateTimeFormat с часовым поясом IANA.
• Используйте строки ISO 8601 (например, 2026-08-28T12:00:00Z) для удобочитаемого APIs и временных меток для хранения. Строки ISO явно содержат часовой пояс и являются однозначными.
• При сравнении меток времени используйте одни и те же единицы измерения (секунды или миллисекунды) с обеих сторон — несовпадение единиц измерения является одной из наиболее распространенных ошибок даты.
• Используйте наш конвертер временных меток для проверки правильности ответов API во время отладки — он показывает как UTC, так и местное время, поэтому вы можете сразу обнаружить ошибки часового пояса.

Сопутствующие инструменты

• Timestamp Конвертер — Конвертировать Unix timestamps to human-readable dates and vice versa. Supports ISO 8601 format.
• Date Difference Калькулятор — Calculate the difference between two dates in days, weeks, months, and years.
• Age Калькулятор — Calculate exact age in years, months, and days from a birth date. Also shows total days lived.
• UUID Генератор — Сгенерировать random UUIDs (v4) мгновенно в вашем браузере. Без загрузки, fully полностью приватно.
• JSON Форматировщик — Форматировать, beautify and validate JSON мгновенно в вашем браузере. Без загрузки, fully полностью приватно.
• CSS Unit Конвертер — Конвертировать CSS units between px, rem, em, pt, mm, cm, and inches. Essential for responsive design.
• Age on Other Planets Calculator — Free online age on other planets calculator. Process data instantly in your browser. No upload, no signup, fully private.
• API Request Tester — Free online API request tester. Send GET, POST, PUT, PATCH or DELETE requests to any URL from your browser and inspect the status, headers and response body. Requests go directly from your browser to the target API — we never see them.

Связанные руководства

• Справочник по конвертации единиц: длина, масса, температура и площадь

Ссылки

• IEEE Std 1003.1 —Epoch and Time — POSIX definition of seconds since the epoch
• MDN Web Docs —Date — JavaScript Date object reference
• ISO 8601 —Date and time format — International standard for date/time representation