From ac5b30b936febd8c9cc4dbcd4a517642bf039a4e Mon Sep 17 00:00:00 2001
From: Peter Dimov <pdimov@gmail.com>
Date: Sat, 11 May 2024 17:14:24 +0300
Subject: [PATCH] Document timestamp_v7 and time_point_v7

---
 doc/uuid/uuid.adoc | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/uuid/uuid.adoc b/doc/uuid/uuid.adoc
index 0ad6942..d1dfa14 100644
--- a/doc/uuid/uuid.adoc
+++ b/doc/uuid/uuid.adoc
@@ -89,6 +89,11 @@ public:
     timestamp_type timestamp_v6() const noexcept;
     uuid_clock::time_point time_point_v6() const noexcept;
 
+    timestamp_type timestamp_v7() const noexcept;
+
+    std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds>
+      time_point_v7() const noexcept;
+
     clock_seq_type clock_seq() const noexcept;
     node_type node_identifier() const noexcept;
 
@@ -245,6 +250,20 @@ uuid_clock::time_point time_point_v6() const noexcept;
 
 Returns: :: The timestamp of a version 6 UUID, expressed as a `<chrono>` `time_point`.
 
+```
+timestamp_type timestamp_v7() const noexcept;
+```
+
+Returns: :: The UUIDv7 timestamp (number of milliseconds since the Unix epoch - midnight 1 Jan 1970 UTC).
+  The value is only meaningful for version 7 UUIDs.
+
+```
+std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds>
+  time_point_v7() const noexcept;
+```
+
+Returns: :: The timestamp of a version 7 UUID, expressed as a `<chrono>` `time_point`.
+
 ```
 clock_seq_type clock_seq() const noexcept;
 ```