go-carbon1.2.0發布了！完善優化對ORM的多場景支持

#                             。

carbon 是一個輕量級、語意化、對開發者友善的Golang時間處理函式庫，支援鍊式呼叫和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")

資料庫支援

假設資料表為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%

完善最佳化對ORM的多場景支援

新增英文版README.MD說明文件

• 統一異常處理
• 統一輸出函數命名規則，將Format() 改為ToFormatString()
• 新增CreateFromGoTime(t time.Time)方法從原生time.Time建立Carbon實例
• 最佳化程式碼組織結構，將不可繼承的最終方法統一放到final.go檔裡
• 廢棄New()初始化函數，無需初始化即可直接使用
• 新增多種時間格式輸出，如Cookie、W3C、RSS、RFC7231
• 新增ParseByDuration()方法解析持續時間字串(相對於今天)，支援正負整數/浮點數和符號ns(奈秒)、us(微妙)、ms(毫秒)、s(秒) 、m(分鐘)、h(小時)的組合
• 新增NextYears()、NextYear()、PreYears()、PreYear()方法防止出現添加/減少指定年時出現跨月的現象
• 新增NextMonths()、NextMonth()、PreMonths()、PreMonth()方法防止出現新增/減少指定月後出現跨月的現象
• 新增DaysInYear()方法取得本年的總天數
• 新增DaysInMonth()方法取得本月的總天數
• #新增MonthOfYear()方法取得本年的第數月
• 新增DayOfYear ()方法取得本年的第幾天
• 新增DayOfMonth()方法取得本月的第幾天
• 新增DayOfWeek()方法取得本週的第幾天
• 新增WeekOfYear()方法取得本年的第幾週
• 新增WeekOfMonth()方法取得本月的第幾週
• 新增IsZero()方法判斷是否是零值時間
• 新增IsFuture()方法判斷是否為未來時間
• 新增IsPast()方法判斷是否為過去時間
• 新增IsNow()方法判斷是否為當前時間

以上是go-carbon1.2.0發布了！完善優化對ORM的多場景支持的詳細內容。更多資訊請關注PHP中文網其他相關文章！