您现在的位置是:首页 > 文章详情

go-carbon v2.3.2 发布,轻量级、语义化、对开发者友好的 Golang 时间处理库

日期:2024-01-03点击:207

carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库,支持链式调用、农历和 gorm、xorm 等主流 orm。

目前已被 awesome-go-cn 收录,如果您觉得不错,请给个 star 吧

github.com/golang-module/carbon

gitee.com/golang-module/carbon

定义模型

type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    
    Birthday1 Carbon `json:"birthday1"`
    Birthday2 Carbon `json:"birthday2" carbon:"date" tz:"PRC"`
    Birthday3 Carbon `json:"birthday3" carbon:"time" tz:"PRC"`
    Birthday4 Carbon `json:"birthday4" carbon:"dateTime" tz:"PRC"`

    Birthday5 Carbon `json:"birthday5" carbon:"timestamp" tz:"PRC"`
    Birthday6 Carbon `json:"birthday6" carbon:"timestampMilli" tz:"PRC"`
    Birthday7 Carbon `json:"birthday7" carbon:"timestampMicro" tz:"PRC"`
    Birthday8 Carbon `json:"birthday8" carbon:"timestampNano" tz:"PRC"`
}

type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    
    Birthday1 Carbon `json:"birthday1"`
    Birthday2 Carbon `json:"birthday2" carbon:"layout:2006-01-02" tz:"PRC"`
    Birthday3 Carbon `json:"birthday3" carbon:"layout:15:04:05" tz:"PRC"`
    Birthday4 Carbon `json:"birthday4" carbon:"layout:2006-01-02 15:04:05" tz:"PRC"`
	
    Birthday5 Carbon `json:"birthday5" carbon:"timestamp" tz:"PRC"`
    Birthday6 Carbon `json:"birthday6" carbon:"timestampMilli" tz:"PRC"`
    Birthday7 Carbon `json:"birthday7" carbon:"timestampMicro" tz:"PRC"`
    Birthday8 Carbon `json:"birthday8" carbon:"timestampNano" tz:"PRC"`
}

type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    
    Birthday1 Carbon `json:"birthday1"`
    Birthday2 Carbon `json:"birthday2" carbon:"format:Y-m-d" tz:"PRC"`
    Birthday3 Carbon `json:"birthday3" carbon:"format:H:i:s" tz:"PRC"`
    Birthday4 Carbon `json:"birthday4" carbon:"format:Y-m-d H:i:s" tz:"PRC"`

    Birthday5 Carbon `json:"birthday5" carbon:"timestamp" tz:"PRC"`
    Birthday6 Carbon `json:"birthday6" carbon:"timestampMilli" tz:"PRC"`
    Birthday7 Carbon `json:"birthday7" carbon:"timestampMicro" tz:"PRC"`
    Birthday8 Carbon `json:"birthday8" carbon:"timestampNano" tz:"PRC"`
}

实例化模型

now := Parse("2020-08-05 13:14:15", PRC)
person := Person {
    Name:      "gouguoyin",
    Age:       18,
    Birthday1: now,
    Birthday2: now,
    Birthday3: now,
    Birthday4: now,
    Birthday5: now,
    Birthday6: now,
    Birthday7: now,
    Birthday8: now,
}

Json 编码

loadErr := carbon.LoadTag(&person)
if loadErr != nil {
    // 错误处理
    log.Fatal(loadErr)
}
data, marshalErr := json.Marshal(person)
if marshalErr != nil {
    // 错误处理
    log.Fatal(marshalErr)
}
fmt.Printf("%s", data)
// 输出
{
    "name": "gouguoyin",
    "age": 18,
    "birthday1": "2020-08-05 13:14:15",
    "birthday2": "2020-08-05",
    "birthday3": "13:14:15",
    "birthday4": "2020-08-05 13:14:15",
    "birthday5": 1596604455,
    "birthday6": 1596604455999,
    "birthday7": 1596604455999999,
    "birthday8": 1596604455999999999
}

Json 解码

str := `{
    "name": "gouguoyin",
    "age": 18,
    "birthday1": "2020-08-05 13:14:15",
    "birthday2": "2020-08-05",
    "birthday3": "13:14:15",
    "birthday4": "2020-08-05 13:14:15",
    "birthday5": 1596604455,
    "birthday6": 1596604455999,
    "birthday7": 1596604455999999,
    "birthday8": 1596604455999999999
}`
var person Person

loadErr := carbon.LoadTag(&person)
if loadErr != nil {
    // 错误处理
    log.Fatal(loadErr)
}

unmarshalErr := json.Unmarshal([]byte(str), &person)
if unmarshalErr != nil {
    // 错误处理
    log.Fatal(unmarshalErr)
}

fmt.Sprintf("%s", person.Birthday1) // 2002-08-05 13:14:15
fmt.Sprintf("%s", person.Birthday2) // 2020-08-05
fmt.Sprintf("%s", person.Birthday3) // 13:14:15
fmt.Sprintf("%s", person.Birthday4) // 2002-08-05 13:14:15

fmt.Sprintf("%d", person.Birthday5) // 1596604455
fmt.Sprintf("%d", person.Birthday6) // 1596604455999
fmt.Sprintf("%d", person.Birthday7) // 1596604455999999
fmt.Sprintf("%d", person.Birthday8) // 1596604455999999999

更新日志

  • 新增 tag 结构体,优化 LoadTag 方法
  • 结构体中 `carbon` 标签新增时间戳,`MarshalJSON` 方法增加对时间戳的处理
  •  encoding.go 文件中 MarshalJSON 方法新增对 U,V,X,Z 的解析
  • 优化 database.go 文件中的 Scan 方法,将默认时区设置为 Local
  • 优化 outputer.go 文件中 String 方法
  • CreateFromStdTime 方法新增 timezone 可选参数
  • 新增 India 时区常量
  • 提高性能测试覆盖率
原文链接:https://www.oschina.net/news/273917
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

文章评论

共有0条评论来说两句吧...

文章二维码

扫描即可查看该文章

点击排行

推荐阅读

最新文章