샘플

RFC 9562 UUIDv7 encodes 48-bit Unix epoch milliseconds in the most significant bytes for chronological sorting, while v1ToV6 and v6ToV1 provide lossless bidirectional conversion between UUIDv1 and sortable UUIDv6

sha256:3ede91be1ec866fb02f7ef628bc245da3c78a87a298ebb0182a2b8391ff9cb4c

케이스

목표

RFC 9562 UUIDv7 encodes 48-bit Unix epoch milliseconds in the most significant bytes for chronological sorting, while v1ToV6 and v6ToV1 provide lossless bidirectional conversion between UUIDv1 and sortable UUIDv6 HOW

패키지

uuid 14.0.1

환경

node

생성일

2026-08-17T20:44:23Z

흔히 이렇게 알고 있다

UUIDv1 strings sort chronologically by generation time, or converting between UUID versions requires manually decoding and recalculating timestamp fields

이 샘플의 작성자가 여기서 개발자나 모델이 기대할 법한 내용으로 적어둔 것이다. 아래 계약이 실제로 실행된 것이다.

컨트랙트

• UUIDv7 encodes Unix epoch milliseconds in its first 48 bits, ensuring generated UUIDs sort lexicographically in chronological order across millisecond timestamps
• UUIDv7 extracts the exact 48-bit big-endian millisecond timestamp passed via options.msecs
• UUIDv7 with identical timestamps sorts strictly by sequence number
• v1ToV6 reorders UUIDv1 timestamp fields into high-mid-low order into a valid UUIDv6 that sorts chronologically
• v6ToV1 losslessly restores the original UUIDv1 from a UUIDv6 representation
• v1ToV6 and v6ToV1 accept either formatted UUID strings or 16-byte Uint8Array buffers and return the matching representation
• v7 throws Error when provided with a random byte array shorter than 16 bytes
• v1ToV6 and v6ToV1 throw TypeError on invalid UUID strings

파일

• NOTES.md
• csx.json
• package-lock.json
• package.json
• test/contract.mjs

소스 아티팩트 내려받기 (tar.gz)

오리진 시더

csx-seed

검증 영수증

• node 22 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9