Add UUIDv7 support for time-ordered UUIDs

README.md

@@ -298,6 +298,10 @@ type UserWithUUID struct {
 // Generate a new random UUID (version 4).
 userUUID := datatypes.NewUUIDv4()
 
+// Generate a new time-ordered UUID (version 7).
+// UUIDv7 is recommended for new applications as it's sortable by creation time.
+userUUIDv7 := datatypes.NewUUIDv7()
+
 user := UserWithUUID{Name: "jinzhu", UserUUID: userUUID}
 DB.Create(&user)
 // INSERT INTO `user_with_uuids` (`name`,`user_uuid`) VALUES ("jinzhu","ca95a578-816c-4812-babd-a7602b042460")

uuid.go

@@ -22,6 +22,11 @@ func NewUUIDv4() UUID {
 	return UUID(uuid.Must(uuid.NewRandom()))
 }
 
+// NewUUIDv7 generates a UUID version 7, panics on generation failure.
+func NewUUIDv7() UUID {
+	return UUID(uuid.Must(uuid.NewV7()))
+}
+
 // GormDataType gorm common data type.
 func (UUID) GormDataType() string {
 	return "string"

uuid_test.go

@@ -37,6 +37,12 @@ func TestUUID(t *testing.T) {
 		}, {
 			Name:     "uuid-4",
 			UserUUID: datatypes.NewUUIDv4(),
+		}, {
+			Name:     "uuid-5",
+			UserUUID: datatypes.NewUUIDv7(),
+		}, {
+			Name:     "uuid-6",
+			UserUUID: datatypes.NewUUIDv7(),
 		}}
 
 		if err := DB.Create(&users).Error; err != nil {
@@ -122,6 +128,8 @@ func TestUUIDPtr(t *testing.T) {
 		uuid2 := datatypes.NewUUIDv1()
 		uuid3 := datatypes.NewUUIDv4()
 		uuid4 := datatypes.NewUUIDv4()
+		uuid5 := datatypes.NewUUIDv7()
+		uuid6 := datatypes.NewUUIDv7()
 
 		users := []UserWithUUIDPtr{{
 			Name:     "uuid-1",
@@ -135,6 +143,12 @@ func TestUUIDPtr(t *testing.T) {
 		}, {
 			Name:     "uuid-4",
 			UserUUID: &uuid4,
+		}, {
+			Name:     "uuid-5",
+			UserUUID: &uuid5,
+		}, {
+			Name:     "uuid-6",
+			UserUUID: &uuid6,
 		}}
 
 		if err := DB.Create(&users).Error; err != nil {