xorm 框架通过结构体标签 `xorm:"updated"` 配合引擎的 `setmapper` 或全局配置,可以在调用 `update`、`insert` 等方法时自动将当前时间写入指定字段。具体做法是定义包含该标签的结构体,并确保 xorm 引擎已启用自动时间戳功能(默认开启),这样在数据变更时即可自动记录更新时间。

如何定义带自动更新的时间字段
在 Go 结构体中,只需为 time.Time 类型的字段添加 xorm:"updated" 标签即可。XORM 会在执行更新操作时自动检测此标签并填充当前时间。例如,定义一个 User 结构体,其中 Updated 字段即为自动更新时间字段。

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"`
Updated time.Time `xorm:"updated"`
}
func main() {
// 初始化引擎
engine, err := xorm.NewEngine("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")
if err != nil {
panic(err)
}
defer engine.Close()
// 同步表结构
err = engine.Sync2(new(User))
if err != nil {
panic(err)
}
// 插入数据
user := &User{Name: "test"}
_, err = engine.Insert(user)
if err != nil {
panic(err)
}
fmt.Printf("Inserted at: %v\n", user.Updated)
// 更新数据
user.Name = "updated_test"
_, err = engine.Update(user)
if err != nil {
panic(err)
}
fmt.Printf("Updated at: %v\n", user.Updated)
}
上述代码展示了完整的配置与使用流程。首先通过 xorm.NewEngine 创建引擎,然后使用 Sync2 同步表结构。在 Insert 和 Update 调用后,user.Updated 字段会被自动填充为当前时间。注意,Insert 时也会触发 updated 字段的赋值,除非另有 created 标签区分。
如何自定义时间格式与时区
如果需要控制时间的显示格式或时区,可以通过配置引擎的 TZLocation 或使用 SetTableMapper 来调整。XORM 默认使用本地时区,若需统一为 UTC,可在初始化引擎后设置 engine.SetTZLocation(time.UTC)。此外,若需自定义时间列的类型(如 DATETIME 而非 TIMESTAMP),可在标签中指定类型,如 xorm:"updated DATETIME"。

package main
import (
"fmt"
"time"
"xorm.io/xorm"
_ "github.com/go-sql-driver/mysql"
)
type Product struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(100)"`
UpdatedAt time.Time `xorm:"updated DATETIME"`
}
func main() {
engine, _ := xorm.NewEngine("mysql", "root:@tcp(127.0.0.1:3306)/test")
engine.SetTZLocation(time.UTC) // 设置时区为 UTC
engine.Sync2(new(Product))
product := &Product{Name: "Laptop"}
engine.Insert(product)
fmt.Println("Initial UpdatedAt:", product.UpdatedAt)
product.Name = "Gaming Laptop"
engine.Update(product)
fmt.Println("After Update UpdatedAt:", product.UpdatedAt)
}
此示例演示了如何设置时区并指定列类型为 DATETIME。通过 SetTZLocation 确保所有时间操作基于 UTC,避免时区混乱。在 Insert 和 Update 后,UpdatedAt 字段会按指定格式和时区自动更新。开发者可根据实际需求调整时区和列类型,以确保时间记录的一致性。
当使用原生 SQL 时 updated 字段是否会自动更新
当使用原生 SQL 语句进行更新时,xorm:"updated" 标签不会生效,因为 XORM 的自动时间戳功能仅在其 ORM 方法(如 Update、Insert)中触发。若需在使用原生 SQL 时自动更新时间,必须在 SQL 语句中显式指定时间值,例如使用 NOW() 函数。否则,updated 字段将保持原值不变。











