시간 기반 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 vs 재정렬된 UUIDv6 디코딩 비교
아래의 두 식별자는 모두 동일한 그레고리력 타임스탬프(0x1efc7d357fd0000 = 100ns 단위 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)"
}
}