go-carbon v2.3.1 发布,轻量级、语义化、对开发者友好的 Golang 时间处理库
2023-12-29 10:34:11
carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库,支持链式调用。
目前已被 awesome-go 收录,如果您觉得不错,请给个 star 吧
github.com/golang-module/carbon
gitee.com/golang-module/carbon
安装使用
Golang 版本大于等于 1.16
// 使用 github 库
go get -u github.com/golang-module/carbon/v2
import "github.com/golang-module/carbon/v2"
// 使用 gitee 库
go get -u gitee.com/golang-module/carbon/v2
import "gitee.com/golang-module/carbon/v2"
Golang 版本小于 1.16
// 使用 github 库
go get -u github.com/golang-module/carbon
import "github.com/golang-module/carbon"
// 使用 gitee 库
go get -u gitee.com/golang-module/carbon
import "gitee.com/golang-module/carbon"
定义模型
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
Birthday0 Carbon `json:"birthday0"`
Birthday1 Carbon `json:"birthday1" carbon:"date"`
Birthday2 Carbon `json:"birthday2" carbon:"time"`
Birthday3 Carbon `json:"birthday3" carbon:"dateTime"`
Birthday4 Carbon `json:"birthday4" carbon:"date" tz:"PRC"`
Birthday5 Carbon `json:"birthday5" carbon:"time" tz:"PRC"`
Birthday6 Carbon `json:"birthday6" carbon:"dateTime" tz:"PRC"`
}
或
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
Birthday0 Carbon `json:"birthday0"`
Birthday1 Carbon `json:"birthday1" carbon:"layout:2006-01-02"`
Birthday2 Carbon `json:"birthday2" carbon:"layout:15:04:05"`
Birthday3 Carbon `json:"birthday3" carbon:"layout:2006-01-02 15:04:05"`
Birthday4 Carbon `json:"birthday4" carbon:"layout:2006-01-02" tz:"PRC"`
Birthday5 Carbon `json:"birthday5" carbon:"layout:15:04:05" tz:"PRC"`
Birthday6 Carbon `json:"birthday6" carbon:"layout:2006-01-02 15:04:05" tz:"PRC"`
}
或
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
Birthday0 Carbon `json:"birthday0"`
Birthday1 Carbon `json:"birthday1" carbon:"format:Y-m-d"`
Birthday2 Carbon `json:"birthday2" carbon:"format:H:i:s"`
Birthday3 Carbon `json:"birthday3" carbon:"format:Y-m-d H:i:s"`
Birthday4 Carbon `json:"birthday4" carbon:"format:Y-m-d" tz:"PRC"`
Birthday5 Carbon `json:"birthday5" carbon:"format:H:i:s" tz:"PRC"`
Birthday6 Carbon `json:"birthday6" 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,
Birthday0: now,
Birthday1: now,
Birthday2: now,
Birthday3: now,
Birthday4: now,
Birthday5: now,
Birthday6: 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,
"birthday0": "2020-08-05 13:14:15",
"birthday1": "2020-08-05",
"birthday2": "13:14:15",
"birthday3": "2020-08-05 13:14:15",
"birthday4": "2020-08-05",
"birthday5": "213:14:15",
"birthday6": "2020-08-05 13:14:15"
}
JSON 解码
str := `{
"name": "gouguoyin",
"age": 18,
"birthday0": "2020-08-05 13:14:15",
"birthday1": "2020-08-05",
"birthday2": "13:14:15",
"birthday3": "2020-08-05 13:14:15",
"birthday4": "2020-08-05",
"birthday5": "213:14:15",
"birthday6": "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.Birthday0) // 2002-08-05 13:14:15
fmt.Sprintf("%s", person.Birthday1) // 2020-08-05
fmt.Sprintf("%s", person.Birthday2) // 13:14:15
fmt.Sprintf("%s", person.Birthday3) // 2002-08-05 13:14:15
fmt.Sprintf("%s", person.Birthday4) // 2002-08-05
fmt.Sprintf("%s", person.Birthday5) // 13:14:15
fmt.Sprintf("%s", person.Birthday6) // 2002-08-05 13:14:15
更新日志
- 修复在
Now
方法中设置测试时间时testNow
为 0,造成IsSetTestNow
方法返回false
的 bug - 添加性能测试文件
xxx_bench_test.go
- 增加格式模板常量,如
DateTimeFormat
,DateFormat
,TimeFormat
,AtomFormat
,ANSICFormat
- 在
loadTag
函数中carbon
标签增加对datetime
、date
、time
、iso8601
等字符串的支持 - 在
loadTag
函数中新增tz
标签,用于设置时区 - 在
ParseByLayout
方法中添加对U
、V
、X
、Z
格式化符号的支持 - 在
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
方法中接收者类型从结构体
更改为指针
文章来源:https://blog.csdn.net/angelstreet23/article/details/135283911
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。 如若内容造成侵权/违法违规/事实不符,请联系我的编程经验分享网邮箱:veading@qq.com进行投诉反馈,一经查实,立即删除!
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。 如若内容造成侵权/违法违规/事实不符,请联系我的编程经验分享网邮箱:veading@qq.com进行投诉反馈,一经查实,立即删除!