dromara/carbon

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 2,381 Commits
.github		.github
calendar		calendar
docs		docs
lang		lang
tests		tests
LICENSE		LICENSE
README.cn.md		README.cn.md
README.ja.md		README.ja.md
README.ko.md		README.ko.md
README.md		README.md
boundary.go		boundary.go
boundary_bench_test.go		boundary_bench_test.go
boundary_example_test.go		boundary_example_test.go
boundary_unit_test.go		boundary_unit_test.go
calendar.go		calendar.go
calendar_bench_test.go		calendar_bench_test.go
calendar_example_test.go		calendar_example_test.go
calendar_unit_test.go		calendar_unit_test.go
carbon.go		carbon.go
carbon_bench_test.go		carbon_bench_test.go
carbon_example_test.go		carbon_example_test.go
carbon_unit_test.go		carbon_unit_test.go
comparer.go		comparer.go
comparer_bench_test.go		comparer_bench_test.go
comparer_example_test.go		comparer_example_test.go
comparer_unit_test.go		comparer_unit_test.go
constants.go		constants.go
constellation.go		constellation.go
constellation_bench_test.go		constellation_bench_test.go
constellation_example_test.go		constellation_example_test.go
constellation_unit_test.go		constellation_unit_test.go
creator.go		creator.go
creator_bench_test.go		creator_bench_test.go
creator_example_test.go		creator_example_test.go
creator_unit_test.go		creator_unit_test.go
default.go		default.go
default_bench_test.go		default_bench_test.go
default_example_test.go		default_example_test.go
default_unit_test.go		default_unit_test.go
difference.go		difference.go
difference_bench_test.go		difference_bench_test.go
difference_example_test.go		difference_example_test.go
difference_unit_test.go		difference_unit_test.go
errors.go		errors.go
extremum.go		extremum.go
extremum_bench_test.go		extremum_bench_test.go
extremum_example_test.go		extremum_example_test.go
extremum_unit_test.go		extremum_unit_test.go
frozen.go		frozen.go
frozen_bench_test.go		frozen_bench_test.go
frozen_example_test.go		frozen_example_test.go
frozen_unit_test.go		frozen_unit_test.go
getter.go		getter.go
getter_bench_test.go		getter_bench_test.go
getter_example_test.go		getter_example_test.go
getter_unit_test.go		getter_unit_test.go
go.mod		go.mod
go.sum		go.sum
helper.go		helper.go
helper_bench_test.go		helper_bench_test.go
helper_unit_test.go		helper_unit_test.go
language.go		language.go
language_bench_test.go		language_bench_test.go
language_example_test.go		language_example_test.go
language_unit_test.go		language_unit_test.go
outputer.go		outputer.go
outputer_bench_test.go		outputer_bench_test.go
outputer_example_test.go		outputer_example_test.go
outputer_unit_test.go		outputer_unit_test.go
parser.go		parser.go
parser_bench_test.go		parser_bench_test.go
parser_example_test.go		parser_example_test.go
parser_unit_test.go		parser_unit_test.go
season.go		season.go
season_bench_test.go		season_bench_test.go
season_example_test.go		season_example_test.go
season_unit_test.go		season_unit_test.go
setter.go		setter.go
setter_bench_test.go		setter_bench_test.go
setter_example_test.go		setter_example_test.go
setter_unit_test.go		setter_unit_test.go
traveler.go		traveler.go
traveler_bench_test.go		traveler_bench_test.go
traveler_example_test.go		traveler_example_test.go
traveler_unit_test.go		traveler_unit_test.go
type_bench_test.go		type_bench_test.go
type_builtin.go		type_builtin.go
type_carbon.go		type_carbon.go
type_example_test.go		type_example_test.go
type_format.go		type_format.go
type_interface.go		type_interface.go
type_layout.go		type_layout.go
type_timestamp.go		type_timestamp.go
type_unit_test.go		type_unit_test.go

Repository files navigation

carbon

Carbon Release Go Test Go Report Card Go Coverage Carbon Doc Awesome HelloGitHub License

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

Introduction

Carbon is a lightweight, semantic, and developer-friendly golang time package that doesn't depend on any third-party package, has 100% unit test coverage, and has been used by docker organization as well as included by awesome-go and hello-github.

docker

Repository

github.com/dromara/carbon

gitee.com/dromara/carbon

gitcode.com/dromara/carbon

Quick Start

Installation

go version >= 1.18

// Via github
go get -u github.com/dromara/carbon/v2
import "github.com/dromara/carbon/v2"
// Via gitee
go get -u gitee.com/dromara/carbon/v2
import "gitee.com/dromara/carbon/v2"
// Via gitcode
go get -u gitcode.com/dromara/carbon/v2
import "gitcode.com/dromara/gitcode/v2"

Carbon was donated to the dromara organization, the repository URL has changed. If the previous repository used was golang-module/carbon, please replace the original repository with the new repository in go.mod, or execute the following command:

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

Example Usage

Default timezone is UTC, language locale is English, start day of the week is Monday and weekend days of the week are Saturday and Sunday.

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