README.cn.md

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

项目简介

Carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库，不依赖于 任何 第三方库， 100% 单元测试覆盖率，已被 docker 组织使用以及被 awesome-go 和 hello-github 收录，并获得 gitee 2024 年最有价值项目（GVP）和 gitcode 2024 年度开源摘星计划 (G-Star) 项目

仓库地址

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/carbon/v2"

Carbon 已经捐赠给了 dromara 开源组织，仓库地址发生了改变，如果之前用的路径是 golang-module/carbon，请在 go.mod 里将原地址更换为新路径，或执行如下命令

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, 你可以为开发者 购买一杯咖啡 或 点击以下赞助广告

• 雨云
  KVM高配版，4核 8G 300M，仅需68元/月起，半年付八折，年付七折，七天无理由退订（送5折券）
  点击购买

• 林枫云
  9950X高防，4核 8G 10M，仅需168元/月，续费同价
  点击购买

• 莱卡云
  浙江电信云，2核 4G 10M，仅需38元/月，续费同价
  点击购买

致谢

Carbon已获取免费的 JetBrains 开源许可证，在此表示感谢

开源协议

Carbon 遵循 MIT 开源协议, 请参阅 LICENSE 查看详细信息。