init

app/utils/ulid.go

@@ -0,0 +1,77 @@
+package utils
+
+import (
+	"time"
+
+	"github.com/goravel/framework/support/str"
+	"github.com/oklog/ulid/v2"
+)
+
+// GenerateULID 生成 ULID（默认使用当前时间，与 Laravel 行为一致）
+// 返回: ULID 字符串
+func GenerateULID() string {
+	entropy := ulid.DefaultEntropy()
+	return ulid.MustNew(ulid.Timestamp(time.Now()), entropy).String()
+}
+
+// GenerateULIDWithTime 使用指定时间生成 ULID
+// t: 指定的时间
+// 返回: ULID 字符串
+func GenerateULIDWithTime(t time.Time) string {
+	entropy := ulid.DefaultEntropy()
+	return ulid.MustNew(ulid.Timestamp(t), entropy).String()
+}
+
+// ParseULID 解析 ULID 字符串
+// ulidStr: ULID 字符串
+// 返回: ULID 对象和错误
+func ParseULID(ulidStr string) (ulid.ULID, error) {
+	return ulid.Parse(ulidStr)
+}
+
+// ParseULIDTime 从 ULID 解析出时间
+// ulidStr: ULID 字符串
+// 返回: 时间对象和错误
+func ParseULIDTime(ulidStr string) (time.Time, error) {
+	id, err := ulid.Parse(ulidStr)
+	if err != nil {
+		return time.Time{}, err
+	}
+	return ulid.Time(id.Time()), nil
+}
+
+// ParseULIDTimeString 从 ULID 解析出时间字符串
+// ulidStr: ULID 字符串
+// format: 时间格式，如 DateTimeFormat
+// 返回: 格式化的时间字符串和错误
+func ParseULIDTimeString(ulidStr string, format string) (string, error) {
+	t, err := ParseULIDTime(ulidStr)
+	if err != nil {
+		return "", err
+	}
+	if format == "" {
+		format = DateTimeFormat
+	}
+	return t.Format(format), nil
+}
+
+// IsValidULID 验证 ULID 字符串是否有效
+// 使用 Goravel 框架的字符串库进行验证（与框架的 IsUlid 方法一致）
+// 参考: https://www.goravel.dev/zh_CN/digging-deeper/strings.html#isulid
+// ulidStr: ULID 字符串
+// 返回: 是否有效
+func IsValidULID(ulidStr string) bool {
+	// 使用 Goravel 框架的字符串库验证（框架只提供验证功能，不提供生成功能）
+	return str.Of(ulidStr).IsUlid()
+}
+
+// GetULIDTimestamp 获取 ULID 的时间戳（毫秒）
+// ulidStr: ULID 字符串
+// 返回: Unix 时间戳（毫秒）和错误
+func GetULIDTimestamp(ulidStr string) (int64, error) {
+	id, err := ulid.Parse(ulidStr)
+	if err != nil {
+		return 0, err
+	}
+	return int64(id.Time()), nil
+}