Привязанные ко времени UUID хранят метки времени создания в двух различных системах отсчета эпох, определенных стандартом RFC 9562: миллисекунды эпохи Unix для UUIDv7 и 100-наносекундные интервалы григорианского календаря начиная с 1582-10-15T00:00:00Z для UUIDv1 и UUIDv6.
Пример 1: Декодирование первичного ключа UUIDv7
Рассмотрим первичный ключ базы данных, сгенерированный в формате UUIDv7:
01941f29-7c7b-7a3c-9f4e-2b8d5c1a0e6f
Парсер считывает первые 48 бит (01941f297c7b) как беззнаковое целое число миллисекунд в порядке big-endian (1735689600123), проверяет 13-й полубайт (7, в двоичном виде 0111) и два старших бита 17-го полубайта (9, в двоичном виде 1001 -> вариант 10), после чего отделяет поле rand_a (12 бит) от rand_b (62 бита):
{
"canonical": "01941f29-7c7b-7a3c-9f4e-2b8d5c1a0e6f",
"version": 7,
"versionLabel": "UUIDv7 (Unix Epoch Time-Ordered)",
"variant": "RFC 9562 (10xx)",
"timestamp": {
"epochSystem": "Unix Epoch (1970-01-01T00:00:00Z)",
"unixMilliseconds": 1735689600123,
"iso8601Utc": "2025-01-01T00:00:00.123Z"
},
"fields": {
"unix_ts_ms": "0x01941f297c7b",
"ver": "0b0111 (7)",
"rand_a": "0xa3c (12 bits)",
"var": "0b10",
"rand_b": "0x1f4e2b8d5c1a0e6f (62 bits)"
}
}
Пример 2: Декодирование UUIDv1 в сравнении с переупорядоченным UUIDv6
Оба приведенных ниже идентификатора кодируют одну и ту же григорианскую метку времени (0x1efc7d357fd0000 = 139549824000000000 тиков по 100 нс), последовательность часов и ID узла, отличаясь только тем, как именно 60 бит времени распределены по октетам с 0 по 7:
UUIDv1: 57fd0000-c7d3-11ef-aa1b-3d8f4a91c20e
UUIDv6: 1efc7d35-7fd0-6000-aa1b-3d8f4a91c20e
Сборка частей time_hi (1ef), time_mid (c7d3) и time_low (57fd0000) из UUIDv1 — или конкатенация time_high (1efc7d35), time_mid (7fd0) и time_low (000) из UUIDv6 — с последующим вычитанием смещения между григорианской эпохой и эпохой Unix (122192928000000000 тиков) дает следующий отчет по декодированным полям:
{
"canonical": "57fd0000-c7d3-11ef-aa1b-3d8f4a91c20e",
"version": 1,
"variant": "RFC 9562 (10xx)",
"timestamp": {
"gregorianTicks100ns": "139549824000000000",
"unixMilliseconds": 1735689600000,
"subMillisecondNanoseconds": 0,
"iso8601Utc": "2025-01-01T00:00:00.000Z"
},
"clockSequence": {
"hex": "0x2a1b",
"decimal": 10779
},
"node": {
"formatted": "3d:8f:4a:91:c2:0e",
"multicastBit": 1,
"nodeType": "Pseudorandom multicast node (RFC 9562 Section 6.10)"
}
}