Timestamp, форматы времени и примеры
Timestamp может быть Unix-числом, ISO-строкой или меткой даты в логах. Здесь собраны основные форматы и правила, которые помогают не путать секунды, миллисекунды и часовые пояса.
Текущие значения
Объяснение
Timestamp — это метка времени: способ записать конкретный момент. В разных системах timestamp может выглядеть как Unix seconds, Unix milliseconds, ISO 8601 или строка с указанием UTC-смещения.
Главная ошибка — считать, что timestamp всегда находится в местном времени. Для надежного обмена данными лучше явно указывать UTC или IANA-зону.
Примеры
| Формат | Пример | Как читать |
|---|---|---|
| Unix timestamp | 1777811400 |
Числовая метка времени в секундах для 2026-05-03T12:30:00Z. |
| ISO timestamp | 2026-05-03T15:30:00+03:00 |
Та же точка времени, записанная со смещением UTC+03:00. |
| Date only | 2026-05-03 |
Дата без времени не равна точному моменту суток. |
Практические правила
Правило
Timestamp отвечает на вопрос “какой момент времени?”, а часовой пояс отвечает на вопрос “как показать этот момент человеку?”.
Правило
В API желательно документировать единицы измерения: seconds, milliseconds или ISO 8601.
Правило
Если рядом с датой нет Z, UTC или смещения вроде +03:00, такую строку легко прочитать неправильно.
Связанные разделы
Часто задаваемые вопросы
Timestamp и Unix time — это одно и то же?
Unix time — один из видов timestamp. Timestamp шире: это любая метка времени, включая ISO 8601 и строки с UTC-смещением.
Почему timestamp иногда 10 цифр, а иногда 13?
10 цифр обычно означают секунды, 13 цифр — миллисекунды. Формат зависит от системы, которая отдает данные.
Какой timestamp лучше использовать?
Для машинной обработки удобен Unix time или ISO 8601 в UTC. Для городов и будущих дат добавляйте IANA-зону.