基於時間的 UUID 使用 RFC 9562 定義的兩套不同紀元系統來儲存建立時間戳記:UUIDv7 採用 Unix 紀元毫秒數,而 UUIDv1 與 UUIDv6 則採用自 1582-10-15T00:00:00Z 起的 100 奈秒格里曆時間間隔。
範例 1:解碼 UUIDv7 資料庫主鍵
假設有一組以 UUIDv7 產生的資料庫主鍵:
01941f29-7c7b-7a3c-9f4e-2b8d5c1a0e6f
解析器會將前 48 位元(01941f297c7b)讀取為無號大端序毫秒整數(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
從 UUIDv1 中重組 time_hi(1ef)、time_mid(c7d3)與 time_low(57fd0000)——或者從 UUIDv6 中串接 time_high(1efc7d35)、time_mid(7fd0)與 time_low(000)——再減去格里曆至 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)"
}
}