Go语言时间库golang-module/carbon

已于 2023-06-10 11:11:40 修改
阅读量2.3k 收藏 2
点赞数
分类专栏： golang 文章标签： golang
于 2023-06-09 20:59:50 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_30614345/article/details/131134838
版权

Go语言时间库golang-module/carbon

在 Go 中使用时间可以是一个挑战，特别是当仅依赖内置的 time.Time 包时，例如：

您如何在Go中指定时间的年份或月份?

过去，当我尝试操作时间值时，经常会遇到复杂的代码。

package main

import (
	"fmt"
	"time"
)

func main(){
	// get the current time
	t := time.Now()
	// 2023-06-06 09:30:56.6695375 +0800 CST m=+0.001032001
	fmt.Println(t)
	// change the year to 2020
	newTime := time.Date(2020, t.Month(), t.Day(), t.Hour(), t.Minute(), t.Second(),t.Nanosecond(),t.Location())
	// 2020-06-06 09:30:56.6695375 +0800 CST
	fmt.Println(newTime)
}

这正是 Carbon 的用武之地，它提供了一种优雅高效的解决方案，只需一行简短的代码即可实现。

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
)

func main(){
	t := carbon.Now().SetYear(2020)
	// 2020-06-06 09:33:38
	fmt.Println(t)
}

Carbon提供了许多有用的工具，使在Go中使用时间变得更加可管理，避免了直接处理 time.Time 对象时的烦恼和

麻烦。

carbon 是一个轻量级、语义化、对开发者友好的Golang时间处理库，支持链式调用、农历和gorm、xorm等主流

orm。

carbon GitHub地址：https://github.com/golang-module/carbon

carbon Gitee地址：https://gitee.com/golang-module/carbon

1、安装使用

Golang 版本大于等于 1.16 (推荐)：

// 使用 github 库
go get -u github.com/golang-module/carbon/v2

import (
	"github.com/golang-module/carbon/v2"
)

// 使用 gitee 库
go get -u gitee.com/golang-module/carbon/v2

import (
	"gitee.com/golang-module/carbon/v2"
)

Golang 版本小于 1.16 (必须)：

// 使用 github 库
go get -u github.com/golang-module/carbon

import (
	"github.com/golang-module/carbon"
)

// 使用 gitee 库
go get -u gitee.com/golang-module/carbon

import (
	"gitee.com/golang-module/carbon"
)

carbon 默认时区为 Local，即服务器所在时区。

下面使用的 Go 的版本 1.18.4，carbon 的版本为 v2.2.3。

假设当前时间为 2020-08-05 13:14:15.999999999 +0800 CST。

2、常用方法

2.1 昨天、今天、明天

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
)

func main(){
	// 今天此刻
	fmt.Sprintf("%s", carbon.Now()) // 2020-08-05 13:14:15
	carbon.Now().ToString() // 2020-08-05 13:14:15 +0800 CST
	carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15
	// 今天日期
	carbon.Now().ToDateString() // 2020-08-05
	// 今天时间
	carbon.Now().ToTimeString() // 13:14:15
	// 指定时区的今天此刻
	carbon.Now(carbon.NewYork).ToDateTimeString() // 2020-08-05 14:14:15
	// 今天秒级时间戳
	carbon.Now().Timestamp() // 1596604455
	// 今天毫秒级时间戳
	carbon.Now().TimestampMilli() // 1596604455999
	// 今天微秒级时间戳
	carbon.Now().TimestampMicro() // 1596604455999999
	// 今天纳秒级时间戳
	carbon.Now().TimestampNano() // 1596604455999999999

	// 昨天此刻
	fmt.Sprintf("%s", carbon.Yesterday()) // 2020-08-04 13:14:15
	carbon.Yesterday().ToString() // 2020-08-04 13:14:15 +0800 CST
	carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15
	// 昨天日期
	carbon.Yesterday().ToDateString() // 2020-08-04
	// 昨天时间
	carbon.Yesterday().ToTimeString() // 13:14:15
	// 指定日期的昨天此刻
	carbon.Parse("2021-01-28 13:14:15").Yesterday().ToDateTimeString() // 2021-01-27 13:14:15
	// 指定时区的昨天此刻
	carbon.Yesterday(carbon.NewYork).ToDateTimeString() // 2020-08-04 14:14:15
	// 昨天秒级时间戳
	carbon.Yesterday().Timestamp() // 1596518055
	// 昨天毫秒级时间戳
	carbon.Yesterday().TimestampMilli() // 1596518055999
	// 昨天微秒级时间戳
	carbon.Yesterday().TimestampMicro() // 1596518055999999
	// 昨天纳秒级时间戳
	carbon.Yesterday().TimestampNano() // 1596518055999999999

	// 明天此刻
	fmt.Sprintf("%s", carbon.Tomorrow()) // 2020-08-06 13:14:15
	carbon.Tomorrow().ToString() // 2020-08-06 13:14:15 +0800 CST
	carbon.Tomorrow().ToDateTimeString() // 2020-08-06 13:14:15
	// 明天日期
	carbon.Tomorrow().ToDateString() // 2020-08-06
	// 明天时间
	carbon.Tomorrow().ToTimeString() // 13:14:15
	// 指定日期的明天此刻
	carbon.Parse("2021-01-28 13:14:15").Tomorrow().ToDateTimeString() // 2021-01-29 13:14:15
	// 指定时区的明天此刻
	carbon.Tomorrow(carbon.NewYork).ToDateTimeString() // 2020-08-06 14:14:15
	// 明天秒级时间戳
	carbon.Tomorrow().Timestamp() // 1596690855
	// 明天毫秒级时间戳
	carbon.Tomorrow().TimestampMilli() // 1596690855999
	// 明天微秒级时间戳
	carbon.Tomorrow().TimestampMicro() // 1596690855999999
	// 明天纳秒级时间戳
	carbon.Tomorrow().TimestampNano() // 1596690855999999999
}

2.2 创建 Carbon 实例

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main(){
	// 从秒级时间戳创建 Carbon 实例
	carbon.CreateFromTimestamp(-1).ToString() // 1970-01-01 07:59:59 +0800 CST
	carbon.CreateFromTimestamp(0).ToString() // 1970-01-01 08:00:00 +0800 CST
	carbon.CreateFromTimestamp(1).ToString() // 1970-01-01 08:00:01 +0800 CST
	carbon.CreateFromTimestamp(1649735755).ToString() // 2022-04-12 11:55:55 +0800 CST
	// 从毫秒级时间戳创建 Carbon 实例
	carbon.CreateFromTimestampMilli(1649735755981).ToString() // 2022-04-12 11:55:55.981 +0800 CST
	// 从微秒级时间戳创建 Carbon 实例
	carbon.CreateFromTimestampMicro(1649735755981566).ToString() // 2022-04-12 11:55:55.981566 +0800 CST
	// 从纳秒级时间戳创建 Carbon 实例
	carbon.CreateFromTimestampNano(1649735755981566000).ToString() // 2022-04-12 11:55:55.981566 +0800 CST

	// 从年月日时分秒创建 Carbon 实例
	carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
	// 从年月日时分秒创建 Carbon 实例，包含毫秒
	carbon.CreateFromDateTimeMilli(2020, 8, 5, 13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
	// 从年月日时分秒创建 Carbon 实例，包含微秒
	carbon.CreateFromDateTimeMicro(2020, 8, 5, 13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
	// 从年月日时分秒创建 Carbon 实例，包含纳秒
	carbon.CreateFromDateTimeNano(2020, 8, 5, 13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

	// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)
	carbon.CreateFromDate(2020, 8, 5).ToString() // // 2020-08-05 13:14:15 +0800 CST
	// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含毫秒
	carbon.CreateFromDateMilli(2020, 8, 5, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
	// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含微秒
	carbon.CreateFromDateMicro(2020, 8, 5, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
	// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含纳秒
	carbon.CreateFromDateNano(2020, 8, 5, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

	// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)
	carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
	// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含毫秒
	carbon.CreateFromTimeMilli(13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
	// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含微秒
	carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
	// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含纳秒
	carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
}

2.3 将时间字符串解析成 Carbon 实例

package main

import (
   "github.com/golang-module/carbon/v2"
)

func main() {
   carbon.Parse("").ToDateTimeString()                    // 空字符串
   carbon.Parse("0").ToDateTimeString()                   // 空字符串
   carbon.Parse("00:00:00").ToDateTimeString()            // 空字符串
   carbon.Parse("0000-00-00").ToDateTimeString()          // 空字符串
   carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空字符串

   carbon.Parse("now").ToString()       // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("yesterday").ToString() // 2020-08-04 13:14:15 +0800 CST
   carbon.Parse("tomorrow").ToString()  // 2020-08-06 13:14:15 +0800 CST

   carbon.Parse("2020").ToString()                 // 2020-01-01 00:00:00 +0800 CST
   carbon.Parse("2020-8").ToString()               // 2020-08-01 00:00:00 +0800 CST
   carbon.Parse("2020-08").ToString()              // 2020-08-01 00:00:00 +0800 CST
   carbon.Parse("2020-8-5").ToString()             // 2020-08-05 00:00:00 +0800 CST
   carbon.Parse("2020-8-05").ToString()            // 2020-08-05 00:00:00 +0800 CST
   carbon.Parse("2020-08-05").ToString()           // 2020-08-05 00:00:00 +0800 CST
   carbon.Parse("2020-08-05.999").ToString()       // 2020-08-05 00:00:00.999 +0800 CST
   carbon.Parse("2020-08-05.999999").ToString()    // 2020-08-05 00:00:00.999999 +0800 CST
   carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0800 CST

   carbon.Parse("2020-8-5 13:14:15").ToString()             // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-8-05 13:14:15").ToString()            // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-08-5 13:14:15").ToString()            // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-08-05 13:14:15").ToString()           // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-08-05 13:14:15.999").ToString()       // 2020-08-05 13:14:15.999 +0800 CST
   carbon.Parse("2020-08-05 13:14:15.999999").ToString()    // 2020-08-05 13:14:15.999999 +0800 CST
   carbon.Parse("2020-08-05 13:14:15.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

   carbon.Parse("2020-8-5T13:14:15+08:00").ToString()             // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-8-05T13:14:15+08:00").ToString()            // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-08-05T13:14:15+08:00").ToString()           // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("2020-08-05T13:14:15.999+08:00").ToString()       // 2020-08-05 13:14:15.999 +0800 CST
   carbon.Parse("2020-08-05T13:14:15.999999+08:00").ToString()    // 2020-08-05 13:14:15.999999 +0800 CST
   carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

   carbon.Parse("20200805").ToString()                       // 2020-08-05 00:00:00 +0800 CST
   carbon.Parse("20200805131415").ToString()                 // 2020-08-05 13:14:15 +0800 CST
   carbon.Parse("20200805131415.999").ToString()             // 2020-08-05 13:14:15.999 +0800 CST
   carbon.Parse("20200805131415.999999").ToString()          // 2020-08-05 13:14:15.999999 +0800 CST
   carbon.Parse("20200805131415.999999999").ToString()       // 2020-08-05 13:14:15.999999999 +0800 CST
   carbon.Parse("20200805131415.999+08:00").ToString()       // 2020-08-05 13:14:15.999 +0800 CST
   carbon.Parse("20200805131415.999999+08:00").ToString()    // 2020-08-05 13:14:15.999999 +0800 CST
   carbon.Parse("20200805131415.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
}

2.4 通过格式模板将时间字符串解析成 Carbon 实例。

如果使用的字母与格式模板冲突时，请使用转义符转义该字母。

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main() {
	carbon.ParseByFormat("2020|08|05 13|14|15", "Y|m|d H|i|s").ToDateTimeString()                     // 2020-08-05 13:14:15
	carbon.ParseByFormat("It is 2020-08-05 13:14:15", "\\I\\t \\i\\s Y-m-d H:i:s").ToDateTimeString() // 2020-08-05 13:14:15
	carbon.ParseByFormat("今天是 2020年08月05日13时14分15秒", "今天是 Y年m月d日H时i分s秒").ToDateTimeString()           // 2020-08-05 13:14:15
	carbon.ParseByFormat("2020-08-05 13:14:15", "Y-m-d H:i:s", carbon.Tokyo).ToDateTimeString()       // 2020-08-05 14:14:15
}

2.5 通过布局模板将时间字符串解析成 Carbon 实例。

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main() {
	carbon.ParseByLayout("2020|08|05 13|14|15", "2006|01|02 15|04|05").ToDateTimeString()               // 2020-08-05 13:14:15
	carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006-01-02 15:04:05").ToDateTimeString()   // 2020-08-05 13:14:15
	carbon.ParseByLayout("今天是 2020年08月05日13时14分15秒", "今天是 2006年01月02日15时04分05秒").ToDateTimeString()     // 2020-08-05 13:14:15
	carbon.ParseByLayout("2020-08-05 13:14:15", "2006-01-02 15:04:05", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
}

2.6 Carbon 和 time.Time 互转

package main

import (
	"github.com/golang-module/carbon/v2"
	"time"
)

func main() {
	// 将 time.Time 转换成 Carbon
	carbon.FromStdTime(time.Now())
	// 将 Carbon 转换成 time.Time
	carbon.Now().ToStdTime()
}

2.7 开始时间、结束时间

package main


import (
	"github.com/golang-module/carbon/v2"
	"time"
)

func main() {
	// 本世纪开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfCentury().ToDateTimeString() // 2000-01-01 00:00:00
	// 本世纪结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfCentury().ToDateTimeString() // 2999-12-31 23:59:59

	// 本年代开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
	carbon.Parse("2021-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
	carbon.Parse("2029-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
	// 本年代结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
	carbon.Parse("2021-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
	carbon.Parse("2029-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59

	// 本年开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfYear().ToDateTimeString() // 2020-01-01 00:00:00
	// 本年结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfYear().ToDateTimeString() // 2020-12-31 23:59:59

	// 本季度开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfQuarter().ToDateTimeString() // 2020-07-01 00:00:00
	// 本季度结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfQuarter().ToDateTimeString() // 2020-09-30 23:59:59

	// 本月开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfMonth().ToDateTimeString() // 2020-08-01 00:00:00
	// 本月结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfMonth().ToDateTimeString() // 2020-08-31 23:59:59

	// 本周开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
	carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
	carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).StartOfWeek().ToDateTimeString() // 2020-08-03 00:00:00
	// 本周结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
	carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
	carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).EndOfWeek().ToDateTimeString() // 2020-08-09 23:59:59

	// 本日开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfDay().ToDateTimeString() // 2020-08-05 00:00:00
	// 本日结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfDay().ToDateTimeString() // 2020-08-05 23:59:59

	// 本小时开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfHour().ToDateTimeString() // 2020-08-05 13:00:00
	// 本小时结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfHour().ToDateTimeString() // 2020-08-05 13:59:59

	// 本分钟开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfMinute().ToDateTimeString() // 2020-08-05 13:14:00
	// 本分钟结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfMinute().ToDateTimeString() // 2020-08-05 13:14:59

	// 本秒开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfSecond().ToString() // 2020-08-05 13:14:15 +0800 CST
	// 本秒结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfSecond().ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
}

2.8 时间旅行

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main(){
	// 三个世纪后
	carbon.Parse("2020-02-29 13:14:15").AddCenturies(3).ToDateTimeString() // 2320-02-29 13:14:15
	// 三个世纪后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddCenturiesNoOverflow(3).ToDateTimeString() // 2320-02-29 13:14:15
	// 一个世纪后
	carbon.Parse("2020-02-29 13:14:15").AddCentury().ToDateTimeString() // 2120-02-29 13:14:15
	// 一个世纪后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddCenturyNoOverflow().ToDateTimeString() // 2120-02-29 13:14:15
	// 三个世纪前
	carbon.Parse("2020-02-29 13:14:15").SubCenturies(3).ToDateTimeString() // 1720-02-29 13:14:15
	// 三个世纪前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubCenturiesNoOverflow(3).ToDateTimeString() // 1720-02-29 13:14:15
	// 一个世纪前
	carbon.Parse("2020-02-29 13:14:15").SubCentury().ToDateTimeString() // 1920-02-29 13:14:15
	// 一世纪前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubCenturyNoOverflow().ToDateTimeString() // 1920-02-29 13:14:15

	// 三个年代后
	carbon.Parse("2020-02-29 13:14:15").AddDecades(3).ToDateTimeString() // 2050-03-01 13:14:15
	// 三个年代后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddDecadesNoOverflow(3).ToDateTimeString() // 2050-02-28 13:14:15
	// 一个年代后
	carbon.Parse("2020-02-29 13:14:15").AddDecade().ToDateTimeString() // 2030-03-01 13:14:15
	// 一个年代后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddDecadeNoOverflow().ToDateTimeString() // 2030-02-28 13:14:15
	// 三个年代前
	carbon.Parse("2020-02-29 13:14:15").SubDecades(3).ToDateTimeString() // 1990-03-01 13:14:15
	// 三个年代前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubDecadesNoOverflow(3).ToDateTimeString() // 1990-02-28 13:14:15
	// 一个年代前
	carbon.Parse("2020-02-29 13:14:15").SubDecade().ToDateTimeString() // 2010-03-01 13:14:15
	// 一个年代前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubDecadeNoOverflow().ToDateTimeString() // 2010-02-28 13:14:15

	// 三年后
	carbon.Parse("2020-02-29 13:14:15").AddYears(3).ToDateTimeString() // 2023-03-01 13:14:15
	// 三年后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddYearsNoOverflow(3).ToDateTimeString() // 2023-02-28 13:14:15
	// 一年后
	carbon.Parse("2020-02-29 13:14:15").AddYear().ToDateTimeString() // 2021-03-01 13:14:15
	// 一年后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddYearNoOverflow().ToDateTimeString() // 2021-02-28 13:14:15
	// 三年前
	carbon.Parse("2020-02-29 13:14:15").SubYears(3).ToDateTimeString() // 2017-03-01 13:14:15
	// 三年前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubYearsNoOverflow(3).ToDateTimeString() // 2017-02-28 13:14:15
	// 一年前
	carbon.Parse("2020-02-29 13:14:15").SubYear().ToDateTimeString() // 2019-03-01 13:14:15
	// 一年前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubYearNoOverflow().ToDateTimeString() // 2019-02-28 13:14:15

	// 三个季度后
	carbon.Parse("2019-08-31 13:14:15").AddQuarters(3).ToDateTimeString() // 2019-03-02 13:14:15
	// 三个季度后(月份不溢出)
	carbon.Parse("2019-08-31 13:14:15").AddQuartersNoOverflow(3).ToDateTimeString() // 2019-02-29 13:14:15
	// 一个季度后
	carbon.Parse("2019-11-30 13:14:15").AddQuarter().ToDateTimeString() // 2020-03-01 13:14:15
	// 一个季度后(月份不溢出)
	carbon.Parse("2019-11-30 13:14:15").AddQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
	// 三个季度前
	carbon.Parse("2019-08-31 13:14:15").SubQuarters(3).ToDateTimeString() // 2019-03-03 13:14:15
	// 三个季度前(月份不溢出)
	carbon.Parse("2019-08-31 13:14:15").SubQuartersNoOverflow(3).ToDateTimeString() // 2019-02-28 13:14:15
	// 一个季度前
	carbon.Parse("2020-05-31 13:14:15").SubQuarter().ToDateTimeString() // 2020-03-02 13:14:15
	// 一个季度前(月份不溢出)
	carbon.Parse("2020-05-31 13:14:15").SubQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15

	// 三个月后
	carbon.Parse("2020-02-29 13:14:15").AddMonths(3).ToDateTimeString() // 2020-05-29 13:14:15
	// 三个月后(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").AddMonthsNoOverflow(3).ToDateTimeString() // 2020-05-29 13:14:15
	// 一个月后
	carbon.Parse("2020-01-31 13:14:15").AddMonth().ToDateTimeString() // 2020-03-02 13:14:15
	// 一个月后(月份不溢出)
	carbon.Parse("2020-01-31 13:14:15").AddMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
	// 三个月前
	carbon.Parse("2020-02-29 13:14:15").SubMonths(3).ToDateTimeString() // 2019-11-29 13:14:15
	// 三个月前(月份不溢出)
	carbon.Parse("2020-02-29 13:14:15").SubMonthsNoOverflow(3).ToDateTimeString() // 2019-11-29 13:14:15
	// 一个月前
	carbon.Parse("2020-03-31 13:14:15").SubMonth().ToDateTimeString() // 2020-03-02 13:14:15
	// 一个月前(月份不溢出)
	carbon.Parse("2020-03-31 13:14:15").SubMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15

	// 三周后
	carbon.Parse("2020-02-29 13:14:15").AddWeeks(3).ToDateTimeString() // 2020-03-21 13:14:15
	// 一周后
	carbon.Parse("2020-02-29 13:14:15").AddWeek().ToDateTimeString() // 2020-03-07 13:14:15
	// 三周前
	carbon.Parse("2020-02-29 13:14:15").SubWeeks(3).ToDateTimeString() // 2020-02-08 13:14:15
	// 一周前
	carbon.Parse("2020-02-29 13:14:15").SubWeek().ToDateTimeString() // 2020-02-22 13:14:15

	// 三天后
	carbon.Parse("2020-08-05 13:14:15").AddDays(3).ToDateTimeString() // 2020-08-08 13:14:15
	// 一天后
	carbon.Parse("2020-08-05 13:14:15").AddDay().ToDateTimeString() // 2020-08-05 13:14:15
	// 三天前
	carbon.Parse("2020-08-05 13:14:15").SubDays(3).ToDateTimeString() // 2020-08-02 13:14:15
	// 一天前
	carbon.Parse("2020-08-05 13:14:15").SubDay().ToDateTimeString() // 2020-08-04 13:14:15

	// 三小时后
	carbon.Parse("2020-08-05 13:14:15").AddHours(3).ToDateTimeString() // 2020-08-05 16:14:15
	// 二小时半后
	carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5h").ToDateTimeString() // 2020-08-05 15:44:15
	carbon.Parse("2020-08-05 13:14:15").AddDuration("2h30m").ToDateTimeString() // 2020-08-05 15:44:15
	// 一小时后
	carbon.Parse("2020-08-05 13:14:15").AddHour().ToDateTimeString() // 2020-08-05 14:14:15
	// 三小时前
	carbon.Parse("2020-08-05 13:14:15").SubHours(3).ToDateTimeString() // 2020-08-05 10:14:15
	// 二小时半前
	carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5h").ToDateTimeString() // 2020-08-05 10:44:15
	carbon.Parse("2020-08-05 13:14:15").SubDuration("2h30m").ToDateTimeString() // 2020-08-05 10:44:15
	// 一小时前
	carbon.Parse("2020-08-05 13:14:15").SubHour().ToDateTimeString() // 2020-08-05 12:14:15

	// 三分钟后
	carbon.Parse("2020-08-05 13:14:15").AddMinutes(3).ToDateTimeString() // 2020-08-05 13:17:15
	// 二分钟半后
	carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5m").ToDateTimeString() // 2020-08-05 13:16:45
	carbon.Parse("2020-08-05 13:14:15").AddDuration("2m30s").ToDateTimeString() // 2020-08-05 13:16:45
	// 一分钟后
	carbon.Parse("2020-08-05 13:14:15").AddMinute().ToDateTimeString() // 2020-08-05 13:15:15
	// 三分钟前
	carbon.Parse("2020-08-05 13:14:15").SubMinutes(3).ToDateTimeString() // 2020-08-05 13:11:15
	// 二分钟半前
	carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5m").ToDateTimeString() // 2020-08-05 13:11:45
	carbon.Parse("2020-08-05 13:14:15").SubDuration("2m30s").ToDateTimeString() // 2020-08-05 13:11:45
	// 一分钟前
	carbon.Parse("2020-08-05 13:14:15").SubMinute().ToDateTimeString() // 2020-08-05 13:13:15

	// 三秒钟后
	carbon.Parse("2020-08-05 13:14:15").AddSeconds(3).ToDateTimeString() // 2020-08-05 13:14:18
	// 二秒钟半后
	carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:17
	// 一秒钟后
	carbon.Parse("2020-08-05 13:14:15").AddSecond().ToDateTimeString() // 2020-08-05 13:14:16
	// 三秒钟前
	carbon.Parse("2020-08-05 13:14:15").SubSeconds(3).ToDateTimeString() // 2020-08-05 13:14:12
	// 二秒钟半前
	carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:12
	// 一秒钟前
	carbon.Parse("2020-08-05 13:14:15").SubSecond().ToDateTimeString() // 2020-08-05 13:14:14

	// 三毫秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddMilliseconds(3).ToString() // 2020-08-05 13:14:15.225222222 +0800 CST
	// 一毫秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddMillisecond().ToString() // 2020-08-05 13:14:15.223222222 +0800 CST
	// 三毫秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubMilliseconds(3).ToString() // 2020-08-05 13:14:15.219222222 +0800 CST
	// 一毫秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubMillisecond().ToString() // 2020-08-05 13:14:15.221222222 +0800 CST

	// 三微秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddMicroseconds(3).ToString() // 2020-08-05 13:14:15.222225222 +0800 CST
	// 一微秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddMicrosecond().ToString() // 2020-08-05 13:14:15.222223222 +0800 CST
	// 三微秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubMicroseconds(3).ToString() // 2020-08-05 13:14:15.222219222 +0800 CST
	// 一微秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubMicrosecond().ToString() // 2020-08-05 13:14:15.222221222 +0800 CST

	// 三纳秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222225 +0800 CST
	// 一纳秒后
	carbon.Parse("2020-08-05 13:14:15.222222222").AddNanosecond().ToString() // 2020-08-05 13:14:15.222222223 +0800 CST
	// 三纳秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222219 +0800 CST
	// 一纳秒前
	carbon.Parse("2020-08-05 13:14:15.222222222").SubNanosecond().ToString() // 2020-08-05 13:14:15.222222221 +0800 CST
}

2.9 时间差

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main(){
	// 相差多少年
	carbon.Parse("2021-08-05 13:14:15").DiffInYears(carbon.Parse("2020-08-05 13:14:15")) // -1
	// 相差多少年（绝对值）
	carbon.Parse("2021-08-05 13:14:15").DiffAbsInYears(carbon.Parse("2020-08-05 13:14:15")) // 1

	// 相差多少月
	carbon.Parse("2020-08-05 13:14:15").DiffInMonths(carbon.Parse("2020-07-05 13:14:15")) // -1
	// 相差多少月（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInMonths(carbon.Parse("2020-07-05 13:14:15")) // 1

	// 相差多少周
	carbon.Parse("2020-08-05 13:14:15").DiffInWeeks(carbon.Parse("2020-07-28 13:14:15")) // -1
	// 相差多少周（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInWeeks(carbon.Parse("2020-07-28 13:14:15")) // 1

	// 相差多少天
	carbon.Parse("2020-08-05 13:14:15").DiffInDays(carbon.Parse("2020-08-04 13:14:15")) // -1
	// 相差多少天（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInDays(carbon.Parse("2020-08-04 13:14:15")) // 1

	// 相差多少小时
	carbon.Parse("2020-08-05 13:14:15").DiffInHours(carbon.Parse("2020-08-05 12:14:15")) // -1
	// 相差多少小时（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInHours(carbon.Parse("2020-08-05 12:14:15")) // 1

	// 相差多少分
	carbon.Parse("2020-08-05 13:14:15").DiffInMinutes(carbon.Parse("2020-08-05 13:13:15")) // -1
	// 相差多少分（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInMinutes(carbon.Parse("2020-08-05 13:13:15")) // 1

	// 相差多少秒
	carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14:14")) // -1
	// 相差多少秒（绝对值）
	carbon.Parse("2020-08-05 13:14:15").DiffAbsInSeconds(carbon.Parse("2020-08-05 13:14:14")) // 1

	// 相差字符串
	carbon.Now().DiffInString() // just now
	carbon.Now().AddYearsNoOverflow(1).DiffInString() // -1 year
	carbon.Now().SubYearsNoOverflow(1).DiffInString() // 1 year
	// 相差字符串（绝对值）
	carbon.Now().DiffAbsInString(carbon.Now()) // just now
	carbon.Now().AddYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 year
	carbon.Now().SubYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 year

	// 对人类友好的可读格式时间差
	carbon.Parse("2020-08-05 13:14:15").DiffForHumans() // just now
	carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // 1 year ago
	carbon.Parse("2018-08-05 13:14:15").DiffForHumans() // 2 years ago
	carbon.Parse("2021-08-05 13:14:15").DiffForHumans() // 1 year from now
	carbon.Parse("2022-08-05 13:14:15").DiffForHumans() // 2 years from now

	carbon.Parse("2020-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year before
	carbon.Parse("2019-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years before
	carbon.Parse("2018-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year after
	carbon.Parse("2022-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years after
}

2.10 时间判断

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main() {
	// 是否是零值时间
	carbon.Parse("").IsZero()                              // true
	carbon.Parse("0").IsZero()                             // true
	carbon.Parse("0000-00-00 00:00:00").IsZero()           // true
	carbon.Parse("0000-00-00").IsZero()                    // true
	carbon.Parse("00:00:00").IsZero()                      // true
	carbon.Parse("2020-08-05 00:00:00").IsZero()           // false
	carbon.Parse("2020-08-05").IsZero()                    // false
	carbon.Parse("2020-08-05").SetTimezone("xxx").IsZero() // false

	// 是否是有效时间
	carbon.Parse("").IsValid()                              // false
	carbon.Parse("0").IsValid()                             // false
	carbon.Parse("0000-00-00 00:00:00").IsValid()           // false
	carbon.Parse("0000-00-00").IsValid()                    // false
	carbon.Parse("00:00:00").IsValid()                      // false
	carbon.Parse("2020-08-05 00:00:00").IsValid()           // true
	carbon.Parse("2020-08-05").IsValid()                    // true
	carbon.Parse("2020-08-05").SetTimezone("xxx").IsValid() // false

	// 是否是无效时间
	carbon.Parse("").IsInvalid()                              // true
	carbon.Parse("0").IsInvalid()                             // true
	carbon.Parse("0000-00-00 00:00:00").IsInvalid()           // true
	carbon.Parse("0000-00-00").IsInvalid()                    // true
	carbon.Parse("00:00:00").IsInvalid()                      // true
	carbon.Parse("2020-08-05 00:00:00").IsInvalid()           // false
	carbon.Parse("2020-08-05").IsInvalid()                    // false
	carbon.Parse("2020-08-05").SetTimezone("xxx").IsInvalid() // true

	// 是否是当前时间
	carbon.Now().IsNow() // true
	// 是否是未来时间
	carbon.Tomorrow().IsFuture() // true
	// 是否是过去时间
	carbon.Yesterday().IsPast() // true

	// 是否是闰年
	carbon.Parse("2020-08-05 13:14:15").IsLeapYear() // true
	// 是否是长年
	carbon.Parse("2020-08-05 13:14:15").IsLongYear() // true

	// 是否是一月
	carbon.Parse("2020-08-05 13:14:15").IsJanuary() // false
	// 是否是二月
	carbon.Parse("2020-08-05 13:14:15").IsFebruary() // false
	// 是否是三月
	carbon.Parse("2020-08-05 13:14:15").IsMarch() // false
	// 是否是四月
	carbon.Parse("2020-08-05 13:14:15").IsApril() // false
	// 是否是五月
	carbon.Parse("2020-08-05 13:14:15").IsMay() // false
	// 是否是六月
	carbon.Parse("2020-08-05 13:14:15").IsJune() // false
	// 是否是七月
	carbon.Parse("2020-08-05 13:14:15").IsJuly() // false
	// 是否是八月
	carbon.Parse("2020-08-05 13:14:15").IsAugust() // false
	// 是否是九月
	carbon.Parse("2020-08-05 13:14:15").IsSeptember() // true
	// 是否是十月
	carbon.Parse("2020-08-05 13:14:15").IsOctober() // false
	// 是否是十一月
	carbon.Parse("2020-08-05 13:14:15").IsNovember() // false
	// 是否是十二月
	carbon.Parse("2020-08-05 13:14:15").IsDecember() // false

	// 是否是周一
	carbon.Parse("2020-08-05 13:14:15").IsMonday() // false
	// 是否是周二
	carbon.Parse("2020-08-05 13:14:15").IsTuesday() // true
	// 是否是周三
	carbon.Parse("2020-08-05 13:14:15").IsWednesday() // false
	// 是否是周四
	carbon.Parse("2020-08-05 13:14:15").IsThursday() // false
	// 是否是周五
	carbon.Parse("2020-08-05 13:14:15").IsFriday() // false
	// 是否是周六
	carbon.Parse("2020-08-05 13:14:15").IsSaturday() // false
	// 是否是周日
	carbon.Parse("2020-08-05 13:14:15").IsSunday() // false

	// 是否是工作日
	carbon.Parse("2020-08-05 13:14:15").IsWeekday() // false
	// 是否是周末
	carbon.Parse("2020-08-05 13:14:15").IsWeekend() // true

	// 是否是昨天
	carbon.Parse("2020-08-04 13:14:15").IsYesterday() // true
	carbon.Parse("2020-08-04 00:00:00").IsYesterday() // true
	carbon.Parse("2020-08-04").IsYesterday()          // true
	// 是否是今天
	carbon.Parse("2020-08-05 13:14:15").IsToday() // true
	carbon.Parse("2020-08-05 00:00:00").IsToday() // true
	carbon.Parse("2020-08-05").IsToday()          // true
	// 是否是明天
	carbon.Parse("2020-08-06 13:14:15").IsTomorrow() // true
	carbon.Parse("2020-08-06 00:00:00").IsTomorrow() // true
	carbon.Parse("2020-08-06").IsTomorrow()          // true

	// 是否是同一世纪
	carbon.Parse("2020-08-05 13:14:15").IsSameCentury(carbon.Parse("3020-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 13:14:15").IsSameCentury(carbon.Parse("2099-08-05 13:14:15")) // true
	// 是否是同一年代
	carbon.Parse("2020-08-05 13:14:15").IsSameDecade(carbon.Parse("2030-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 13:14:15").IsSameDecade(carbon.Parse("2120-08-05 13:14:15")) // true
	// 是否是同一年
	carbon.Parse("2020-08-05 00:00:00").IsSameYear(carbon.Parse("2021-08-05 13:14:15")) // false
	carbon.Parse("2020-01-01 00:00:00").IsSameYear(carbon.Parse("2020-12-31 13:14:15")) // true
	// 是否是同一季节
	carbon.Parse("2020-08-05 00:00:00").IsSameQuarter(carbon.Parse("2020-09-05 13:14:15")) // false
	carbon.Parse("2020-01-01 00:00:00").IsSameQuarter(carbon.Parse("2021-01-31 13:14:15")) // true
	// 是否是同一月
	carbon.Parse("2020-01-01 00:00:00").IsSameMonth(carbon.Parse("2021-01-31 13:14:15")) // false
	carbon.Parse("2020-01-01 00:00:00").IsSameMonth(carbon.Parse("2020-01-31 13:14:15")) // true
	// 是否是同一天
	carbon.Parse("2020-08-05 13:14:15").IsSameDay(carbon.Parse("2021-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 00:00:00").IsSameDay(carbon.Parse("2020-08-05 13:14:15")) // true
	// 是否是同一小时
	carbon.Parse("2020-08-05 13:14:15").IsSameHour(carbon.Parse("2021-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 13:00:00").IsSameHour(carbon.Parse("2020-08-05 13:14:15")) // true
	// 是否是同一分钟
	carbon.Parse("2020-08-05 13:14:15").IsSameMinute(carbon.Parse("2021-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 13:14:00").IsSameMinute(carbon.Parse("2020-08-05 13:14:15")) // true
	// 是否是同一秒
	carbon.Parse("2020-08-05 13:14:15").IsSameSecond(carbon.Parse("2021-08-05 13:14:15")) // false
	carbon.Parse("2020-08-05 13:14:15").IsSameSecond(carbon.Parse("2020-08-05 13:14:15")) // true

	// 是否大于
	carbon.Parse("2020-08-05 13:14:15").Gt(carbon.Parse("2020-08-04 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Gt(carbon.Parse("2020-08-05 13:14:15"))           // false
	carbon.Parse("2020-08-05 13:14:15").Compare(">", carbon.Parse("2020-08-04 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare(">", carbon.Parse("2020-08-05 13:14:15")) // false

	// 是否小于
	carbon.Parse("2020-08-05 13:14:15").Lt(carbon.Parse("2020-08-06 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Lt(carbon.Parse("2020-08-05 13:14:15"))           // false
	carbon.Parse("2020-08-05 13:14:15").Compare("<", carbon.Parse("2020-08-06 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare("<", carbon.Parse("2020-08-05 13:14:15")) // false

	// 是否等于
	carbon.Parse("2020-08-05 13:14:15").Eq(carbon.Parse("2020-08-05 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Eq(carbon.Parse("2020-08-05 13:14:00"))           // false
	carbon.Parse("2020-08-05 13:14:15").Compare("=", carbon.Parse("2020-08-05 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare("=", carbon.Parse("2020-08-05 13:14:00")) // false

	// 是否不等于
	carbon.Parse("2020-08-05 13:14:15").Ne(carbon.Parse("2020-08-06 13:14:15"))            // true
	carbon.Parse("2020-08-05 13:14:15").Ne(carbon.Parse("2020-08-05 13:14:15"))            // false
	carbon.Parse("2020-08-05 13:14:15").Compare("!=", carbon.Parse("2020-08-06 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare("<>", carbon.Parse("2020-08-05 13:14:15")) // false

	// 是否大于等于
	carbon.Parse("2020-08-05 13:14:15").Gte(carbon.Parse("2020-08-04 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Gte(carbon.Parse("2020-08-05 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Compare(">=", carbon.Parse("2020-08-04 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare(">=", carbon.Parse("2020-08-05 13:14:15")) // true

	// 是否小于等于
	carbon.Parse("2020-08-05 13:14:15").Lte(carbon.Parse("2020-08-06 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Lte(carbon.Parse("2020-08-05 13:14:15"))           // true
	carbon.Parse("2020-08-05 13:14:15").Compare("<=", carbon.Parse("2020-08-06 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").Compare("<=", carbon.Parse("2020-08-05 13:14:15")) // true

	// 是否在两个时间之间(不包括这两个时间)
	carbon.Parse("2020-08-05 13:14:15").Between(carbon.Parse("2020-08-05 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // false
	carbon.Parse("2020-08-05 13:14:15").Between(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true

	// 是否在两个时间之间(包括开始时间)
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedStart(carbon.Parse("2020-08-05 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedStart(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true

	// 是否在两个时间之间(包括结束时间)
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedEnd(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-05 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedEnd(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true

	// 是否在两个时间之间(包括这两个时间)
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedBoth(carbon.Parse("2020-08-05 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true
	carbon.Parse("2020-08-05 13:14:15").BetweenIncludedBoth(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-05 13:14:15")) // true
}

2.11 时间设置

package main

import (
   "github.com/golang-module/carbon/v2"
   "time"
)

func main(){
   // 设置时区
   carbon.SetTimezone(carbon.PRC).Now().ToDateTimeString() // 2020-08-05 13:14:15
   carbon.SetTimezone(carbon.Tokyo).Now().ToDateTimeString() // 2020-08-05 14:14:15
   carbon.SetTimezone(carbon.Tokyo).Now().SetTimezone(carbon.PRC).ToDateTimeString() // 2020-08-05 12:14:15

   // 设置地区
   utc, _ := time.LoadLocation(carbon.UTC)
   carbon.SetLocation(utc).Now().ToDateTimeString() // 2022-06-28 09:25:38
   tokyo, _ := time.LoadLocation(carbon.Tokyo)
   carbon.SetLocation(tokyo).Now().ToDateTimeString() // 2022-06-28 18:25:38

   // 设置区域
   carbon.Parse("2020-07-05 13:14:15").SetLocale("en").DiffForHumans() // 1 month ago
   carbon.Parse("2020-07-05 13:14:15").SetLocale("zh-CN").DiffForHumans() // 1 月前

   // 设置年月日时分秒
   carbon.Parse("2020-01-01").SetDateTime(2019, 2, 2, 13, 14, 15).ToString() // 2019-02-02 13:14:15 +0800 CST
   carbon.Parse("2020-01-01").SetDateTime(2019, 2, 31, 13, 14, 15).ToString() // 2019-03-03 13:14:15 +0800 CST
   // 设置年月日时分秒毫秒
   carbon.Parse("2020-01-01").SetDateTimeMilli(2019, 2, 2, 13, 14, 15, 999).ToString() // 2019-02-02 13:14:15.999 +0800 CST
   carbon.Parse("2020-01-01").SetDateTimeMilli(2019, 2, 31, 13, 14, 15, 999).ToString() // 2019-03-03 13:14:15.999 +0800 CST
   // 设置年月日时分秒微秒
   carbon.Parse("2020-01-01").SetDateTimeMicro(2019, 2, 2, 13, 14, 15, 999999).ToString() // 2019-02-02 13:14:15.999999 +0800 CST
   carbon.Parse("2020-01-01").SetDateTimeMicro(2019, 2, 31, 13, 14, 15, 999999).ToString() // 2019-03-03 13:14:15.999999 +0800 CST
   // 设置年月日时分秒纳秒
   carbon.Parse("2020-01-01").SetDateTimeNano(2019, 2, 2, 13, 14, 15, 999999999).ToString() // 2019-02-02 13:14:15.999999999 +0800 CST
   carbon.Parse("2020-01-01").SetDateTimeNano(2019, 2, 31, 13, 14, 15, 999999999).ToString() // 2019-03-03 13:14:15.999999999 +0800 CST

   // 设置年月日
   carbon.Parse("2020-01-01").SetDate(2019, 2, 2).ToString() // 2019-02-02 00:00:00 +0800 CST
   carbon.Parse("2020-01-01").SetDate(2019, 2, 31).ToString() // 2019-03-03 00:00:00 +0800 CST
   // 设置年月日毫秒
   carbon.Parse("2020-01-01").SetDateMilli(2019, 2, 2, 999).ToString() // 2019-02-02 00:00:00.999 +0800 CST
   carbon.Parse("2020-01-01").SetDateMilli(2019, 2, 31, 999).ToString() // 2019-03-03 00:00:00.999 +0800 CST
   // 设置年月日微秒
   carbon.Parse("2020-01-01").SetDateMicro(2019, 2, 2, 999999).ToString() // 2019-02-02 00:00:00.999999 +0800 CST
   carbon.Parse("2020-01-01").SetDateMicro(2019, 2, 31, 999999).ToString() // 2019-03-03 00:00:00.999999 +0800 CST
   // 设置年月日纳秒
   carbon.Parse("2020-01-01").SetDateNano(2019, 2, 2, 999999999).ToString() // 2019-02-02 00:00:00.999999999 +0800 CST
   carbon.Parse("2020-01-01").SetDateNano(2019, 2, 31, 999999999).ToString() // 2019-03-03 00:00:00.999999999 +0800 CST

   // 设置时分秒
   carbon.Parse("2020-01-01").SetTime(13, 14, 15).ToString() // 2020-01-01 13:14:15 +0800 CST
   carbon.Parse("2020-01-01").SetTime(13, 14, 90).ToString() // 2020-01-01 13:15:30 +0800 CST
   // 设置时分秒毫秒
   carbon.Parse("2020-01-01").SetTimeMilli(13, 14, 15, 999).ToString() // 2020-01-01 13:14:15.999 +0800 CST
   carbon.Parse("2020-01-01").SetTimeMilli(13, 14, 90, 999).ToString() // 2020-01-01 13:15:30.999 +0800 CST
   // 设置时分秒微秒
   carbon.Parse("2020-01-01").SetTimeMicro(13, 14, 15, 999999).ToString() // 2020-01-01 13:14:15.999999 +0800 CST
   carbon.Parse("2020-01-01").SetTimeMicro(13, 14, 90, 999999).ToString() // 2020-01-01 13:15:30.999999 +0800 CST
   // 设置时分秒纳秒
   carbon.Parse("2020-01-01").SetTimeNano(13, 14, 15, 999999999).ToString() // 2020-01-01 13:14:15.999999999 +0800 CST
   carbon.Parse("2020-01-01").SetTimeNano(13, 14, 90, 999999999).ToString() // 2020-01-01 13:15:30.999999999 +0800 CST

   // 设置年份
   carbon.Parse("2020-02-29").SetYear(2021).ToDateString() // 2021-03-01
   // 设置年份(月份不溢出)
   carbon.Parse("2020-02-29").SetYearNoOverflow(2021).ToDateString() // 2021-02-28

   // 设置月份
   carbon.Parse("2020-01-31").SetMonth(2).ToDateString() // 2020-03-02
   // 设置月份(月份不溢出)
   carbon.Parse("2020-01-31").SetMonthNoOverflow(2).ToDateString() // 2020-02-29

   // 设置一周的开始日期
   carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Monday).Week() // 6
   carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Sunday).Week() // 0

   // 设置日期
   carbon.Parse("2019-08-05").SetDay(31).ToDateString() // 2020-08-31
   carbon.Parse("2020-02-01").SetDay(31).ToDateString() // 2020-03-02

   // 设置小时
   carbon.Parse("2020-08-05 13:14:15").SetHour(10).ToDateTimeString() // 2020-08-05 10:14:15
   carbon.Parse("2020-08-05 13:14:15").SetHour(24).ToDateTimeString() // 2020-08-06 00:14:15

   // 设置分钟
   carbon.Parse("2020-08-05 13:14:15").SetMinute(10).ToDateTimeString() // 2020-08-05 13:10:15
   carbon.Parse("2020-08-05 13:14:15").SetMinute(60).ToDateTimeString() // 2020-08-05 14:00:15

   // 设置秒
   carbon.Parse("2020-08-05 13:14:15").SetSecond(10).ToDateTimeString() // 2020-08-05 13:14:10
   carbon.Parse("2020-08-05 13:14:15").SetSecond(60).ToDateTimeString() // 2020-08-05 13:15:00

   // 设置毫秒
   carbon.Parse("2020-08-05 13:14:15").SetMillisecond(100).Millisecond() // 100
   carbon.Parse("2020-08-05 13:14:15").SetMillisecond(999).Millisecond() // 999

   // 设置微妙
   carbon.Parse("2020-08-05 13:14:15").SetMicrosecond(100000).Microsecond() // 100000
   carbon.Parse("2020-08-05 13:14:15").SetMicrosecond(999999).Microsecond() // 999999

   // 设置纳秒
   carbon.Parse("2020-08-05 13:14:15").SetNanosecond(100000000).Nanosecond() // 100000000
   carbon.Parse("2020-08-05 13:14:15").SetNanosecond(999999999).Nanosecond() // 999999999
}

2.12 时间获取

package main

import (
	"github.com/golang-module/carbon/v2"
	"time"
)

func main(){
	// 获取本年总天数
	carbon.Parse("2019-08-05 13:14:15").DaysInYear() // 365
	carbon.Parse("2020-08-05 13:14:15").DaysInYear() // 366
	// 获取本月总天数
	carbon.Parse("2020-02-01 13:14:15").DaysInMonth() // 29
	carbon.Parse("2020-04-01 13:14:15").DaysInMonth() // 30
	carbon.Parse("2020-08-01 13:14:15").DaysInMonth() // 31

	// 获取本年第几天
	carbon.Parse("2020-08-05 13:14:15").DayOfYear() // 218
	// 获取本年第几周
	carbon.Parse("2019-12-31 13:14:15").WeekOfYear() // 1
	carbon.Parse("2020-08-05 13:14:15").WeekOfYear() // 32
	// 获取本月第几天
	carbon.Parse("2020-08-05 13:14:15").DayOfMonth() // 5
	// 获取本月第几周
	carbon.Parse("2020-08-05 13:14:15").WeekOfMonth() // 1
	// 获取本周第几天
	carbon.Parse("2020-08-05 13:14:15").DayOfWeek() // 3

	// 获取当前年月日时分秒
	carbon.Parse("2020-08-05 13:14:15").DateTime() // 2020,8,5,13,14,15
	// 获取当前年月日时分秒毫秒
	carbon.Parse("2020-08-05 13:14:15").DateTimeMilli() // 2020,8,5,13,14,15,999
	// 获取当前年月日时分秒微秒
	carbon.Parse("2020-08-05 13:14:15").DateTimeMicro() // 2020,8,5,13,14,15,999999
	// 获取当前年月日时分秒纳秒
	carbon.Parse("2020-08-05 13:14:15").DateTimeNano() // 2020,8,5,13,14,15,999999999

	// 获取当前年月日
	carbon.Parse("2020-08-05 13:14:15.999999999").Date() // 2020,8,5
	// 获取当前年月日毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").DateMilli() // 2020,8,5,999
	// 获取当前年月日微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").DateMicro() // 2020,8,5,999999
	// 获取当前年月日纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").DateNano() // 2020,8,5,999999999

	// 获取当前时分秒
	carbon.Parse("2020-08-05 13:14:15.999999999").Time() // 13,14,15
	// 获取当前时分秒毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").TimeMilli() // 13,14,15,999
	// 获取当前时分秒微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").TimeMicro() // 13,14,15,999999
	// 获取当前时分秒纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").TimeNano() // 13,14,15,999999999

	// 获取当前世纪
	carbon.Parse("2020-08-05 13:14:15").Century() // 21
	// 获取当前年代
	carbon.Parse("2019-08-05 13:14:15").Decade() // 10
	carbon.Parse("2021-08-05 13:14:15").Decade() // 20
	// 获取当前年份
	carbon.Parse("2020-08-05 13:14:15").Year() // 2020
	// 获取当前季度
	carbon.Parse("2020-08-05 13:14:15").Quarter() // 3
	// 获取当前月份
	carbon.Parse("2020-08-05 13:14:15").Month() // 8
	// 获取当前周(从0开始)
	carbon.Parse("2020-08-02 13:14:15").Week() // 0
	carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Sunday).Week() // 0
	carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Monday).Week() // 6
	// 获取当前天数
	carbon.Parse("2020-08-05 13:14:15").Day() // 5
	// 获取当前小时
	carbon.Parse("2020-08-05 13:14:15").Hour() // 13
	// 获取当前分钟
	carbon.Parse("2020-08-05 13:14:15").Minute() // 14
	// 获取当前秒钟
	carbon.Parse("2020-08-05 13:14:15").Second() // 15
	// 获取当前毫秒
	carbon.Parse("2020-08-05 13:14:15.999").Millisecond() // 999
	// 获取当前微秒
	carbon.Parse("2020-08-05 13:14:15.999").Microsecond() // 999000
	// 获取当前纳秒
	carbon.Parse("2020-08-05 13:14:15.999").Nanosecond() // 999000000

	// 获取秒级时间戳
	carbon.Parse("2020-08-05 13:14:15").Timestamp() // 1596604455
	// 获取毫秒级时间戳
	carbon.Parse("2020-08-05 13:14:15").TimestampMilli() // 1596604455000
	// 获取微秒级时间戳
	carbon.Parse("2020-08-05 13:14:15").TimestampMicro() // 1596604455000000
	// 获取纳秒级时间戳
	carbon.Parse("2020-08-05 13:14:15").TimestampNano() // 1596604455000000000

	// 获取时区
	carbon.SetTimezone(carbon.PRC).Timezone() // CST
	carbon.SetTimezone(carbon.Tokyo).Timezone() // JST

	// 获取位置
	carbon.SetTimezone(carbon.PRC).Location() // PRC
	carbon.SetTimezone(carbon.Tokyo).Location() // Asia/Tokyo

	// 获取距离UTC时区的偏移量，单位秒
	carbon.SetTimezone(carbon.PRC).Offset() // 28800
	carbon.SetTimezone(carbon.Tokyo).Offset() // 32400

	// 获取当前区域
	carbon.Now().Locale() // en
	carbon.Now().SetLocale("zh-CN").Locale() // zh-CN

	// 获取当前星座
	carbon.Now().Constellation() // Leo
	carbon.Now().SetLocale("en").Constellation() // Leo
	carbon.Now().SetLocale("zh-CN").Constellation() // 狮子座

	// 获取当前季节
	carbon.Now().Season() // Summer
	carbon.Now().SetLocale("en").Season() // Summer
	carbon.Now().SetLocale("zh-CN").Season() // 夏季

	// 获取年龄
	carbon.Parse("2002-01-01 13:14:15").Age() // 17
	carbon.Parse("2002-12-31 13:14:15").Age() // 18
}

2.13 时间输出

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
)

func main() {
	// 输出日期时间字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeString() // 2020-08-05 13:14:15
	// 输出日期时间字符串，包含毫秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeMilliString() // 2020-08-05 13:14:15.999
	// 输出日期时间字符串，包含微秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeMicroString() // 2020-08-05 13:14:15.999999
	// 输出日期时间字符串，包含纳秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeNanoString() // 2020-08-05 13:14:15.999999999

	// 输出简写日期时间字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeString() // 20200805131415
	// 输出简写日期时间字符串，包含毫秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeMilliString() // 20200805131415.999
	// 输出简写日期时间字符串，包含微秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeMicroString() // 20200805131415.999999
	// 输出简写日期时间字符串，包含纳秒
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeNanoString() // 20200805131415.999999999

	// 输出日期字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToDateString() // 2020-08-05
	// 输出日期字符串，包含毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToDateMilliString() // 2020-08-05.999
	// 输出日期字符串，包含微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToDateMicroString() // 2020-08-05.999999
	// 输出日期字符串，包含纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToDateNanoString() // 2020-08-05.999999999

	// 输出简写日期字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateString() // 20200805
	// 输出简写日期字符串，包含毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateMilliString() // 20200805.999
	// 输出简写日期字符串，包含微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateMicroString() // 20200805.999999
	// 输出简写日期字符串，包含纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateNanoString() // 20200805.999999999

	// 输出时间字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeString() // 13:14:15
	// 输出时间字符串，包含毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeMilliString() // 13:14:15.999
	// 输出时间字符串，包含微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeMicroString() // 13:14:15.999999
	// 输出时间字符串，包含纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeNanoString() // 13:14:15.999999999

	// 输出简写时间字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortTimeString() // 131415
	// 输出简写时间字符串，包含毫秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortTimeMilliString() // 131415.999
	// 输出简写时间字符串，包含微秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortTimeMicroString() // 131415.999999
	// 输出简写时间字符串，包含纳秒
	carbon.Parse("2020-08-05 13:14:15.999999999").ToShortTimeNanoString() // 131415.999999999

	// 输出 ANSIC 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToANSICString() // Wed Aug  5 13:14:15 2020
	// 输出 Atom 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToAtomString() // 2020-08-05T13:14:15+08:00
	// 输出 UnixDate 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToUnixDateString() // Wed Aug  5 13:14:15 CST 2020
	// 输出 RubyDate 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRubyDateString() // Wed Aug 05 13:14:15 +0800 2020
	// 输出 Kitchen 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToKitchenString() // 1:14PM
	// 输出 Cookie 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToCookieString() // Wednesday, 05-Aug-2020 13:14:15 CST
	// 输出 DayDateTime 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToDayDateTimeString() // Wed, Aug 5, 2020 1:14 PM
	// 输出 RSS 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRssString() // Wed, 05 Aug 2020 13:14:15 +0800
	// 输出 W3C 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToW3cString() // 2020-08-05T13:14:15+08:00

	// 输出 ISO8601 格式字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601String() // 2020-08-05T13:14:15+08:00
	// 输出 ISO8601Milli 格式字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601MilliString() // 2020-08-05T13:14:15.999+08:00
	// 输出 ISO8601Micro 格式字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601MicroString() // 2020-08-05T13:14:15.999999+08:00
	// 输出 ISO8601Nano 格式字符串
	carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601NanoString() // 2020-08-05T13:14:15.999999999+08:00

	// 输出 RFC822 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc822String() // 05 Aug 20 13:14 CST
	// 输出 RFC822Z 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc822zString() // 05 Aug 20 13:14 +0800
	// 输出 RFC850 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc850String() // Wednesday, 05-Aug-20 13:14:15 CST
	// 输出 RFC1036 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc1036String() // Wed, 05 Aug 20 13:14:15 +0800
	// 输出 RFC1123 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc1123String() // Wed, 05 Aug 2020 13:14:15 CST
	// 输出 RFC1123Z 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc1123zString() // Wed, 05 Aug 2020 13:14:15 +0800
	// 输出 RFC2822 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc2822String() // Wed, 05 Aug 2020 13:14:15 +0800
	// 输出 RFC7231 格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToRfc7231String() // Wed, 05 Aug 2020 13:14:15 GMT

	// 输出 RFC3339 格式字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339String() // 2020-08-05T13:14:15+08:00
	// 输出 RFC3339Milli 格式字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339MilliString() // 2020-08-05T13:14:15.999+08:00
	// 输出 RFC3339Micro 格式字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339MicroString() // 2020-08-05T13:14:15.999999+08:00
	// 输出 RFC3339Nano 格式字符串
	carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339NanoString() // 2020-08-05T13:14:15.999999999+08:00

	// 输出日期时间字符串
	fmt.Sprintf("%s", carbon.Parse("2020-08-05 13:14:15")) // 2020-08-05 13:14:15

	// 输出"2006-01-02 15:04:05.999999999 -0700 MST"格式字符串
	carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15.999999 +0800 CST

	// 输出指定布局的字符串,Layout()是ToLayoutString()的简写
	carbon.Parse("2020-08-05 13:14:15").Layout(carbon.ISO8601Layout)        // 2020-08-05T13:14:15+08:00
	carbon.Parse("2020-08-05 13:14:15").Layout("20060102150405")            // 20200805131415
	carbon.Parse("2020-08-05 13:14:15").Layout("2006年01月02日 15时04分05秒")     // 2020年08月05日 13时14分15秒
	carbon.Parse("2020-08-05 13:14:15").Layout("It is 2006-01-02 15:04:05") // It is 2020-08-05 13:14:15

	// 输出指定格式的字符串,Format()是ToFormatString()的简写(如果使用的字母与格式化字符冲突时，请使用\符号转义该字符)
	carbon.Parse("2020-08-05 13:14:15").Format("YmdHis")                    // 20200805131415
	carbon.Parse("2020-08-05 13:14:15").Format("Y年m月d日 H时i分s秒")             // 2020年08月05日 13时14分15秒
	carbon.Parse("2020-08-05 13:14:15").Format("l jS \\o\\f F Y h:i:s A")   // Wednesday 5th of August 2020 01:14:15 PM
	carbon.Parse("2020-08-05 13:14:15").Format("\\I\\t \\i\\s Y-m-d H:i:s") // It is 2020-08-05 13:14:15
}

格式化符号表：

符号描述长度范围示例
d月份中的第几天，有前导零201-3102
D缩写单词表示的周几3Mon-SunMon
j月份中的第几天，没有前导零-1-312
S第几天的英文缩写后缀，一般和j配合使用2st/nd/rd/thth
l完整单词表示的周几-Monday-SundayMonday
F完整单词表示的月份-January-DecemberJanuary
m数字表示的月份，有前导零201-1201
M缩写单词表示的月份3Jan-DecJan
n数字表示的月份，没有前导零-1-121
Y4 位数字完整表示的年份40000-99992006
y2 位数字表示的年份200-9906
a小写的上午和下午标识2am/pmpm
A大写的上午和下午标识2AM/PMPM
g小时，12 小时格式-1-123
G小时，24 小时格式-0-2315
h小时，12 小时格式200-1103
H小时，24 小时格式200-2315
i分钟201-5904
s秒数201-5905
cISO8601 格式日期--2006-01-02T15:04:05-07:00
rRFC2822 格式日期--Mon, 02 Jan 2006 15:04:05 -0700
O与格林威治时间相差的小时数---0700
P与格林威治时间相差的小时数，小时和分钟之间有冒号分隔--+07:00
T时区缩写--MST
WISO8601 格式数字表示的年份中的第几周201-5201
NISO8601 格式数字表示的星期中的第几天201-0702
L是否为闰年，如果是闰年为 1，否则为 010-10
U秒级时间戳10-1611818268
u毫秒-1-999999
w数字表示的周几10-61
t月份中的总天数228-3131
z年份中的第几天-1-3652
e当前位置--America/New_York
Q当前季节11-41
C当前世纪数-0-9921

2.14 星座

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main() {
	// 获取星座
	carbon.Parse("2020-08-05 13:14:15").Constellation() // Leo

	// 是否是白羊座
	carbon.Parse("2020-08-05 13:14:15").IsAries() // false
	// 是否是金牛座
	carbon.Parse("2020-08-05 13:14:15").IsTaurus() // false
	// 是否是双子座
	carbon.Parse("2020-08-05 13:14:15").IsGemini() // false
	// 是否是巨蟹座
	carbon.Parse("2020-08-05 13:14:15").IsCancer() // false
	// 是否是狮子座
	carbon.Parse("2020-08-05 13:14:15").IsLeo() // true
	// 是否是处女座
	carbon.Parse("2020-08-05 13:14:15").IsVirgo() // false
	// 是否是天秤座
	carbon.Parse("2020-08-05 13:14:15").IsLibra() // false
	// 是否是天蝎座
	carbon.Parse("2020-08-05 13:14:15").IsScorpio() // false
	// 是否是射手座
	carbon.Parse("2020-08-05 13:14:15").IsSagittarius() // false
	// 是否是摩羯座
	carbon.Parse("2020-08-05 13:14:15").IsCapricorn() // false
	// 是否是水瓶座
	carbon.Parse("2020-08-05 13:14:15").IsAquarius() // false
	// 是否是双鱼座
	carbon.Parse("2020-08-05 13:14:15").IsPisces() // false
}

2.15 季节

按照气象划分，即3-5月为春季，6-8月为夏季，9-11月为秋季，12-2月为冬季。

package main

import (
	"github.com/golang-module/carbon/v2"
)

func main() {
	// 获取季节
	carbon.Parse("2020-08-05 13:14:15").Season() // Summer

	// 本季节开始时间
	carbon.Parse("2020-08-05 13:14:15").StartOfSeason().ToDateTimeString() // 2020-06-01 00:00:00
	// 本季节结束时间
	carbon.Parse("2020-08-05 13:14:15").EndOfSeason().ToDateTimeString() // 2020-08-31 23:59:59

	// 是否是春季
	carbon.Parse("2020-08-05 13:14:15").IsSpring() // false
	// 是否是夏季
	carbon.Parse("2020-08-05 13:14:15").IsSummer() // true
	// 是否是秋季
	carbon.Parse("2020-08-05 13:14:15").IsAutumn() // false
	// 是否是冬季
	carbon.Parse("2020-08-05 13:14:15").IsWinter() // false
}

2.16 农历

目前仅支持公元1900年至2100年的200年时间跨度。

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
)

func main()  {
	// 获取农历生肖
	carbon.Parse("2020-08-05 13:14:15").Lunar().Animal() // 鼠

	// 获取农历节日
	carbon.Parse("2021-02-12 13:14:15").Lunar().Festival() // 春节

	// 获取农历年月日时分秒
	carbon.Parse("2020-08-05 13:14:15").Lunar().DateTime() // 2020, 6, 16, 13, 14, 15
	// 获取农历年月日
	carbon.Parse("2020-08-05 13:14:15").Lunar().Date() // 2020, 6, 16
	// 获取农历时分秒
	carbon.Parse("2020-08-05 13:14:15").Lunar().Time() // 13, 14, 15

	// 获取农历年年份
	carbon.Parse("2020-08-05 13:14:15").Lunar().Year() // 2020
	// 获取农历月月份
	carbon.Parse("2020-08-05 13:14:15").Lunar().Month() // 6
	// 获取农历闰月月份
	carbon.Parse("2020-08-05 13:14:15").Lunar().LeapMonth() // 4
	// 获取农历日日期
	carbon.Parse("2020-08-05 13:14:15").Lunar().Day() // 16
	// 获取农历 YYYY-MM-DD HH::ii::ss 格式字符串
	fmt.Sprintf("%s", carbon.Parse("2020-08-05 13:14:15").Lunar()) // 2020-06-16 13:14:15

	// 获取农历年字符串
	carbon.Parse("2020-08-05 13:14:15").Lunar().ToYearString() // 二零二零
	// 获取农历月字符串
	carbon.Parse("2020-08-05 13:14:15").Lunar().ToMonthString() // 六月
	// 获取农历天字符串
	carbon.Parse("2020-08-05 13:14:15").Lunar().ToDayString() // 十六
	// 获取农历日期字符串
	carbon.Parse("2020-08-05 13:14:15").Lunar().ToDateString() // 二零二零年六月十六

	// 是否是农历闰年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsLeapYear() // true
	// 是否是农历闰月
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsLeapMonth() // false

	// 是否是鼠年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsRatYear() // true
	// 是否是牛年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsOxYear() // false
	// 是否是虎年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsTigerYear() // false
	// 是否是兔年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsRabbitYear() // false
	// 是否是龙年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsDragonYear() // false
	// 是否是蛇年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsSnakeYear() // false
	// 是否是马年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsHorseYear() // false
	// 是否是羊年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsGoatYear() // false
	// 是否是猴年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsMonkeyYear() // false
	// 是否是鸡年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsRoosterYear() // false
	// 是否是狗年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsDogYear() // false
	// 是否是猪年
	carbon.Parse("2020-08-05 13:14:15").Lunar().IsPigYear() // false

	// 获取农历时辰
	carbon.Parse("2020-02-05 21:00:00").Lunar().DoubleHour() // 亥时

	// 是否是子时
	carbon.Parse("2020-03-21 00:00:00").Lunar().IsFirstDoubleHour() // true
	// 是否是丑时
	carbon.Parse("2020-03-21 01:00:00").Lunar().IsSecondDoubleHour() // true
	// 是否是寅时
	carbon.Parse("2020-03-21 03:00:00").Lunar().IsThirdDoubleHour() // true
	// 是否是卯时
	carbon.Parse("2020-03-21 05:00:00").Lunar().IsFourthDoubleHour() // true
	// 是否是辰时
	carbon.Parse("2020-03-21 07:00:00").Lunar().IsFifthDoubleHour() // true
	// 是否是巳时
	carbon.Parse("2020-03-21 09:00:00").Lunar().IsSixthDoubleHour() // true
	// 是否是午时
	carbon.Parse("2020-03-21 11:00:00").Lunar().IsSeventhDoubleHour() // true
	// 是否是未时
	carbon.Parse("2020-03-21 13:00:00").Lunar().IsEighthDoubleHour() // true
	// 是否是申时
	carbon.Parse("2020-03-21 15:00:00").Lunar().IsNinthDoubleHour() // true
	// 是否是酉时
	carbon.Parse("2020-03-21 17:00:00").Lunar().IsTenthDoubleHour() // true
	// 是否是戌时
	carbon.Parse("2020-03-21 19:00:00").Lunar().IsEleventhDoubleHour() // true
	// 是否是亥时
	carbon.Parse("2020-03-21 21:00:00").Lunar().IsTwelfthDoubleHour() // true
}

2.17 JSON 支持

2.17.1 JSON 编码
package main

import (
	"encoding/json"
	"fmt"
	"github.com/golang-module/carbon/v2"
	"log"
)

type Person struct {
	Name         string                `json:"name"`
	Age          int                   `json:"age"`
	Birthday1    carbon.DateTime       `json:"birthday1"`
	Birthday2    carbon.DateTimeMilli  `json:"birthday2"`
	Birthday3    carbon.DateTimeMicro  `json:"birthday3"`
	Birthday4    carbon.DateTimeNano   `json:"birthday4"`
	GraduatedAt1 carbon.Date           `json:"graduated_at1"`
	GraduatedAt2 carbon.DateMilli      `json:"graduated_at2"`
	GraduatedAt3 carbon.DateMicro      `json:"graduated_at3"`
	GraduatedAt4 carbon.DateNano       `json:"graduated_at4"`
	CreatedAt1   carbon.Timestamp      `json:"created_at1"`
	CreatedAt2   carbon.TimestampMilli `json:"created_at2"`
	CreatedAt3   carbon.TimestampMicro `json:"created_at3"`
	CreatedAt4   carbon.TimestampNano  `json:"created_at4"`
}

func main() {
	person := Person {
		Name:        "gouguoyin",
		Age:          18,
		Birthday1:    carbon.DateTime{carbon.Now().SubYears(18)},
		Birthday2:    carbon.DateTimeMilli{carbon.Now().SubYears(18)},
		Birthday3:    carbon.DateTimeMicro{carbon.Now().SubYears(18)},
		Birthday4:    carbon.DateTimeNano{carbon.Now().SubYears(18)},
		GraduatedAt1: carbon.Date{carbon.Now()},
		GraduatedAt2: carbon.DateMilli{carbon.Now()},
		GraduatedAt3: carbon.DateMicro{carbon.Now()},
		GraduatedAt4: carbon.DateNano{carbon.Now()},
		CreatedAt1:   carbon.Timestamp{carbon.Now()},
		CreatedAt2:   carbon.TimestampMilli{carbon.Now()},
		CreatedAt3:   carbon.TimestampMicro{carbon.Now()},
		CreatedAt4:   carbon.TimestampNano{carbon.Now()},
	}
	data, err := json.Marshal(&person)
	if err != nil {
		// 错误处理
		log.Fatal(err)
	}
	fmt.Printf("%s", data)
}

# 输出
{
	"name": "gouguoyin",
	"age": 18,
	"birthday1": "2005-06-07 09:37:11",
	"birthday2": "2005-06-07 09:37:11.596",
	"birthday3": "2005-06-07 09:37:11.596757",
	"birthday4": "2005-06-07 09:37:11.5967574",
	"graduated_at1": "2023-06-07",
	"graduated_at2": "2023-06-07.596",
	"graduated_at3": "2023-06-07.596757",
	"graduated_at4": "2023-06-07.5967574",
	"created_at1": 1686101831,
	"created_at2": 1686101831596,
	"created_at3": 1686101831596757,
	"created_at4": 1686101831596757400
}
2.17.2 JSON 解码
package main

import (
	"encoding/json"
	"fmt"
	"github.com/golang-module/carbon/v2"
	"log"
)

type Person struct {
	Name         string                `json:"name"`
	Age          int                   `json:"age"`
	Birthday1    carbon.DateTime       `json:"birthday1"`
	Birthday2    carbon.DateTimeMilli  `json:"birthday2"`
	Birthday3    carbon.DateTimeMicro  `json:"birthday3"`
	Birthday4    carbon.DateTimeNano   `json:"birthday4"`
	GraduatedAt1 carbon.Date           `json:"graduated_at1"`
	GraduatedAt2 carbon.DateMilli      `json:"graduated_at2"`
	GraduatedAt3 carbon.DateMicro      `json:"graduated_at3"`
	GraduatedAt4 carbon.DateNano       `json:"graduated_at4"`
	CreatedAt1   carbon.Timestamp      `json:"created_at1"`
	CreatedAt2   carbon.TimestampMilli `json:"created_at2"`
	CreatedAt3   carbon.TimestampMicro `json:"created_at3"`
	CreatedAt4   carbon.TimestampNano  `json:"created_at4"`
}

func main() {
	str := `{
	"name": "gouguoyin",
	"age": 18,
	"birthday1": "2005-06-07 09:37:11",
	"birthday2": "2005-06-07 09:37:11.596",
	"birthday3": "2005-06-07 09:37:11.596757",
	"birthday4": "2005-06-07 09:37:11.5967574",
	"graduated_at1": "2023-06-07",
	"graduated_at2": "2023-06-07.596",
	"graduated_at3": "2023-06-07.596757",
	"graduated_at4": "2023-06-07.5967574",
	"created_at1": 1686101831,
	"created_at2": 1686101831596,
	"created_at3": 1686101831596757,
	"created_at4": 1686101831596757400
}`
	person := new(Person)
	err := json.Unmarshal([]byte(str), &person)
	if err != nil {
		// 错误处理
		log.Fatal(err)
	}
	fmt.Printf("%+v", *person)
}

# 输出
{Name:gouguoyin Age:18 Birthday1:2005-06-07 09:37:11 Birthday2:2005-06-07 09:37:11.596 Birthday3:2005-06-07 09:37:11.596757 Birthday4:2005-06-07 09:37:11.5967574 GraduatedAt1:2023-06-07 GraduatedAt2:2023-06-07.596 GraduatedAt3:2023-06-07.596757 GraduatedAt4:2023-06-07.5967574 CreatedAt1:2023-06-07 09:37:11 CreatedAt2:2023-06-07 09:37:11.596 CreatedAt3:2023-06-07 09:37:11.596757 CreatedAt4:2023-06-07 09:37:11.5967574}

2.18 国际化支持

目前支持的语言有：

目前支持的方法有

  • Constellation()：获取星座
  • Season()：获取季节
  • DiffForHumans()：获取对人类友好的可读格式时间差
  • ToMonthString()：输出完整月份字符串
  • ToShortMonthString()：输出缩写月份字符串
  • ToWeekString()：输出完整星期字符串
  • ToShortWeekString()：输出缩写星期字符串

2.18.1 设置区域

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
	"log"
)

func main(){
	lang := carbon.NewLanguage()
	lang.SetLocale("zh-CN")
	c := carbon.SetLanguage(lang)
	if c.Error != nil {
		// 错误处理
		log.Fatal(c.Error)
	}
	c.Now().AddHours(1).DiffForHumans() // 1 小时后
	c.Now().AddHours(1).ToMonthString() // 八月
	c.Now().AddHours(1).ToShortMonthString() // 8月
	c.Now().AddHours(1).ToWeekString() // 星期二
	c.Now().AddHours(1).ToShortWeekString() // 周二
	c.Now().AddHours(1).Constellation() // 狮子座
	c.Now().AddHours(1).Season() // 夏季

	/*
	1 小时后
	六月
	6月
	星期三
	周三
	双子座
	夏季
	*/
	fmt.Println(c.Now().AddHours(1).DiffForHumans()) // 1 小时后
	fmt.Println(c.Now().AddHours(1).ToMonthString()) // 八月
	fmt.Println(c.Now().AddHours(1).ToShortMonthString()) // 8月
	fmt.Println(c.Now().AddHours(1).ToWeekString()) // 星期二
	fmt.Println(c.Now().AddHours(1).ToShortWeekString()) // 周二
	fmt.Println(c.Now().AddHours(1).Constellation()) // 狮子座
	fmt.Println(c.Now().AddHours(1).Season()) // 夏季
}

自己定义展示格式：

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
	"log"
)

func main() {
	lang := carbon.NewLanguage()
	lang.SetLocale("zh-CN")
	resources := map[string]string {
		"hour": "%dh",
	}
	lang.SetResources(resources)
	c := carbon.SetLanguage(lang)
	if c.Error != nil {
		// 错误处理
		log.Fatal(c.Error)
	}
	c.Now().AddHours(1).DiffForHumans()      // 1h后
	c.Now().AddHours(1).ToMonthString()      // 八月
	c.Now().AddHours(1).ToShortMonthString() // 8月
	c.Now().AddHours(1).ToWeekString()       // 星期二
	c.Now().AddHours(1).ToShortWeekString()  // 周二
	c.Now().AddHours(1).Constellation()      // 狮子座
	c.Now().AddHours(1).Season()             // 夏季

	/*
		1h后
		六月
		6月
		星期三
		周三
		双子座
		夏季
	*/
	fmt.Println(c.Now().AddHours(1).DiffForHumans())      // 1h后
	fmt.Println(c.Now().AddHours(1).ToMonthString())      // 八月
	fmt.Println(c.Now().AddHours(1).ToShortMonthString()) // 8月
	fmt.Println(c.Now().AddHours(1).ToWeekString())       // 星期二
	fmt.Println(c.Now().AddHours(1).ToShortWeekString())  // 周二
	fmt.Println(c.Now().AddHours(1).Constellation())      // 狮子座
	fmt.Println(c.Now().AddHours(1).Season())             // 夏季
}

package main

import (
	"fmt"
	"github.com/golang-module/carbon/v2"
	"log"
)

func main() {
	lang := carbon.NewLanguage()
	resources := map[string]string{
		"months":         "一月|二月|三月|四月|五月|六月|七月|八月|九月|十月|十一月|十二月",
		"short_months":   "1月|2月|3月|4月|5月|6月|7月|8月|9月|10月|11月|12月",
		"weeks":          "星期日|星期一|星期二|星期三|星期四|星期五|星期六",
		"short_weeks":    "周日|周一|周二|周三|周四|周五|周六",
		"seasons":        "春季|夏季|秋季|冬季",
		"constellations": "白羊座|金牛座|双子座|巨蟹座|狮子座|处女座|天秤座|天蝎座|射手座|摩羯座|水瓶座|双鱼座",
		"year":           "%d 年",
		"month":          "%d 个月",
		"week":           "%d 周",
		"day":            "%d 天",
		"hour":           "%d 小时",
		"minute":         "%d 分钟",
		"second":         "%d 秒",
		"now":            "刚刚",
		"ago":            "%s前",
		"from_now":       "%s之后", // 修改
		"before":         "%s之前", // 修改
		"after":          "%s之后", // 修改
	}
	lang.SetResources(resources)
	c := carbon.SetLanguage(lang)
	if c.Error != nil {
		// 错误处理
		log.Fatal(c.Error)
	}
	c.Now().AddHours(1).DiffForHumans()      // 1 小时之后
	c.Now().AddHours(1).ToMonthString()      // 八月
	c.Now().AddHours(1).ToShortMonthString() // 8月
	c.Now().AddHours(1).ToWeekString()       // 星期二
	c.Now().AddHours(1).ToShortWeekString()  // 周二
	c.Now().AddHours(1).Constellation()      // 狮子座
	c.Now().AddHours(1).Season()             // 夏季

	/*
		1 小时之后
		六月
		6月
		星期三
		周三
		双子座
		夏季
	*/
	fmt.Println(c.Now().AddHours(1).DiffForHumans())      // 1 小时之后
	fmt.Println(c.Now().AddHours(1).ToMonthString())      // 八月
	fmt.Println(c.Now().AddHours(1).ToShortMonthString()) // 8月
	fmt.Println(c.Now().AddHours(1).ToWeekString())       // 星期二
	fmt.Println(c.Now().AddHours(1).ToShortWeekString())  // 周二
	fmt.Println(c.Now().AddHours(1).Constellation())      // 狮子座
	fmt.Println(c.Now().AddHours(1).Season())             // 夏季
}
242030
关注
专栏目录
Go 每日一库之 carbon
TIANTIAN_ZZ的博客
02-22 840
简介 一线开发人员每天都要使用日期和时间相关的功能，各种定时器，活动时间处理等。标准库time使用起来不太灵活，特别是日期时间的创建和运算。carbon库是一个时间扩展库，基于 PHP 的carbon库编写。提供易于使用的接口。本文就来介绍一下这个库。 快速使用 第三方库需要先安装： $ go get github.com/uniplaces/carbon 后使用： package main ...
leetcode2-golang-at-ocado:课程的官方存储库2021-06-01/2021-07-08
06-29
Golang 介绍 <-- 已添加 其他资源 [第 1 周] 除此之外，我建议用 Go 做一些算法类型的任务。 [第 2 周] 测试 - 查看 Gomock 和作证 下一次 - GRPC 和编写代码。 记得安装 protobuff 编译器 ;o) 如何设置 go 环境 ...
go-carbon v2.1.6 发布， 轻量级、语义化、对开发者友好的Golang时间处理库
够过瘾专栏
05-09 307
carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个 star 吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本大于等于1.16 // 使用 github 库 go get -u github.com/golang-module/carbon/v2 import ( "github.com/g
探索时间的新维度：Carbon —— Golang中的日期时间处理神器
最新发布
gitblog_00307的博客
09-03 488
探索时间的新维度：Carbon —— Golang中的日期时间处理神器 carbonCarbon for Golang, an extension for Time项目地址:https://gitcode.com/gh_mirrors/carbon4/carbon 在这个快节奏的技术世界里，对日期和时间的高效处理显得尤为重要。今天，我们为您推荐一款专为Golang设计的时间处理库——Carbon...
go-carbon 2.1.5 五一特别版， 轻量级、语义化、对开发者友好的Golang时间处理库
够过瘾专栏
05-07 213
carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个star吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本小于1.16 // 使用 github 库 go get -u github.com/golang-module/carbon import ( "github.com/golang-modu
Golang：carbon一个轻量级、语义化、对开发者友好的 golang 时间处理库
彭世瑜的博客
11-09 742
一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用。
探索优雅的时间处理：Golang 中的 Carbon 模块
gitblog_00071的博客
03-21 406
探索优雅的时间处理：Golang 中的 Carbon 模块 carbonA simple, semantic and developer-friendly golang package for datetime项目地址:https://gitcode.com/gh_mirrors/carbon/carbon Carbon 是一个为 Golang 设计的强大、简单且直观的时间操作库。它使得在 Go...
golang.org/x/sys/windows
07-19
golang.org/x/sys/windows
go-ansible:Go-ansible是一个用于从Golang运行Ansible剧本的库
05-03
Go-ansible是用于从Golang应用程序运行Ansible剧本的软件包。 它支持大多数选项的ansible-playbook命令。 默认 JSON格式管理JSON输出 例子 执照 安装 要安装最新的稳定版本，请运行以下命令： $ go get github....
CoAP客户端/服务器为Go语言实现RFC 7252-Golang开发
05-26
Canopus Canopus是受约束的应用程序协议（CoAP）更新的客户端/服务器实现25.11.2016我已经基于[Julien Vermillard's] [JVERMILLARD]添加了基本的dTLS支持[Canopus Canopus是受约束的应用程序协议的客户端/服务器实现...
golang-cross:使用CGO的golang交叉编译器
03-31
戈朗克罗斯 Docker容器可对包含cgo支持的go软件包进行交叉编译... 建立跨语言的图像docker build --build-arg GO_VERSION=1.16.2 --build-arg GOLANG_DIST_SHA=542e936b19542e62679766194364f45141fde55169db2d8d01046
timefmt-go:Golang的高效时间格式化库（strftime，strptime）
05-15
timefmt-go Golang的高效时间格式化库（strftime，strptime） 这是用于格式化和解析日期时间字符串的Go语言包。 package main import ( "fmt" "log" "github.com/itchyny/timefmt-go" ) func main () { t , err := timefmt . Parse ( "2020/07/24 09:07:29" , "%Y/%m/%d %H:%M:%S" ) if err != nil { log . Fatal ( err ) } fmt . Println ( t ) // 2020-07-24 09:07:29 +0000 UTC str := timefmt . Format ( t , "%Y/%m/%d %H:%M:%S" ) fmt . Println
carbon:Golang的Carbon，时间的延伸
05-03
碳 基于PHP的库的的简单扩展。 特征： 嵌入到Carbon中（提供对所有功能的访问） 支持日期的加减 提供比较日期的方法 支持常用格式的日期格式 轻松计算日期之间的差异 通过使用carbon.Freeze()和carbon.Now()轻松进行日期测试 去做： 实现与Carbon一样的所有本地化功能 改善代码风格以使其更加惯用 入门 安装碳纤维： go get github.com/uniplaces/carbon 添加到您的导入中以开始使用Carbon import "github.com/uniplaces/carbon" 例子 一个简单的示例，可以帮助您入门： package main import ( "fmt" "time" "github.com/uniplaces/carbon" ) func main () { fmt . Printf ( "Rig
Golang time库
qq_37112905的博客
08-08 365
Golang time包常用函数及其原理 time.Now()函数：type Time struct { wall uint64 ext int64 loc *Location } type Location struct { name string zone []zone tx []zoneTrans cacheStart int64 cacheEnd int64 ...
go语言time库
jakelihua
04-12 334
time包是Go语言标准库中的一个包，它提供了时间处理相关函数。time包中定义了一个名为Time的类型，表示一个日期和时间值。time.Now()：获取当前时间。time.Parse(layout, value string)：根据指定的格式解析时间字符串，并返回对应的Time类型。time.Location)：根据指定的格式和时区解析时间字符串，并返回对应的Time类型。time.Time.Format(layout string)：将时间格式化为指定的字符串格式。
Golang Carbon 项目教程
gitblog_00568的博客
08-09 343
Golang Carbon 项目教程 carbonA simple, semantic and developer-friendly golang package for datetime项目地址:https://gitcode.com/gh_mirrors/carbon/carbon 1. 项目的目录结构及介绍 Golang Carbon 项目的目录结构如下： carbon/ ├── LICE...
Go 每日一库之 go-carbon，优雅的golang日期时间处理库
够过瘾专栏
02-03 5354
Carbon carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库，支持链式调用和 gorm、xorm、zorm 等主流 orm。 安装使用 // 使用 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 ( "gite
Go 标准库介绍二: time
ironxu的专栏
03-08 967
发表一篇介绍Go 标准库 time 常用导出函数，结构体及其方法的笔记博客。
gin-jwt/v2 与 "github.com/golang-jwt/jwt/v4" 使用jwt 冲突
03-17
gin-jwt/v2 和 "github.com/golang-jwt/jwt/v4" 都是 Go 语言中用于处理 JSON Web Token (JWT) 的库，它们之间可能存在一些使用上的冲突。 gin-jwt/v2 是一个专门为 Gin 框架设计的 JWT 中间件，它提供了一些方便的功能来验证和生成 JWT。它使用了 "github.com/dgrijalva/jwt-go" 这个库来处理 JWT 的生成和验证。 而 "github.com/golang-jwt/jwt/v4" 是一个通用的 JWT 库，它提供了一些基本的功能来生成和验证 JWT。它是由 Go 官方团队维护的，相对来说更加稳定和可靠。 由于这两个库都涉及到 JWT 的生成和验证，所以在使用时可能会存在一些冲突。例如，可能会出现导入冲突或者函数命名冲突的情况。 为了解决这个问题，你可以考虑以下几种方法： 1. 使用不同的别名导入库：可以给其中一个库起一个别名，以避免导入冲突。 2. 手动处理 JWT：如果你只需要基本的 JWT 功能，你也可以选择手动处理 JWT，而不使用这两个库中的任何一个。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值