Golang UUID验证与UUIDv7时间戳转换

RFC 4122 UUID验证

在Go中验证UUID是否符合RFC 4122标准，可以使用标准库或第三方库。以下是几种方法：

使用标准库

package main

import (
	"fmt"
	"regexp"
)

func IsValidUUID(uuid string) bool {
	r := regexp.MustCompile("^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4[a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}$")
	return r.MatchString(uuid)
}

func main() {
	uuid := "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
	fmt.Println(IsValidUUID(uuid)) // true
}

使用github.com/google/uuid库

package main

import (
	"fmt"
	"github.com/google/uuid"
)

func main() {
	uuidStr := "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
	_, err := uuid.Parse(uuidStr)
	if err != nil {
		fmt.Println("无效的UUID:", err)
	} else {
		fmt.Println("有效的UUID")
	}
}

UUIDv7时间戳转换

UUIDv7包含时间戳信息，可以使用专门的库来提取时间信息。以下是使用uuidcheck库的示例：

安装uuidcheck

go get github.com/uuidcheck/uuidcheck

使用示例

package main

import (
	"fmt"
	"time"
	
	"github.com/uuidcheck/uuidcheck"
)

func main() {
	// 示例UUIDv7 (假设这是一个有效的UUIDv7)
	uuidStr := "017f22e2-79b0-7cc3-98c4-dc0c0c07398f"
	
	// 验证UUID并提取时间戳
	uuidInfo, err := uuidcheck.Parse(uuidStr)
	if err != nil {
		fmt.Printf("UUID解析错误: %v\n", err)
		return
	}
	
	// 检查是否为UUIDv7
	if uuidInfo.Version() != 7 {
		fmt.Println("这不是一个UUIDv7")
		return
	}
	
	// 获取时间戳
	timestamp := uuidInfo.Timestamp()
	
	// 转换为UTC时间
	utcTime := time.Unix(int64(timestamp/1000), 0).UTC()
	
	fmt.Printf("UUID: %s\n", uuidStr)
	fmt.Printf("版本: %d\n", uuidInfo.Version())
	fmt.Printf("时间戳(毫秒): %d\n", timestamp)
	fmt.Printf("UTC时间: %s\n", utcTime.Format(time.RFC3339))
	
	// 也可以直接获取时间
	if uuidInfo.HasTime() {
		utcTime := uuidInfo.Time().UTC()
		fmt.Printf("直接获取的UTC时间: %s\n", utcTime.Format(time.RFC3339))
	}
}

注意事项

1. UUIDv7是2021年提出的新UUID版本，不是所有库都支持
2. uuidcheck库需要确认其是否支持UUIDv7，如果不行，可以考虑其他专门处理UUIDv7的库
3. 对于生产环境，建议使用成熟的UUID库如github.com/google/uuid

替代方案

如果没有找到合适的uuidcheck实现，可以手动解析UUIDv7的时间戳：

package main

import (
	"encoding/binary"
	"fmt"
	"time"
)

func ExtractUUIDv7Timestamp(uuidStr string) (uint64, error) {
	// 移除连字符
	uuidBytes := []byte(uuidStr)
	if len(uuidBytes) != 36 {
		return 0, fmt.Errorf("invalid UUID length")
	}
	
	// 转换为字节数组
	var uuid [16]byte
	_, err := fmt.Sscanf(uuidStr, "%8x-%4x-%4x-%4x-%12x",
		&uuid[0:4],
		&uuid[4:6],
		&uuid[6:8],
		&uuid[8:10],
		&uuid[10:16])
	if err != nil {
		return 0, err
	}
	
	// 检查版本号(第7字节的高4位)
	version := uuid[6] >> 4
	if version != 7 {
		return 0, fmt.Errorf("not a UUIDv7")
	}
	
	// 提取时间戳(前48位)
	timestampBytes := append([]byte{0, 0}, uuid[0:6]...)
	timestamp := binary.BigEndian.Uint64(timestampBytes)
	
	return timestamp, nil
}

func main() {
	uuidStr := "017f22e2-79b0-7cc3-98c4-dc0c0c07398f"
	timestamp, err := ExtractUUIDv7Timestamp(uuidStr)
	if err != nil {
		fmt.Println("错误:", err)
		return
	}
	
	// 转换为UTC时间(Unix时间戳，毫秒)
	utcTime := time.Unix(int64(timestamp/1000), 0).UTC()
	fmt.Printf("时间戳: %d\n", timestamp)
	fmt.Printf("UTC时间: %s\n", utcTime.Format(time.RFC3339))
}

以上代码提供了多种方法来验证UUID和提取UUIDv7中的时间戳信息。根据您的具体需求选择合适的实现方式。