Go 自定义日期时间格式解析解决方案 – 解决 `parsing time xx as xx: cannot parse xx as xx` 错误
Go 自身的 time.Time 类型默认解析的日期格式是 RFC3339 标准,也就是 2006-01-02T15:04:05Z07:00 的格式。如果我们想要在 Gin 的 shouldBindJSON 方法中,传入 YYYY-MM-DD hh:mm:ss 格式的日期格式作为 time.Time 类型的值,就会引发类似于 parsing time xx as xx: cannot parse xx as xx 的报错信息。这是因为 time.Time 类型默认支持的日期格式与我们传入的格式不同,导致解析出错。。
遇到这个问题后,我在网上找了很多方案,发现都失败了。有的可以完成正常解析,但是无法正确写入到数据库。有的可以正常写入和写出,但是会使得 gin 自带的验证规则如 binding:”required” 规则失效,失去校验的功能。
自定义 LocalTime 类型
解决这个问题的关键就是解决 c.ShouldBindJSON 和 gorm.Updates 的问题,我们需要定义一个新的 Time 类型和自定义的日期格式解析(如下),并将我们的 struct 结构体 datetime 字段指定为我们自定义的类型(如下)
package order type OrderTest struct { OrderId int `json:"order_id"` Test string `json:"test"` PaymentTime *model.LocalTime `json:"payment_time" binding:"required"` TestTime *model.LocalTime `json:"test_time"` }
package model import ( "database/sql/driver" "time" ) const TimeFormat = "2006-01-02 15:04:05" type LocalTime time.Time //bing解析 func (t *LocalTime) UnmarshalJSON(data []byte) (err error) { if len(data) == 2 { *t = LocalTime(time.Time{}) return } now, err := time.Parse(`"`+TimeFormat+`"`, string(data)) *t = LocalTime(now) return } //c.JSON 时解析值的问题 func (t LocalTime) MarshalJSON() ([]byte, error) { b := make([]byte, 0, len(TimeFormat)+2) b = append(b, '"') b = time.Time(t).AppendFormat(b, TimeFormat) b = append(b, '"') return b, nil } // 写入 mysql 时调用 func (t LocalTime) Value() (driver.Value, error) { if t.String() == "0001-01-01 00:00:00" { return nil, nil } return []byte(time.Time(t).Format(TimeFormat)), nil } // 检出 mysql 时调用 func (t *LocalTime) Scan(v interface{}) error { tTime, _ := time.Parse("2006-01-02 15:04:05 +0800 CST", v.(time.Time).String()) *t = LocalTime(tTime) return nil } // 用于 fmt.Println 和后续验证场景 func (t LocalTime) String() string { return time.Time(t).Format(TimeFormat) }
解决验证器 binding:”required” 无法正常工作
在完成上述步骤后,你的 go 应用已经可以正常存取自定义的日期格式格式了。但是还有一个问题,那就是 binding:”required” 并不能正常工作了,如果你传入一个空字符串 “” 日期数据,也会通过校验,并在数据库写入 null!
这个问题是因为 gin 内置的 validator 对我们的 model.LocalTime 还没有一个完善的空值检测机制,我们只需要加上这个检测机制即可。(实现如下)
package app import ( "github.com/go-playground/validator/v10" ) func ValidateJSONDateType(field reflect.Value) interface{} { if field.Type() == reflect.TypeOf(model.LocalTime{}) { timeStr := field.Interface().(model.LocalTime).String() // 0001-01-01 00:00:00 是 go 中 time.Time 类型的空值 // 这里返回 Nil 则会被 validator 判定为空值,而无法通过 `binding:"required"` 规则 if timeStr == "0001-01-01 00:00:00" { return nil } return timeStr } return nil } func Run() { router := gin.Default() if v, ok := binding.Validator.Engine().(*validator.Validate); ok { // 注册 model.LocalTime 类型的自定义校验规则 v.RegisterCustomTypeFunc(ValidateJSONDateType, model.LocalTime{}) } }
加上这条自定义规则后,我们的校验规则又可以生效了,问题完美解决