xorm 框架通过结构体标签 created_at 配合 xorm:"created" 来自动处理时间戳。在定义模型时,为 time.time 字段添加该标签,xorm 会在执行 create() 或 insert() 操作时,自动将当前系统时间写入数据库,无需手动赋值。

created_at 标签在创建记录时的具体行为是什么
当使用 XORM 的 Create() 方法插入新数据时,带有 xorm:"created" 标签的字段会被自动填充。如果字段未显式赋值,XORM 会使用 time.Now() 获取当前时间并转换为数据库兼容格式(如 MySQL 的 DATETIME)。若字段已赋值且非零值,则保留原值;若赋值为零值,则可能被覆盖或忽略,取决于驱动和配置。此机制仅适用于新增操作,更新操作不会触发。

package main
import (
"fmt"
"time"
_ "github.com/go-sql-driver/mysql"
"xorm.io/xorm"
)
type User struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50) notnull"`
CreatedAt time.Time `xorm:"created"`
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil {
panic(err)
}
defer engine.Close()
// 确保表存在
engine.Sync2(new(User))
user := &User{Name: "Alice"}
_, err = engine.Insert(user)
if err != nil {
panic(err)
}
fmt.Printf("Inserted User: %+v\n", user)
fmt.Printf("CreatedAt is zero? %v\n", user.CreatedAt.IsZero())
}
运行上述代码后,预期输出中 user.CreatedAt 将包含一个非零的时间值,例如 2023-10-27 10:00:00 +0800 CST,而 ID 由数据库自增生成。这验证了 created 标签在插入时自动填充时间的行为。
更新记录时 created_at 字段会发生变化吗
在 XORM 中,xorm:"created" 标签仅对插入操作生效。当调用 Update() 或 Save() 方法更新现有记录时,带有 created 标签的字段不会被修改,即使你尝试在结构体中更改其值,XORM 也会忽略该字段的更新。这是为了确保创建时间一旦设定便不可变。如果需要追踪最后更新时间,应使用 xorm:"updated" 标签。
创建 UCloud UK8S Kubernetes 集群。Use when user asks to "创建 UK8S 集群", "create UK8S cluster", "新建 Kubernetes 集群".

package main
import (
"fmt"
"time"
_ "github.com/go-sql-driver/mysql"
"xorm.io/xorm"
)
type User struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50) notnull"`
CreatedAt time.Time `xorm:"created"`
UpdatedAt time.Time `xorm:"updated"`
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil {
panic(err)
}
defer engine.Close()
engine.Sync2(new(User))
// 先插入一条记录
user := &User{Name: "Bob"}
engine.Insert(user)
originalCreated := user.CreatedAt
// 模拟经过一段时间
time.Sleep(1 * time.Second)
// 更新名称
user.Name = "Bob Updated"
engine.Update(user)
fmt.Printf("Original CreatedAt: %v\n", originalCreated)
fmt.Printf("Current CreatedAt: %v\n", user.CreatedAt)
fmt.Printf("UpdatedAt changed? %v\n", !user.UpdatedAt.IsZero())
}
运行结果将显示 originalCreated 与 user.CreatedAt 完全相同,证明创建时间在更新操作中保持不变。同时,UpdatedAt 字段会因 xorm:"updated" 标签而被自动设置为当前时间,符合预期。
如果手动设置了 CreatedAt 的值,XORM 还会覆盖它吗
如果在插入前手动为带有 xorm:"created" 标签的 time.Time 字段赋予一个非零值,XORM 默认会尊重该值而不进行覆盖。这意味着你可以指定特定的创建时间,例如导入历史数据时。但若手动赋值为零值(即 time.Time{}),XORM 通常会将其视为未设置,并在插入时自动填充当前时间。这种行为确保了灵活性,同时保持了默认行为的可靠性。










