🕐
← Назад к руководствам

Работа с Unix-метками времени в языках программирования

· Теги: javascript, python, php, golang, programming, unix-timestamp, epoch, database

Зачем использовать Unix-метки времени в программировании?

Unix-метки времени — это универсальная валюта времени в программном обеспечении. Они делают арифметику дат тривиальной (просто добавьте или вычтите секунды), устраняют путаницу с часовыми поясами и легко сериализуются в JSON. Каждый язык программирования предоставляет простые функции для работы с ними, но API немного отличаются. Это руководство охватывает наиболее распространённые языки и их лучшие практики.

JavaScript (браузер и Node.js)

JavaScript использует миллисекунды для своего объекта Date, в то время как большинство других систем используют секунды. Это наиболее распространённый источник ошибок.

Получение текущей метки времени

// Milliseconds since epoch (standard JavaScript)
const nowMs = Date.now();         // 1785292800000

// Seconds since epoch (for compatibility)
const nowSec = Math.floor(Date.now() / 1000);  // 1785292800

// Node.js high-resolution timer (microseconds)
const hrTime = process.hrtime.bigint();

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

// From seconds (most APIs and databases)
const timestamp = 1785292800;
const date = new Date(timestamp * 1000);  // Multiply by 1000!

// From milliseconds (JavaScript native)
const dateFromMs = new Date(1785292800000);

// Format the result
console.log(date.toISOString());
// Output: 2026-07-19T00:00:00.000Z

console.log(date.toLocaleString("en-US", { timeZone: "America/New_York" }));
// Output: 7/18/2026, 8:00:00 PM

Разбор строки даты в метку времени

// Using Date.parse() (returns milliseconds)
const ms = Date.parse("2026-07-19T00:00:00Z");
const sec = ms / 1000;  // 1785292800

// Using Date constructor
const ts = Math.floor(new Date("2026-07-19 UTC").getTime() / 1000);

Предупреждение: поведение Date.parse() различается в разных браузерах для нестандартных строк даты. Использование формата ISO 8601 с указанием часового пояса (Z для UTC) является наиболее безопасным.

Работа с часовыми поясами в JavaScript

// Format in a specific timezone
const date = new Date(1785292800 * 1000);
const options = {
  timeZone: "Asia/Tokyo",
  year: "numeric", month: "2-digit", day: "2-digit",
  hour: "2-digit", minute: "2-digit", second: "2-digit",
};
console.log(date.toLocaleString("ja-JP", options));
// Output: 07/19/2026 09:00:00

Для продвинутых операций с часовыми поясами рекомендуется использовать API Intl.DateTimeFormat или библиотеки, такие как date-fns-tz и Luxon.

Python

Python предоставляет как низкоуровневый (time), так и высокоуровневый (datetime) модули для работы с метками времени.

Получение текущей метки времени

import time

# Seconds as a float (including fractional milliseconds)
current = time.time()
# Example: 1785292800.123456

# As an integer
current_int = int(time.time())

Преобразование метки времени в datetime

from datetime import datetime

# UTC datetime (Python 3.x)
dt_utc = datetime.utcfromtimestamp(1785292800)

# Timezone-aware datetime (Python 3.9+ with zoneinfo)
from zoneinfo import ZoneInfo
dt_tokyo = datetime.fromtimestamp(1785292800, tz=ZoneInfo("Asia/Tokyo"))

# Formatted string
print(dt_utc.strftime("%Y-%m-%d %H:%M:%S"))
# Output: 2026-07-19 00:00:00

Разбор строки даты в метку времени

import time
from datetime import datetime

# From date string
dt = datetime.strptime("2026-07-19 00:00:00", "%Y-%m-%d %H:%M:%S")
timestamp = time.mktime(dt.timetuple())  # Treats as local time

# For UTC input
from datetime import timezone
timestamp_utc = dt.replace(tzinfo=timezone.utc).timestamp()

Работа с Pandas (анализ данных)

import pandas as pd

# Convert a column of Unix timestamps to datetime
df["timestamp"] = pd.to_datetime(df["unix_seconds"], unit="s")

# Convert to different units
df["datetime_ms"] = pd.to_datetime(df["unix_milliseconds"], unit="ms")

# Set a timezone
df["timestamp_ny"] = df["timestamp"].dt.tz_localize("UTC").dt.tz_convert("America/New_York")

PHP

PHP имеет самый простой API для операций с метками времени.

Получение текущей метки времени

<?php
$now = time();           // Integer: 1785292800
$nowMicro = microtime();  // String: "0.12345600 1785292800"
$nowFloat = microtime(true);  // Float: 1785292800.1235

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

<?php
echo date("Y-m-d H:i:s", 1785292800);
// Output: 2026-07-19 00:00:00

// With timezone
$tz = new DateTimeZone("Europe/London");
$dt = new DateTime("@1785292800");
$dt->setTimezone($tz);
echo $dt->format("Y-m-d H:i:s");

Go

Пакет time в Go хорошо спроектирован, но требует явного понимания используемых типов.

Получение текущей метки времени

package main

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    sec := now.Unix()            // int64 seconds
    milli := now.UnixMilli()     // int64 milliseconds
    nano := now.UnixNano()       // int64 nanoseconds
    fmt.Printf("Seconds: %d\n", sec)
}

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

t := time.Unix(1785292800, 0)
fmt.Println(t.UTC())
// Output: 2026-07-19 00:00:00 +0000 UTC

// Format as string
fmt.Println(t.Format("2006-01-02 15:04:05"))
// Output: 2026-07-19 00:00:00

// With timezone
loc, _ := time.LoadLocation("America/Chicago")
fmt.Println(t.In(loc))

Rust

use std::time::{SystemTime, UNIX_EPOCH};

// Current timestamp
let now = SystemTime::now()
    .duration_since(UNIX_EPOCH)
    .expect("Time went backwards");
println!("Seconds: {}", now.as_secs());

// Timestamp to date
let dt = chrono::NaiveDateTime::from_timestamp_opt(1785292800, 0).unwrap();
println!("{}", dt.format("%Y-%m-%d %H:%M:%S"));

Хранение в базах данных: лучшие практики

Выбор правильного типа столбца

| База данных | Рекомендуемый тип | Примечания | |----------|-----------------|-------| | PostgreSQL | TIMESTAMP WITH TIME ZONE или BIGINT | Предпочтителен нативный тип timestamp | | MySQL / MariaDB | INT UNSIGNED (для дат до 2106 года) или BIGINT | Избегайте типа TIMESTAMP (диапазон заканчивается в 2038 году) | | SQLite | INTEGER | SQLite не имеет нативного типа timestamp | | MongoDB | Объект Date или int64 | BSON Date внутренне является 64-битной меткой времени |

Пример для PostgreSQL

-- Store as native timestamp
CREATE TABLE events (
    id SERIAL PRIMARY KEY,
    occurred_at TIMESTAMP WITH TIME ZONE NOT NULL,
    payload JSONB
);

-- Insert with current time
INSERT INTO events (occurred_at) VALUES (NOW());

-- Query as Unix timestamp
SELECT EXTRACT(EPOCH FROM occurred_at) AS unix_ts FROM events;

Пример для MySQL

-- Using BIGINT for future-proof storage
CREATE TABLE logs (
    id INT AUTO_INCREMENT PRIMARY KEY,
    event_time BIGINT NOT NULL,
    message TEXT
);

-- Insert current timestamp
INSERT INTO logs (event_time, message) VALUES (UNIX_TIMESTAMP(), 'Server started');

-- Query and convert
SELECT FROM_UNIXTIME(event_time) AS readable_time FROM logs;

Сравнительная таблица языков

| Язык | Текущая метка времени | Метка времени в дату | Дата в метку времени | Разрешение | |----------|-------------------|-------------------|-------------------|------------| | JavaScript | Date.now() | new Date(ts * 1000) | Date.parse(str) / 1000 | Миллисекунды | | Python | time.time() | datetime.fromtimestamp(ts) | datetime.strptime(str).timestamp() | Float-секунды | | PHP | time() | date("Y-m-d", ts) | strtotime(str) | Секунды | | Go | time.Now().Unix() | time.Unix(ts, 0) | time.Parse(layout, str).Unix() | Секунды | | Rust | SystemTime::now() | NaiveDateTime::from_timestamp_opt() | — | Разное |

Какой бы язык вы ни использовали, наш Конвертер Unix-меток времени — надёжный помощник для быстрых проверок и отладки.