xorm 框架通过结构体标签 `xorm:"created"` 和 `xorm:"updated"` 实现自动时间戳管理。在调用 create 或 update 方法时,xorm 会自动检测并填充这两个字段,无需手动赋值。默认情况下,created 仅在首次插入时生效,而 updated 在每次更新记录时都会刷新为当前时间。

如何配置 Created 与 Updated 字段类型?
要启用自动时间戳,需在结构体中定义两个时间字段,并使用对应的 XORM 标签。推荐使用 time.Time 类型,并确保标签中指定了正确的数据库列名映射。例如,定义 CreatedAt 和 UpdatedAt 字段,分别绑定到数据库的 created_at 和 updated_at 列。XORM 会在执行插入或更新操作时,自动将当前时间写入这些字段。

创建 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@/test?charset=utf8")
if err != nil {
panic(err)
}
defer engine.Close()
// 同步表结构
err = engine.Sync2(new(User))
if err != nil {
panic(err)
}
// 创建新用户
user := &User{Name: "Alice"}
_, err = engine.Insert(user)
if err != nil {
panic(err)
}
fmt.Printf("Created: %v, Updated: %v\n", user.CreatedAt, user.UpdatedAt)
// 更新用户
user.Name = "Bob"
_, err = engine.Update(user, &User{ID: user.ID})
if err != nil {
panic(err)
}
fmt.Printf("After Update - Created: %v, Updated: %v\n", user.CreatedAt, user.UpdatedAt)
}
Updated 字段在什么条件下会被刷新?
Updated 标签对应的字段会在每次调用 Update 方法时被自动刷新为当前时间。这包括使用条件更新、全量更新或通过主键更新等场景。只要触发了更新操作,且该字段未被显式忽略,XORM 就会将其值设置为当前系统时间。如果希望跳过自动更新时间戳,可以使用 Cols 方法明确指定需要更新的列,从而排除 UpdatedAt 字段。

package main
import (
"fmt"
"time"
_ "github.com/go-sql-driver/mysql"
"xorm.io/xorm"
)
type Product struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50) notnull"`
Price float64 `xorm:"notnull"`
UpdatedAt time.Time `xorm:"updated"`
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@/test?charset=utf8")
if err != nil {
panic(err)
}
defer engine.Close()
engine.Sync2(new(Product))
// 初始插入
product := &Product{Name: "Laptop", Price: 999.99}
engine.Insert(product)
fmt.Printf("Initial UpdatedAt: %v\n", product.UpdatedAt)
// 第一次更新:正常刷新
product.Price = 899.99
engine.Update(product, &Product{ID: product.ID})
fmt.Printf("First Update UpdatedAt: %v\n", product.UpdatedAt)
// 第二次更新:使用 Cols 排除 UpdatedAt,不刷新
product.Price = 799.99
engine.Cols("price").Update(product, &Product{ID: product.ID})
fmt.Printf("Second Update (excluded) UpdatedAt: %v\n", product.UpdatedAt)
}
如果手动设置 UpdatedAt 字段,XORM 会覆盖它吗?
是的,如果手动设置了 UpdatedAt 字段的值,并在后续调用 Update 方法时未使用 Cols 排除该字段,XORM 会将其覆盖为当前时间。这是因为 xorm:"updated" 标签的优先级高于手动赋值。若希望保留手动设置的时间戳,必须在更新前使用 Cols 方法明确指定其他字段,避免触发自动更新机制。这种行为确保了时间戳的一致性,但也要求开发者在需要自定义时间时进行显式控制。

















