Go-carbon v2.3.1 发布：一个简洁、语义化且开发者友好的 Golang 日期时间处理包

Go-carbon v2.3.1 发布：一个简洁、语义化且开发者友好的 Golang 日期时间处理包 Go-carbon v2.3.0 圣诞特别版已发布。这应该是 2023 年的最后一个版本。祝大家圣诞快乐！ Carbon 是一个简单、语义化且对开发者友好的 Go 语言日期时间包。

Carbon 已被 awesome-go 收录，如果您觉得它有帮助，请给我一个星标。

github.com/golang-module/carbon

安装

Go 版本 >= 1.16

go get -u github.com/golang-module/carbon/v2

import  "github.com/golang-module/carbon/v2"

JSON 处理

定义模型

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"`
}

或

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"`
}

或

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"`
 
}

如果未设置 carbon 标签，则默认为 layout:2006-01-02 15:04:05；如果未设置 tz 标签，则默认为 Local

实例化模型

now := Parse("2020-08-05 13:14:15", PRC)
person := Person {
  Name:      "gouguoyin",
  Age:       18,
  
  Birthday1: now,
  Birthday2: now,
  Birthday3: now,
  Birthday4: 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"
}

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"
}`
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

更新日志

• 修复在 Now 方法中设置测试当前时间时 testNow 为 0 的问题
• 添加基准测试文件 xxx_bench_test.go
• 添加格式常量，例如 DateTimeFormat、DateFormat、TimeFormat、AtomFormat、ANSICFormat …
• 在 LoadTag 方法中，为结构体 carbon 类型字段的 carbon 标签添加对 datetime、date、time、iso8601 和其他字符串的支持
• 在 loadTag 函数中，为结构体 carbon 类型字段的 tz 标签添加支持，用于设置时区 #207
• 在 ParseByLayout 方法中添加对 U、V、X、Z 格式符号的支持 #206
• 在 ToFormatString 或 Format 方法中添加对 v、u、x 格式符号的支持
• 将 ClearTestNow 方法重命名为 UnSetTestNow
• 将 HasTestNow 方法重命名为 IsSetTestNow
• 将 xxx_test.go 文件重命名为 xxx_unit_test.go
• 将 json.go 文件重命名为 encoding.go，将 json_test.go 文件重命名为 encoding_unit_test.go
• 将 Closest 和 Farthest 方法从 traveler.go 移至 extremum.go，将 traveler_test.go 移至 extremum_unit_test.go
• 将 SetTestNow 方法的接收器类型从 struct 更改为 pointer