---
id: uuid7-standard
version: "1.1.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# uuid7-standard — UUIDv7 with the final standard. Not to be confused with the uuid7 package on pypi, based on a draft version that was very different.

License: permissive · Maintenance: aging · Downloads: 155.2K/mo

## What it is and what it does

uuid7-standard generates UUIDv7 identifiers that embed creation timestamps and can extract those timestamps back out, following the final RFC 9562 specification. It wraps Python's standard datetime and UUID facilities rather than exposing raw millisecond values or strings, making it natural to use in Pythonic code. The main use case is creating sortable, time-ordered identifiers suitable for database primary keys or distributed systems where you want both uniqueness and temporal ordering.

The package explicitly avoids the older abandoned `uuid7` package on PyPI, which implemented a draft RFC with incorrect timestamps. Since Python's standard library has no UUIDv7 support yet, this fills that gap for developers who need RFC 9562-compliant UUIDs with timestamp extraction. It has no runtime dependencies beyond the standard library.

Use it for:

- Generate sortable primary keys for database records that also encode creation time.
- Create time-ordered identifiers in distributed systems where you need both uniqueness and temporal ordering.
- Extract the creation timestamp from an existing UUIDv7 to audit or filter records by when they were created.
- Migrate from millisecond-based or string-based timestamp schemes to standard-compliant UUIDs.
- Build event logs or audit trails where the UUID itself carries the event timestamp.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates and parses UUIDv7 identifiers with embedded creation timestamps, following the final RFC 9562 specification and providing Python datetime integration.

Yes, if you need RFC 9562-compliant UUIDv7 generation with Python datetime integration and no external dependencies. The package is new (first release 2025-07-03) and marked aging, so verify that maintenance will continue before adopting it in production systems. It explicitly solves the problem of the older, broken `uuid7` package on PyPI, so check that you're not accidentally installing the wrong one.

## Install

pip install uuid7-standard
uv add uuid7-standard
poetry add uuid7-standard

## Installing uuid7-standard

Before you install: Low friction: pure Python wheel with no runtime dependencies. Maintenance status is aging—last commit was 2025-07-04 and the package is only days old, so long-term support trajectory is unclear.

License in practice: Permissive license (MIT and Public Domain) means you can use this in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install uuid7-standard

import uuid7
from datetime import datetime, UTC

# Create UUIDv7 with current timestamp
u = uuid7.create()

# Extract timestamp from UUID
timestamp = uuid7.time(u)

Requires Python 3.8 or later. Conflicts with the older abandoned `uuid7` package on PyPI—uninstall it first if present.

Verify before relying:

- Whether the package will receive active maintenance beyond its initial release window.
- Real-world performance characteristics when generating large volumes of UUIDs.
- Compatibility with existing UUID libraries or ORMs that may have their own UUIDv7 implementations.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 155.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

uuidv7 generation, uuid with timestamp, sortable uuid, time-ordered identifiers, uuid7 rfc 9562, database primary key uuid, extract timestamp from uuid, uuid-generation, timestamp-ordering, rfc-9562

[View on SkillFed](https://skillfed.io/packages/uuid7-standard) · [View on PyPI](https://pypi.org/project/uuid7-standard/)