Go语言自定义数据类型与创建时数据验证实践

// Date 类型是 int64 的别名，用于存储 Unix 时间戳
type Date int64

import (
    "fmt"
    "time"
)

// NewDate 是 Date 类型的工厂函数，用于从字符串创建 Date 实例并进行验证。
// 预期的日期格式为 RFC3339，例如 "2006-01-12T06:06:06Z"。
func NewDate(dateStr string) (Date, error) {
    // 如果字符串为空，可以设定一个默认值，例如当前UTC时间
    if dateStr == "" {
        now := time.Now().UTC()
        // 使用 RFC3339 格式化，确保与解析格式一致
        dateStr = now.Format(time.RFC3339)
    }

    // 尝试解析日期字符串。这是验证的核心步骤。
    // time.Parse 会检查字符串是否符合指定的格式。
    t, err := time.Parse(time.RFC3339, dateStr)
    if err != nil {
        // 如果解析失败，说明日期格式不正确，返回错误
        return 0, fmt.Errorf("invalid date format: %w", err)
    }

    // 如果解析成功，将 time.Time 转换为 Unix 时间戳并返回 Date 类型
    return Date(t.Unix()), nil
}

import "time"

// String 方法为 Date 类型提供可读的字符串表示
func (d Date) String() string {
    // 将 Unix 时间戳转换回 time.Time 对象
    t := time.Unix(int64(d), 0).UTC() // 假设存储的是UTC时间戳
    // 格式化为 RFC3339 字符串
    return t.Format(time.RFC3339)
}

package main

import (
    "fmt"
    "time" // 引入 time 包
)

// Date 类型定义和方法（同上）
type Date int64

func NewDate(dateStr string) (Date, error) {
    if dateStr == "" {
        now := time.Now().UTC()
        dateStr = now.Format(time.RFC3339)
    }
    t, err := time.Parse(time.RFC3339, dateStr)
    if err != nil {
        return 0, fmt.Errorf("invalid date format: %w", err)
    }
    return Date(t.Unix()), nil
}

func (d Date) String() string {
    t := time.Unix(int64(d), 0).UTC()
    return t.Format(time.RFC3339)
}

// Account 结构体包含自定义的 Date 类型字段
type Account struct {
    Domain   string
    Username string
    Created  Date
}

func main() {
    var account Account

    // 示例1: 有效日期字符串
    validDateStr := "2006-01-12T06:06:06Z"
    createdDate, err := NewDate(validDateStr)
    if err == nil {
        account.Created = createdDate
        fmt.Printf("Account created date (valid): %s\n", account.Created)
    } else {
        fmt.Printf("Error setting valid date: %s\n", err)
    }

    // 示例2: 无效日期字符串
    invalidDateStr := "2023/10/26 10:30:00" // 格式不匹配
    _, err = NewDate(invalidDateStr)
    if err != nil {
        fmt.Printf("Error setting invalid date: %s\n", err)
    } else {
        fmt.Println("Unexpected: Invalid date was set successfully.")
    }

    // 示例3: 空日期字符串 (使用默认值)
    emptyDateStr := ""
    defaultDate, err := NewDate(emptyDateStr)
    if err == nil {
        fmt.Printf("Default date (empty string): %s\n", defaultDate)
    } else {
        fmt.Printf("Error setting default date: %s\n", err)
    }
}

Account created date (valid): 2006-01-12T06:06:06Z
Error setting invalid date: invalid date format: parsing time "2023/10/26 10:30:00" as "2006-01-02T15:04:05Z07:00": cannot parse "/10/26 10:30:00" as "2006"
Default date (empty string): 2024-03-01T...Z // 这里的日期会是当前日期