github.com/dromara/carbon @v2.6.16

日本語 | English | 简体中文 | 한국어

イントロ

Carbon は軽量でセマンティックで開発者に優しい golang 時間処理ライブラリで、サードパーティ製ライブラリに依存せず、ユニットテストのカバー率は 100% で、docker に公式採用され、awesome-go と hello-github にも収録されています。

リポジトリ

github.com/dromara/carbon

gitee.com/dromara/carbon

gitcode.com/dromara/carbon

クイックスタート

インストール

go version >= 1.18

// github から使う
go get -u github.com/dromara/carbon/v2
import "github.com/dromara/carbon/v2"

// gitee から使う
go get -u gitee.com/dromara/carbon/v2
import "gitee.com/dromara/carbon/v2"

// gitcode から使う
go get -u gitcode.com/dromara/carbon/v2
import "gitcode.com/dromara/gitcode/v2"

Carbon は dromara 組織に寄付されたためリポジトリのURLが変更されました。以前のリポジトリ golang-module/carbon を使用している場合はgo.modで新しいリポジトリURLに変更するか下記コマンドを実行します

go mod edit -replace github.com/golang-module/carbon/v2 = github.com/dromara/carbon/v2

使い方と例

デフォルトのタイムゾーンはUTC、ロケールは英語、週の開始日は月曜日、週末は土曜日、日曜日。

carbon.SetTestNow(carbon.Parse("2020-08-05 13:14:15.999999999"))
carbon.IsTestNow() // true

carbon.Now().ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Yesterday().ToString() // 2020-08-04 13:14:15.999999999 +0000 UTC
carbon.Tomorrow().ToString() // 2020-08-06 13:14:15.999999999 +0000 UTC

carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2022-03-08T03:01:14-07:00").ToString() // 2022-03-08 10:01:14 +0000 UTC

carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006-01-02 15:04:05").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.ParseByFormat("It is 2020-08-05 13:14:15", "\\I\\t \\i\\s Y-m-d H:i:s").ToString() // 2020-08-05 13:14:15 +0000 UTC

carbon.CreateFromDate(2020, 8, 5).ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.CreateFromTimestamp(1596633255).ToString() // 2020-08-05 13:14:15 +0000 UTC

carbon.Parse("2020-07-05 13:14:15").DiffForHumans() // 1 month before
carbon.Parse("2020-07-05 13:14:15").SetLocale("zh-CN").DiffForHumans() // 1 月前

carbon.ClearTestNow()
carbon.IsTestNow() // false

より多くの使用例については、公式ドキュメントをご覧ください。

性能テストレポートについては、ベンチマークレポートをご参照ください

リファレンス

• briannesbitt/carbon
• nodatime/nodatime
• jinzhu/now
• goframe/gtime
• jodaOrg/joda-time
• arrow-py/arrow
• moment/moment
• iamkun/dayjs

コントリビューター

Carbon に貢献してくれた以下のすべてに感謝します：

翻訳者

Carbon を他のローカライズ言語に翻訳してくださる方を募集しています

Carbon に新しいローカライズ言語サポートを追加する方法

スポンサー

Carbon は非営利のオープンソースプロジェクトです，Carbon をサポートしたい場合は、開発者のために コーヒーを1杯購入 できます

謝辞

Carbon は無料の JetBrains オープンソースライセンスを取得しました，これに感謝します

オープンソースプロトコル

Carbon は MIT オープンソースプロトコルに準拠しており、詳細は LICENSE を参照してください