時刻ベースのUUIDは、RFC 9562で定義された2つの異なるエポック体系で生成タイムスタンプを保持します。UUIDv7ではUnixエポックからのミリ秒、UUIDv1およびUUIDv6では1582-10-15T00:00:00Zからの100ナノ秒単位のグレゴリオ暦インターバルが使用されます。
例1:UUIDv7主キーのデコード
UUIDv7で生成されたデータベース主キーを例に見てみましょう。
01941f29-7c7b-7a3c-9f4e-2b8d5c1a0e6f
パーサーは先頭48ビット(01941f297c7b)を符号なしビッグエンディアンのミリ秒整数(1735689600123)として読み取り、13番目のニブル(7、2進数0111)および17番目のニブルの上位2ビット(9、2進数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の比較デコード
以下の2つの識別子は、まったく同じグレゴリオ暦タイムスタンプ(0x1efc7d357fd0000 = 100ナノ秒単位で139549824000000000ティック)、クロックシーケンス、およびノードIDをエンコードしており、オクテット0〜7における60ビットのタイムスタンプ配置順序のみが異なります。
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)"
}
}