下面由golang教程欄目給大家介紹go-carbon 1.2.0 版本,希望對需要的朋友有所幫助!
carbon 是一個輕量級、語義化、對開發(fā)者友好的Golang時間處理庫,支持鏈?zhǔn)秸{(diào)用和gorm、xrom等主流orm
如果您覺得不錯,請給個star吧
github:github.com/golang-module/carbon
gitee:gitee.com/go-package/carbon
安裝使用
// 使用github庫 go get -u github.com/golang-module/carbon import ( "github.com/golang-module/carbon") // 使用gitee庫 go get -u gitee.com/go-package/carbon import ( "gitee.com/go-package/carbon")
數(shù)據(jù)庫支持
假設(shè)數(shù)據(jù)表為users,字段有id(int)、name(varchar)、age(int)、graduated_at(date)、birthday(date)、created_at(datetime)、updated_at(datetime)、deleted_at(datetime)
定義模型
type UserModel struct { ID int64 `json:"id"` Name string `json:"name"` Age int `json:"age"` Birthday carbon.Carbon `json:"birthday"` CreatedAt carbon.ToDateTimeString `json:"created_at"` DeletedAt carbon.ToTimestamp `json:"deleted_at"` GraduatedAt carbon.ToDateString `json:"graduated_at"` UpdatedAt carbon.ToTimeString `json:"updated_at"`}
實例化模型
user := UserModel { Name: "勾國印", Age: 18, Birthday: carbon.Now().SubYears(18), CreatedAt: carbon.ToDateTimeString{carbon.Now()}, DeletedAt: carbon.ToTimestamp{carbon.Parse("2020-08-05 13:14:15")}, GraduatedAt: carbon.ToDateString{carbon.Parse("2012-09-09")}, UpdatedAt: carbon.ToTimeString{carbon.Now()},}
輸出模型字段
user.ID // 18 user.Name // 勾國印 user.Birthday.ToDateString() // 2012-08-05 user.CreatedAt.ToTimestamp() // 2012-08-05 13:14:15 user.DeletedAt.ToDateTimeString() // 1596604455 user.GraduatedAt.AddDay().ToDateString() // 2012-09-10 user.UpdatedAt.ToDateString() // 2012-08-05
JSON輸出模型
data, _ := json.Marshal(&user) fmt.Print(string(data)) // 輸出 { "id": 42, "name": "勾國印", "age": 18, "birthday": "2012-08-05 00:00:00", "created_at": "2020-08-05 13:14:15", "deleted_at": 1596604455 "graduated_at": "2012-09-09", "updated_at": "13:14:15",}
更新日志
- 完善單元測試,代碼覆蓋率100%
- 完善優(yōu)化對ORM的多場景支持
- 新增英文版README.MD說明文檔
- 統(tǒng)一異常處理
- 統(tǒng)一輸出函數(shù)命名規(guī)則,將Format() 改為 ToFormatString()
- 新增CreateFromGoTime(t time.Time)方法從原生time.Time創(chuàng)建Carbon實例
- 優(yōu)化代碼組織結(jié)構(gòu),將不可繼承的最終方法統(tǒng)一放到final.go文件里
- 廢棄New()初始化函數(shù),無需初始化即可直接使用
- 新增多種時間格式輸出,如Cookie、W3C、RSS、RFC7231
- 新增ParseByDuration()方法解析持續(xù)時間字符串(相對于今天),支持正負(fù)整數(shù)/浮點數(shù)和符號ns(納秒)、us(微妙)、ms(毫秒)、s(秒)、m(分鐘)、h(小時)的組合
- 新增NextYears()、NextYear()、PreYears()、PreYear()方法防止出現(xiàn)添加/減少指定年時出現(xiàn)跨月的現(xiàn)象
- 新增NextMonths()、NextMonth()、PreMonths()、PreMonth()方法防止出現(xiàn)添加/減少指定月后出現(xiàn)跨月的現(xiàn)象
- 新增DaysInYear()方法獲取本年的總天數(shù)
- 新增DaysInMonth()方法獲取本月的總天數(shù)
- 新增MonthOfYear()方法獲取本年的第幾月
- 新增DayOfYear()方法獲取本年的第幾天
- 新增DayOfMonth()方法獲取本月的第幾天
- 新增DayOfWeek()方法獲取本周的第幾天
- 新增WeekOfYear()方法獲取本年的第幾周
- 新增WeekOfMonth()方法獲取本月的第幾周
- 新增IsZero()方法判斷是否是零值時間
- 新增IsFuture()方法判斷是否是未來時間
- 新增IsPast()方法判斷是否是過去時間
- 新增IsNow()方法判斷是否是當(dāng)前時間