Skip to content

gh-130843: add UUIDv7 timestamp recipes #132154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Apr 7, 2025
Merged

gh-130843: add UUIDv7 timestamp recipes #132154

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
eb0802f
add UUIDv7 timestamp recipes
picnixz Apr 6, 2025
963f632
explicitly import `datetime`
picnixz Apr 7, 2025
d74dc13
Update Doc/library/uuid.rst
picnixz Apr 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions Doc/library/uuid.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,8 +121,10 @@ which relays any information about the UUID's safety, using this enumeration:
- The last 48 bits of the UUID. Only relevant to version 1.

* - .. attribute:: UUID.time
- The 60-bit timestamp for version 1 and 6,
or the 48-bit timestamp for version 7.
- The 60-bit timestamp as a count of 100-nanosecond intervals since
Gregorian epoch (1582-10-15 00:00:00) for versions 1 and 6, or the
48-bit timestamp in milliseconds since Unix epoch (1970-01-01 00:00:00)
for version 7.

* - .. attribute:: UUID.clock_seq
- The 14-bit sequence number. Only relevant to versions 1 and 6.
Expand Down Expand Up @@ -434,6 +436,15 @@ Here are some examples of typical usage of the :mod:`uuid` module::
>>> uuid.MAX
UUID('ffffffff-ffff-ffff-ffff-ffffffffffff')

>>> # get UUIDv7 creation (local) time as a timestamp in milliseconds
>>> u = uuid.uuid7()
>>> u.time # doctest: +SKIP
1743936859822
>>> # get UUIDv7 creation (local) time as a datetime object
>>> import datetime as dt
>>> dt.datetime.fromtimestamp(u.time / 1000) # doctest: +SKIP
datetime.datetime(...)


.. _uuid-cli-example:

Expand Down
Loading