在xorm框架中配置created字段自动记录创建时间,需要在结构体标签中设置xorm的created属性。具体做法是在对应的struct field上添加`xorm:"created"`标签,这样在调用create或insert方法时,xorm会自动将当前时间戳填入该字段。

XORM如何识别并处理created标签
XORM通过解析结构体标签中的特定关键字来触发自动填充机制。当标签包含created时,引擎会在执行插入操作前检查该字段类型是否为time.Time或int64等支持时间的类型,若满足条件则直接写入当前系统时间。这一过程发生在SQL构建阶段之前,无需手动赋值即可实现数据入库时的时间追踪。

package main
import (
"fmt"
"log"
"time"
"github.com/go-xorm/xorm"
_ "github.com/mattn/go-sqlite3"
)
type User struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50)"`
Created time.Time `xorm:"created"`
}
func main() {
emg, err := xorm.NewEngine("sqlite3", "test.db")
if err != nil {
log.Fatal(err)
}
defer emg.Close()
err = emg.Sync2(new(User))
if err != nil {
log.Fatal(err)
}
user := &User{Name: "Alice"}
_, err = emg.Insert(user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Inserted ID: %d, Created Time: %v\n", user.ID, user.Created)
}
运行上述代码后,预期输出类似:Inserted ID: 1, Created Time: 2023-10-27 10:00:00 +0800 CST。其中Created字段由XORM自动填充,无需开发者显式设置。
使用int64类型存储created时间戳是否可行
除了使用time.Time类型,还可以使用int64类型配合created标签来实现相同功能。XORM同样支持将当前Unix时间戳(秒级)自动填入int64字段。这种方式适用于需要兼容旧数据库schema或追求轻量级存储的场景。两种写法在行为上一致,区别仅在于底层数据类型和序列化方式。
创建 OpenClaw 专属员工 Agent 的完整配置流程,融合 one-person-company 与 agentgener 技能,支持需求收集到 Agent 上线的闭环。触发条件:用户需创建新 Agent、机器人或制作新 Agent。

package main
import (
"fmt"
"log"
"github.com/go-xorm/xorm"
_ "github.com/mattn/go-sqlite3"
)
type UserInt struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50)"`
Created int64 `xorm:"created"`
}
func main() {
emg, err := xorm.NewEngine("sqlite3", "test_int.db")
if err != nil {
log.Fatal(err)
}
defer emg.Close()
err = emg.Sync2(new(UserInt))
if err != nil {
log.Fatal(err)
}
user := &UserInt{Name: "Bob"}
_, err = emg.Insert(user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Inserted ID: %d, Created Timestamp: %d\n", user.ID, user.Created)
}
运行结果预期为:Inserted ID: 1, Created Timestamp: 1698380400。该值对应当前时间的Unix秒数,与time.Time版本功能等价,但存储更紧凑。
如果同时存在updated标签会怎样处理
当结构体中同时定义created和updated标签时,XORM会在插入时自动填充created字段,而在更新时自动刷新updated字段。两者互不干扰,分别对应生命周期中的不同阶段。created仅在首次插入时生效,后续Update操作不会修改它;而updated每次执行Save或Update都会重新赋值为当前时间。这种设计符合大多数业务场景对审计字段的需求。










