[Uid] Add UuidV1::toV6(), UuidV1::toV7() and UuidV6::toV7()

Author: alexandre-daubois

components/uid.rst

@@ -180,6 +180,25 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
     $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
 
+Some UUID versions support being converted from one version to another::
+
+    // convert V1 to V6 or V7
+    $uuid = Uuid::v1();
+
+    $uuid->toV6(); // returns a Symfony\Component\Uid\UuidV6 instance
+    $uuid->toV7(); // returns a Symfony\Component\Uid\UuidV7 instance
+
+    // convert V6 to V7
+    $uuid = Uuid::v6();
+
+    $uuid->toV7(); // returns a Symfony\Component\Uid\UuidV7 instance
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\Component\Uid\UuidV1::toV6`,
+    :method:`Symfony\Component\Uid\UuidV1::toV7` and :method:`Symfony\Component\Uid\UuidV6::toV7`
+    methods were introduced in Symfony 7.1.
+
 Working with UUIDs
 ~~~~~~~~~~~~~~~~~~