Go日期时间处理工具Carbon

注意：本文大部分内容摘抄自-https://github.com/dromara/carbon/blob/master/README.cn.md使用文档
一、简介

一个轻量级的、易于使用的、语义智能的日期时间处理库，支持链式调用，已被 awesome-go 收录，现已经捐赠给了 dromara 组织
二、安装

注意：需要go版本在1.17以上：go >= 1.17

1.GitHub地址

项目地址：github.com/dromara/carbon
官方使用文档：https://github.com/dromara/carbon/blob/master/README.cn.md
安装命令：go get -u github.com/dromara/carbon/v2

2.Gitee地址

项目地址：gitee.com/dromara/carbon
官方使用文档：https://gitee.com/dromara/carbon/blob/master/README.cn.md
安装命令：go get -u gitee.com/dromara/carbon/v2

3.GitCode地址

项目地址：gitcode.com/dromara/carbon
官方使用文档：https://gitcode.com/dromara/carbon/blob/master/README.cn.md
安装命令：go get -u gitcode.com/dromara/carbon/v2
三、使用

注意：由于捐赠给了 dromara 组织，目前仓库地址已经发生变动，如果之前用的路径是 golang-module/carbon需要修改为新路径，或执行如下命令：

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

复制代码

1、简单使用

1. package main
3. import (
4.         "fmt"
5.         "github.com/dromara/carbon/v2"
6. )
8. func main() {
9.         now := carbon.Now()
10.         fmt.Println("当前时间:", now)
11. }
13. // 打印值 当前时间: 2025-02-19 11:09:14

复制代码

2、详细用法示例

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

1. 设置全局默认值

1. carbon.SetDefault(carbon.Default{
2.   Layout: carbon.DateTimeLayout,
3.   Timezone: carbon.PRC,
4.   WeekStartsAt: carbon.Sunday,
5.   Locale: "zh-CN", // 取值范围：lang 目录下翻译文件名，不包含文件后缀
6. })

复制代码

建议在入口文件如 main.go 中设置

2. Carbon 和 time.Time 互转

1. // 将标准 time.Time 转换成 Carbon
2. carbon.CreateFromStdTime(time.Now())
3. // 将 Carbon 转换成标准 time.Time
4. carbon.Now().StdTime()

复制代码

3. 昨天、今天、来日诰日

1. // 今天此刻
2. fmt.Printf("%s", carbon.Now()) // 2020-08-05 13:14:15
3. carbon.Now().String() // 2020-08-05 13:14:15
4. carbon.Now().ToString() // 2020-08-05 13:14:15 +0800 CST
5. carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15
6. // 今天日期
7. carbon.Now().ToDateString() // 2020-08-05
8. // 今天时间
9. carbon.Now().ToTimeString() // 13:14:15
10. // 指定时区的今天此刻
11. carbon.Now(Carbon.NewYork).ToDateTimeString() // 2020-08-05 14:14:15
12. // 今天秒级时间戳
13. carbon.Now().Timestamp() // 1596604455
14. // 今天毫秒级时间戳
15. carbon.Now().TimestampMilli() // 1596604455999
16. // 今天微秒级时间戳
17. carbon.Now().TimestampMicro() // 1596604455999999
18. // 今天纳秒级时间戳
19. carbon.Now().TimestampNano() // 1596604455999999999
21. // 昨天此刻
22. fmt.Printf("%s", carbon.Yesterday()) // 2020-08-04 13:14:15
23. carbon.Yesterday().String() // 2020-08-04 13:14:15
24. carbon.Yesterday().ToString() // 2020-08-04 13:14:15 +0800 CST
25. carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15
26. // 昨天日期
27. carbon.Yesterday().ToDateString() // 2020-08-04
28. // 昨天时间
29. carbon.Yesterday().ToTimeString() // 13:14:15
30. // 指定日期的昨天此刻
31. carbon.Parse("2021-01-28 13:14:15").Yesterday().ToDateTimeString() // 2021-01-27 13:14:15
32. // 指定时区的昨天此刻
33. carbon.Yesterday(Carbon.NewYork).ToDateTimeString() // 2020-08-04 14:14:15
34. // 昨天秒级时间戳
35. carbon.Yesterday().Timestamp() // 1596518055
36. // 昨天毫秒级时间戳
37. carbon.Yesterday().TimestampMilli() // 1596518055999
38. // 昨天微秒级时间戳
39. carbon.Yesterday().TimestampMicro() // 1596518055999999
40. // 昨天纳秒级时间戳
41. carbon.Yesterday().TimestampNano() // 1596518055999999999
43. // 明天此刻
44. fmt.Printf("%s", carbon.Tomorrow()) // 2020-08-06 13:14:15
45. carbon.Tomorrow().String() // 2020-08-06 13:14:15
46. carbon.Tomorrow().ToString() // 2020-08-06 13:14:15 +0800 CST
47. carbon.Tomorrow().ToDateTimeString() // 2020-08-06 13:14:15
48. // 明天日期
49. carbon.Tomorrow().ToDateString() // 2020-08-06
50. // 明天时间
51. carbon.Tomorrow().ToTimeString() // 13:14:15
52. // 指定日期的明天此刻
53. carbon.Parse("2021-01-28 13:14:15").Tomorrow().ToDateTimeString() // 2021-01-29 13:14:15
54. // 指定时区的明天此刻
55. carbon.Tomorrow(Carbon.NewYork).ToDateTimeString() // 2020-08-06 14:14:15
56. // 明天秒级时间戳
57. carbon.Tomorrow().Timestamp() // 1596690855
58. // 明天毫秒级时间戳
59. carbon.Tomorrow().TimestampMilli() // 1596690855999
60. // 明天微秒级时间戳
61. carbon.Tomorrow().TimestampMicro() // 1596690855999999
62. // 明天纳秒级时间戳
63. carbon.Tomorrow().TimestampNano() // 1596690855999999999

复制代码

4. 创建 Carbon 实例

1. // 从秒级时间戳创建 Carbon 实例
2. carbon.CreateFromTimestamp(-1).ToString() // 1970-01-01 07:59:59 +0800 CST
3. carbon.CreateFromTimestamp(0).ToString() // 1970-01-01 08:00:00 +0800 CST
4. carbon.CreateFromTimestamp(1).ToString() // 1970-01-01 08:00:01 +0800 CST
5. carbon.CreateFromTimestamp(1649735755).ToString() // 2022-04-12 11:55:55 +0800 CST
6. // 从毫秒级时间戳创建 Carbon 实例
7. carbon.CreateFromTimestampMilli(1649735755981).ToString() // 2022-04-12 11:55:55.981 +0800 CST
8. // 从微秒级时间戳创建 Carbon 实例
9. carbon.CreateFromTimestampMicro(1649735755981566).ToString() // 2022-04-12 11:55:55.981566 +0800 CST
10. // 从纳秒级时间戳创建 Carbon 实例
11. carbon.CreateFromTimestampNano(1649735755981566000).ToString() // 2022-04-12 11:55:55.981566 +0800 CST
13. // 从年月日时分秒创建 Carbon 实例
14. carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
15. // 从年月日时分秒创建 Carbon 实例，包含毫秒
16. carbon.CreateFromDateTimeMilli(2020, 8, 5, 13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
17. // 从年月日时分秒创建 Carbon 实例，包含微秒
18. carbon.CreateFromDateTimeMicro(2020, 8, 5, 13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
19. // 从年月日时分秒创建 Carbon 实例，包含纳秒
20. carbon.CreateFromDateTimeNano(2020, 8, 5, 13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
22. // 从年月日创建 Carbon 实例
23. carbon.CreateFromDate(2020, 8, 5).ToString() // 2020-08-05 00:00:00 +0800 CST
24. // 从年月日创建 Carbon 实例，包含毫秒
25. carbon.CreateFromDateMilli(2020, 8, 5, 999).ToString() // 2020-08-05 00:00:00.999 +0800 CST
26. // 从年月日创建 Carbon 实例，包含微秒
27. carbon.CreateFromDateMicro(2020, 8, 5, 999999).ToString() // 2020-08-05 00:00:00.999999 +0800 CST
28. // 从年月日创建 Carbon 实例，包含纳秒
29. carbon.CreateFromDateNano(2020, 8, 5, 999999999).ToString() // 2020-08-05 00:00:00.999999999 +0800 CST
31. // 从时分秒创建 Carbon 实例(年月日默认为当前年月日)
32. carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
33. // 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含毫秒
34. carbon.CreateFromTimeMilli(13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
35. // 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含微秒
36. carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
37. // 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含纳秒
38. carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

复制代码

5. 将 时间字符串 剖析成 Carbon 实例

1. carbon.Parse("").ToDateTimeString() // 空字符串
2. carbon.Parse("0").ToDateTimeString() // 空字符串
3. carbon.Parse("00:00:00").ToDateTimeString() // 空字符串
4. carbon.Parse("0000-00-00").ToDateTimeString() // 空字符串
5. carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空字符串
7. carbon.Parse("now").ToString() // 2020-08-05 13:14:15 +0800 CST
8. carbon.Parse("yesterday").ToString() // 2020-08-04 13:14:15 +0800 CST
9. carbon.Parse("tomorrow").ToString() // 2020-08-06 13:14:15 +0800 CST
11. carbon.Parse("2020").ToString() // 2020-01-01 00:00:00 +0800 CST
12. carbon.Parse("2020-8").ToString() // 2020-08-01 00:00:00 +0800 CST
13. carbon.Parse("2020-08").ToString() // 2020-08-01 00:00:00 +0800 CST
14. carbon.Parse("2020-8-5").ToString() // 2020-08-05 00:00:00 +0800 CST
15. carbon.Parse("2020-8-05").ToString() // 2020-08-05 00:00:00 +0800 CST
16. carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0800 CST
17. carbon.Parse("2020-08-05.999").ToString() // 2020-08-05 00:00:00.999 +0800 CST
18. carbon.Parse("2020-08-05.999999").ToString() // 2020-08-05 00:00:00.999999 +0800 CST
19. carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0800 CST
21. carbon.Parse("2020-8-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
22. carbon.Parse("2020-8-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
23. carbon.Parse("2020-08-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
24. carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
25. carbon.Parse("2020-08-05 13:14:15.999").ToString() // 2020-08-05 13:14:15.999 +0800 CST
26. carbon.Parse("2020-08-05 13:14:15.999999").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
27. carbon.Parse("2020-08-05 13:14:15.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
29. carbon.Parse("2020-8-5T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0800 CST
30. carbon.Parse("2020-8-05T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0800 CST
31. carbon.Parse("2020-08-05T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0800 CST
32. carbon.Parse("2020-08-05T13:14:15.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0800 CST
33. carbon.Parse("2020-08-05T13:14:15.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
34. carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
36. carbon.Parse("20200805").ToString() // 2020-08-05 00:00:00 +0800 CST
37. carbon.Parse("20200805131415").ToString() // 2020-08-05 13:14:15 +0800 CST
38. carbon.Parse("20200805131415.999").ToString() // 2020-08-05 13:14:15.999 +0800 CST
39. carbon.Parse("20200805131415.999999").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
40. carbon.Parse("20200805131415.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
41. carbon.Parse("20200805131415.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0800 CST
42. carbon.Parse("20200805131415.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
43. carbon.Parse("20200805131415.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

复制代码

6. 通过 格式模板 将时间字符串剖析成 Carbon 实例

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

1. carbon.ParseByFormat("2020|08|05 13|14|15", "Y|m|d H|i|s").ToDateTimeString() // 2020-08-05 13:14:15
2. 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
3. carbon.ParseByFormat("今天是 2020年08月05日13时14分15秒", "今天是 Y年m月d日H时i分s秒").ToDateTimeString() // 2020-08-05 13:14:15
4. carbon.ParseByFormat("2020-08-05 13:14:15", "Y-m-d H:i:s", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15

复制代码

7. 通过 结构模板 将时间字符串剖析成 Carbon 实例

1. carbon.ParseByLayout("2020|08|05 13|14|15", "2006|01|02 15|04|05").ToDateTimeString() // 2020-08-05 13:14:15
2. 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
3. carbon.ParseByLayout("今天是 2020年08月05日13时14分15秒", "今天是 2006年01月02日15时04分05秒").ToDateTimeString() // 2020-08-05 13:14:15
4. carbon.ParseByLayout("2020-08-05 13:14:15", "2006-01-02 15:04:05", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15

复制代码

8. 时间边界

1. // 本世纪开始时间
2. carbon.Parse("2020-08-05 13:14:15").StartOfCentury().ToDateTimeString() // 2000-01-01 00:00:00
3. // 本世纪结束时间
4. carbon.Parse("2020-08-05 13:14:15").EndOfCentury().ToDateTimeString() // 2999-12-31 23:59:59
6. // 本年代开始时间
7. carbon.Parse("2020-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
8. carbon.Parse("2021-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
9. carbon.Parse("2029-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
10. // 本年代结束时间
11. carbon.Parse("2020-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
12. carbon.Parse("2021-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
13. carbon.Parse("2029-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
15. // 本年开始时间
16. carbon.Parse("2020-08-05 13:14:15").StartOfYear().ToDateTimeString() // 2020-01-01 00:00:00
17. // 本年结束时间
18. carbon.Parse("2020-08-05 13:14:15").EndOfYear().ToDateTimeString() // 2020-12-31 23:59:59
20. // 本季度开始时间
21. carbon.Parse("2020-08-05 13:14:15").StartOfQuarter().ToDateTimeString() // 2020-07-01 00:00:00
22. // 本季度结束时间
23. carbon.Parse("2020-08-05 13:14:15").EndOfQuarter().ToDateTimeString() // 2020-09-30 23:59:59
25. // 本月开始时间
26. carbon.Parse("2020-08-05 13:14:15").StartOfMonth().ToDateTimeString() // 2020-08-01 00:00:00
27. // 本月结束时间
28. carbon.Parse("2020-08-05 13:14:15").EndOfMonth().ToDateTimeString() // 2020-08-31 23:59:59
30. // 本周开始时间
31. carbon.Parse("2020-08-05 13:14:15").StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
32. carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
33. carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).StartOfWeek().ToDateTimeString() // 2020-08-03 00:00:00
34. // 本周结束时间
35. carbon.Parse("2020-08-05 13:14:15").EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
36. carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
37. carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).EndOfWeek().ToDateTimeString() // 2020-08-09 23:59:59
39. // 本日开始时间
40. carbon.Parse("2020-08-05 13:14:15").StartOfDay().ToDateTimeString() // 2020-08-05 00:00:00
41. // 本日结束时间
42. carbon.Parse("2020-08-05 13:14:15").EndOfDay().ToDateTimeString() // 2020-08-05 23:59:59
44. // 本小时开始时间
45. carbon.Parse("2020-08-05 13:14:15").StartOfHour().ToDateTimeString() // 2020-08-05 13:00:00
46. // 本小时结束时间
47. carbon.Parse("2020-08-05 13:14:15").EndOfHour().ToDateTimeString() // 2020-08-05 13:59:59
49. // 本分钟开始时间
50. carbon.Parse("2020-08-05 13:14:15").StartOfMinute().ToDateTimeString() // 2020-08-05 13:14:00
51. // 本分钟结束时间
52. carbon.Parse("2020-08-05 13:14:15").EndOfMinute().ToDateTimeString() // 2020-08-05 13:14:59
54. // 本秒开始时间
55. carbon.Parse("2020-08-05 13:14:15").StartOfSecond().ToString() // 2020-08-05 13:14:15 +0800 CST
56. // 本秒结束时间
57. carbon.Parse("2020-08-05 13:14:15").EndOfSecond().ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

复制代码

9. 时间旅行

1. // 三个世纪后
2. carbon.Parse("2020-02-29 13:14:15").AddCenturies(3).ToDateTimeString() // 2320-02-29 13:14:15
3. // 三个世纪后(月份不溢出)
4. carbon.Parse("2020-02-29 13:14:15").AddCenturiesNoOverflow(3).ToDateTimeString() // 2320-02-29 13:14:15
5. // 一个世纪后
6. carbon.Parse("2020-02-29 13:14:15").AddCentury().ToDateTimeString() // 2120-02-29 13:14:15
7. // 一个世纪后(月份不溢出)
8. carbon.Parse("2020-02-29 13:14:15").AddCenturyNoOverflow().ToDateTimeString() // 2120-02-29 13:14:15
9. // 三个世纪前
10. carbon.Parse("2020-02-29 13:14:15").SubCenturies(3).ToDateTimeString() // 1720-02-29 13:14:15
11. // 三个世纪前(月份不溢出)
12. carbon.Parse("2020-02-29 13:14:15").SubCenturiesNoOverflow(3).ToDateTimeString() // 1720-02-29 13:14:15
13. // 一个世纪前
14. carbon.Parse("2020-02-29 13:14:15").SubCentury().ToDateTimeString() // 1920-02-29 13:14:15
15. // 一世纪前(月份不溢出)
16. carbon.Parse("2020-02-29 13:14:15").SubCenturyNoOverflow().ToDateTimeString() // 1920-02-29 13:14:15
18. // 三个年代后
19. carbon.Parse("2020-02-29 13:14:15").AddDecades(3).ToDateTimeString() // 2050-03-01 13:14:15
20. // 三个年代后(月份不溢出)
21. carbon.Parse("2020-02-29 13:14:15").AddDecadesNoOverflow(3).ToDateTimeString() // 2050-02-28 13:14:15
22. // 一个年代后
23. carbon.Parse("2020-02-29 13:14:15").AddDecade().ToDateTimeString() // 2030-03-01 13:14:15
24. // 一个年代后(月份不溢出)
25. carbon.Parse("2020-02-29 13:14:15").AddDecadeNoOverflow().ToDateTimeString() // 2030-02-28 13:14:15
26. // 三个年代前
27. carbon.Parse("2020-02-29 13:14:15").SubDecades(3).ToDateTimeString() // 1990-03-01 13:14:15
28. // 三个年代前(月份不溢出)
29. carbon.Parse("2020-02-29 13:14:15").SubDecadesNoOverflow(3).ToDateTimeString() // 1990-02-28 13:14:15
30. // 一个年代前
31. carbon.Parse("2020-02-29 13:14:15").SubDecade().ToDateTimeString() // 2010-03-01 13:14:15
32. // 一个年代前(月份不溢出)
33. carbon.Parse("2020-02-29 13:14:15").SubDecadeNoOverflow().ToDateTimeString() // 2010-02-28 13:14:15
35. // 三年后
36. carbon.Parse("2020-02-29 13:14:15").AddYears(3).ToDateTimeString() // 2023-03-01 13:14:15
37. // 三年后(月份不溢出)
38. carbon.Parse("2020-02-29 13:14:15").AddYearsNoOverflow(3).ToDateTimeString() // 2023-02-28 13:14:15
39. // 一年后
40. carbon.Parse("2020-02-29 13:14:15").AddYear().ToDateTimeString() // 2021-03-01 13:14:15
41. // 一年后(月份不溢出)
42. carbon.Parse("2020-02-29 13:14:15").AddYearNoOverflow().ToDateTimeString() // 2021-02-28 13:14:15
43. // 三年前
44. carbon.Parse("2020-02-29 13:14:15").SubYears(3).ToDateTimeString() // 2017-03-01 13:14:15
45. // 三年前(月份不溢出)
46. carbon.Parse("2020-02-29 13:14:15").SubYearsNoOverflow(3).ToDateTimeString() // 2017-02-28 13:14:15
47. // 一年前
48. carbon.Parse("2020-02-29 13:14:15").SubYear().ToDateTimeString() // 2019-03-01 13:14:15
49. // 一年前(月份不溢出)
50. carbon.Parse("2020-02-29 13:14:15").SubYearNoOverflow().ToDateTimeString() // 2019-02-28 13:14:15
52. // 三个季度后
53. carbon.Parse("2019-05-31 13:14:15").AddQuarters(3).ToDateTimeString() // 2020-03-02 13:14:15
54. // 三个季度后(月份不溢出)
55. carbon.Parse("2019-05-31 13:14:15").AddQuartersNoOverflow(3).ToDateTimeString() // 2020-02-29 13:14:15
56. // 一个季度后
57. carbon.Parse("2019-11-30 13:14:15").AddQuarter().ToDateTimeString() // 2020-03-01 13:14:15
58. // 一个季度后(月份不溢出)
59. carbon.Parse("2019-11-30 13:14:15").AddQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
60. // 三个季度前
61. carbon.Parse("2019-08-31 13:14:15").SubQuarters(3).ToDateTimeString() // 2019-03-03 13:14:15
62. // 三个季度前(月份不溢出)
63. carbon.Parse("2019-08-31 13:14:15").SubQuartersNoOverflow(3).ToDateTimeString() // 2019-02-28 13:14:15
64. // 一个季度前
65. carbon.Parse("2020-05-31 13:14:15").SubQuarter().ToDateTimeString() // 2020-03-02 13:14:15
66. // 一个季度前(月份不溢出)
67. carbon.Parse("2020-05-31 13:14:15").SubQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
69. // 三个月后
70. carbon.Parse("2020-02-29 13:14:15").AddMonths(3).ToDateTimeString() // 2020-05-29 13:14:15
71. // 三个月后(月份不溢出)
72. carbon.Parse("2020-02-29 13:14:15").AddMonthsNoOverflow(3).ToDateTimeString() // 2020-05-29 13:14:15
73. // 一个月后
74. carbon.Parse("2020-01-31 13:14:15").AddMonth().ToDateTimeString() // 2020-03-02 13:14:15
75. // 一个月后(月份不溢出)
76. carbon.Parse("2020-01-31 13:14:15").AddMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
77. // 三个月前
78. carbon.Parse("2020-02-29 13:14:15").SubMonths(3).ToDateTimeString() // 2019-11-29 13:14:15
79. // 三个月前(月份不溢出)
80. carbon.Parse("2020-02-29 13:14:15").SubMonthsNoOverflow(3).ToDateTimeString() // 2019-11-29 13:14:15
81. // 一个月前
82. carbon.Parse("2020-03-31 13:14:15").SubMonth().ToDateTimeString() // 2020-03-02 13:14:15
83. // 一个月前(月份不溢出)
84. carbon.Parse("2020-03-31 13:14:15").SubMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
86. // 三周后
87. carbon.Parse("2020-02-29 13:14:15").AddWeeks(3).ToDateTimeString() // 2020-03-21 13:14:15
88. // 一周后
89. carbon.Parse("2020-02-29 13:14:15").AddWeek().ToDateTimeString() // 2020-03-07 13:14:15
90. // 三周前
91. carbon.Parse("2020-02-29 13:14:15").SubWeeks(3).ToDateTimeString() // 2020-02-08 13:14:15
92. // 一周前
93. carbon.Parse("2020-02-29 13:14:15").SubWeek().ToDateTimeString() // 2020-02-22 13:14:15
95. // 三天后
96. carbon.Parse("2020-08-05 13:14:15").AddDays(3).ToDateTimeString() // 2020-08-08 13:14:15
97. // 一天后
98. carbon.Parse("2020-08-05 13:14:15").AddDay().ToDateTimeString() // 2020-08-05 13:14:15
99. // 三天前
100. carbon.Parse("2020-08-05 13:14:15").SubDays(3).ToDateTimeString() // 2020-08-02 13:14:15
101. // 一天前
102. carbon.Parse("2020-08-05 13:14:15").SubDay().ToDateTimeString() // 2020-08-04 13:14:15
104. // 三小时后
105. carbon.Parse("2020-08-05 13:14:15").AddHours(3).ToDateTimeString() // 2020-08-05 16:14:15
106. // 二小时半后
107. carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5h").ToDateTimeString() // 2020-08-05 15:44:15
108. carbon.Parse("2020-08-05 13:14:15").AddDuration("2h30m").ToDateTimeString() // 2020-08-05 15:44:15
109. // 一小时后
110. carbon.Parse("2020-08-05 13:14:15").AddHour().ToDateTimeString() // 2020-08-05 14:14:15
111. // 三小时前
112. carbon.Parse("2020-08-05 13:14:15").SubHours(3).ToDateTimeString() // 2020-08-05 10:14:15
113. // 二小时半前
114. carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5h").ToDateTimeString() // 2020-08-05 10:44:15
115. carbon.Parse("2020-08-05 13:14:15").SubDuration("2h30m").ToDateTimeString() // 2020-08-05 10:44:15
116. // 一小时前
117. carbon.Parse("2020-08-05 13:14:15").SubHour().ToDateTimeString() // 2020-08-05 12:14:15
119. // 三分钟后
120. carbon.Parse("2020-08-05 13:14:15").AddMinutes(3).ToDateTimeString() // 2020-08-05 13:17:15
121. // 二分钟半后
122. carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5m").ToDateTimeString() // 2020-08-05 13:16:45
123. carbon.Parse("2020-08-05 13:14:15").AddDuration("2m30s").ToDateTimeString() // 2020-08-05 13:16:45
124. // 一分钟后
125. carbon.Parse("2020-08-05 13:14:15").AddMinute().ToDateTimeString() // 2020-08-05 13:15:15
126. // 三分钟前
127. carbon.Parse("2020-08-05 13:14:15").SubMinutes(3).ToDateTimeString() // 2020-08-05 13:11:15
128. // 二分钟半前
129. carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5m").ToDateTimeString() // 2020-08-05 13:11:45
130. carbon.Parse("2020-08-05 13:14:15").SubDuration("2m30s").ToDateTimeString() // 2020-08-05 13:11:45
131. // 一分钟前
132. carbon.Parse("2020-08-05 13:14:15").SubMinute().ToDateTimeString() // 2020-08-05 13:13:15
134. // 三秒钟后
135. carbon.Parse("2020-08-05 13:14:15").AddSeconds(3).ToDateTimeString() // 2020-08-05 13:14:18
136. // 二秒钟半后
137. carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:17
138. // 一秒钟后
139. carbon.Parse("2020-08-05 13:14:15").AddSecond().ToDateTimeString() // 2020-08-05 13:14:16
140. // 三秒钟前
141. carbon.Parse("2020-08-05 13:14:15").SubSeconds(3).ToDateTimeString() // 2020-08-05 13:14:12
142. // 二秒钟半前
143. carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:12
144. // 一秒钟前
145. carbon.Parse("2020-08-05 13:14:15").SubSecond().ToDateTimeString() // 2020-08-05 13:14:14
147. // 三毫秒后
148. carbon.Parse("2020-08-05 13:14:15.222222222").AddMilliseconds(3).ToString() // 2020-08-05 13:14:15.225222222 +0800 CST
149. // 一毫秒后
150. carbon.Parse("2020-08-05 13:14:15.222222222").AddMillisecond().ToString() // 2020-08-05 13:14:15.223222222 +0800 CST
151. // 三毫秒前
152. carbon.Parse("2020-08-05 13:14:15.222222222").SubMilliseconds(3).ToString() // 2020-08-05 13:14:15.219222222 +0800 CST
153. // 一毫秒前
154. carbon.Parse("2020-08-05 13:14:15.222222222").SubMillisecond().ToString() // 2020-08-05 13:14:15.221222222 +0800 CST
156. // 三微秒后
157. carbon.Parse("2020-08-05 13:14:15.222222222").AddMicroseconds(3).ToString() // 2020-08-05 13:14:15.222225222 +0800 CST
158. // 一微秒后
159. carbon.Parse("2020-08-05 13:14:15.222222222").AddMicrosecond().ToString() // 2020-08-05 13:14:15.222223222 +0800 CST
160. // 三微秒前
161. carbon.Parse("2020-08-05 13:14:15.222222222").SubMicroseconds(3).ToString() // 2020-08-05 13:14:15.222219222 +0800 CST
162. // 一微秒前
163. carbon.Parse("2020-08-05 13:14:15.222222222").SubMicrosecond().ToString() // 2020-08-05 13:14:15.222221222 +0800 CST
165. // 三纳秒后
166. carbon.Parse("2020-08-05 13:14:15.222222222").AddNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222225 +0800 CST
167. // 一纳秒后
168. carbon.Parse("2020-08-05 13:14:15.222222222").AddNanosecond().ToString() // 2020-08-05 13:14:15.222222223 +0800 CST
169. // 三纳秒前
170. carbon.Parse("2020-08-05 13:14:15.222222222").SubNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222219 +0800 CST
171. // 一纳秒前
172. carbon.Parse("2020-08-05 13:14:15.222222222").SubNanosecond().ToString() // 2020-08-05 13:14:15.222222221 +0800 CST

复制代码

10. 时间差值

1. // 相差多少年
2. carbon.Parse("2021-08-05 13:14:15").DiffInYears(carbon.Parse("2020-08-05 13:14:15")) // -1
3. // 相差多少年（绝对值）
4. carbon.Parse("2021-08-05 13:14:15").DiffAbsInYears(carbon.Parse("2020-08-05 13:14:15")) // 1
6. // 相差多少月
7. carbon.Parse("2020-08-05 13:14:15").DiffInMonths(carbon.Parse("2020-07-05 13:14:15")) // -1
8. // 相差多少月（绝对值）
9. carbon.Parse("2020-08-05 13:14:15").DiffAbsInMonths(carbon.Parse("2020-07-05 13:14:15")) // 1
11. // 相差多少周
12. carbon.Parse("2020-08-05 13:14:15").DiffInWeeks(carbon.Parse("2020-07-28 13:14:15")) // -1
13. // 相差多少周（绝对值）
14. carbon.Parse("2020-08-05 13:14:15").DiffAbsInWeeks(carbon.Parse("2020-07-28 13:14:15")) // 1
16. // 相差多少天
17. carbon.Parse("2020-08-05 13:14:15").DiffInDays(carbon.Parse("2020-08-04 13:14:15")) // -1
18. // 相差多少天（绝对值）
19. carbon.Parse("2020-08-05 13:14:15").DiffAbsInDays(carbon.Parse("2020-08-04 13:14:15")) // 1
21. // 相差多少小时
22. carbon.Parse("2020-08-05 13:14:15").DiffInHours(carbon.Parse("2020-08-05 12:14:15")) // -1
23. // 相差多少小时（绝对值）
24. carbon.Parse("2020-08-05 13:14:15").DiffAbsInHours(carbon.Parse("2020-08-05 12:14:15")) // 1
26. // 相差多少分
27. carbon.Parse("2020-08-05 13:14:15").DiffInMinutes(carbon.Parse("2020-08-05 13:13:15")) // -1
28. // 相差多少分（绝对值）
29. carbon.Parse("2020-08-05 13:14:15").DiffAbsInMinutes(carbon.Parse("2020-08-05 13:13:15")) // 1
31. // 相差多少秒
32. carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14:14")) // -1
33. // 相差多少秒（绝对值）
34. carbon.Parse("2020-08-05 13:14:15").DiffAbsInSeconds(carbon.Parse("2020-08-05 13:14:14")) // 1
36. // 相差字符串
37. carbon.Now().DiffInString() // just now
38. carbon.Now().AddYearsNoOverflow(1).DiffInString() // -1 year
39. carbon.Now().SubYearsNoOverflow(1).DiffInString() // 1 year
40. // 相差字符串（绝对值）
41. carbon.Now().DiffAbsInString(carbon.Now()) // just now
42. carbon.Now().AddYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 year
43. carbon.Now().SubYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 year
45. // 相差时长
46. now := carbon.Now()
47. now.DiffInDuration(now).String() // 0s
48. now.AddHour().DiffInDuration(now).String() // 1h0m0s
49. now.SubHour().DiffInDuration(now).String() // -1h0m0s
50. // 相差时长（绝对值）
51. now.DiffAbsInDuration(now).String() // 0s
52. now.AddHour().DiffAbsInDuration(now).String() // 1h0m0s
53. now.SubHour().DiffAbsInDuration(now).String() // 1h0m0s
55. // 对人类友好的可读格式时间差
56. carbon.Parse("2020-08-05 13:14:15").DiffForHumans() // just now
57. carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // 1 year ago
58. carbon.Parse("2018-08-05 13:14:15").DiffForHumans() // 2 years ago
59. carbon.Parse("2021-08-05 13:14:15").DiffForHumans() // 1 year from now
60. carbon.Parse("2022-08-05 13:14:15").DiffForHumans() // 2 years from now
62. carbon.Parse("2020-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year before
63. carbon.Parse("2019-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years before
64. carbon.Parse("2018-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year after
65. carbon.Parse("2022-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years after

复制代码

11. 时间极值

1. c0 := carbon.Parse("2023-04-01")
2. c1 := carbon.Parse("2023-03-28")
3. c2 := carbon.Parse("2023-04-16")
4. // 返回最近的 Carbon 实例
5. c0.Closest(c1, c2) // c1
6. // 返回最远的 Carbon 实例
7. c0.Farthest(c1, c2) // c2
9. yesterday := carbon.Yesterday()
10. today     := carbon.Now()
11. tomorrow  := carbon.Tomorrow()
12. // 返回最大的 Carbon 实例
13. carbon.Max(yesterday, today, tomorrow) // tomorrow
14. // 返回最小的 Carbon 实例
15. carbon.Min(yesterday, today, tomorrow) // yesterday
17. // 返回 Carbon 的最大值
18. carbon.MaxValue().ToString() // 9999-12-31 23:59:59.999999999 +0000 UTC
19. // 返回 Carbon 的最小值
20. carbon.MinValue().ToString() // -9998-01-01 00:00:00 +0000 UTC

复制代码

12. 时间判断

[code]// 是否是夏令时carbon.Parse("").IsDST() // falsecarbon.Parse("0").IsDST() // falsecarbon.Parse("0000-00-00 00:00:00").IsDST() // falsecarbon.Parse("0000-00-00").IsDST() // falsecarbon.Parse("00:00:00").IsDST() // falsecarbon.Parse("2023-01-01", "Australia/Brisbane").IsDST() // falsecarbon.Parse("2023-01-01", "Australia/Sydney").IsDST() // true// 是否是零值时间(0001-01-01 00:00:00 +0000 UTC)carbon.Parse("").IsZero() // truecarbon.Parse("0").IsZero() // truecarbon.Parse("0000-00-00 00:00:00").IsZero() // truecarbon.Parse("0000-00-00").IsZero() // truecarbon.Parse("00:00:00").IsZero() // truecarbon.Parse("2020-08-05 00:00:00").IsZero() // falsecarbon.Parse("2020-08-05").IsZero() // falsecarbon.Parse("2020-08-05").SetTimezone("xxx").IsZero() // false// 是否是有效时间carbon.Parse("").IsValid() // falsecarbon.Parse("0").IsValid() // falsecarbon.Parse("0000-00-00 00:00:00").IsValid() // falsecarbon.Parse("0000-00-00").IsValid() // falsecarbon.Parse("00:00:00").IsValid() // falsecarbon.Parse("2020-08-05 00:00:00").IsValid() // truecarbon.Parse("2020-08-05").IsValid() // truecarbon.Parse("2020-08-05").SetTimezone("xxx").IsValid() // false// 是否是无效时间carbon.Parse("").IsInvalid() // truecarbon.Parse("0").IsInvalid() // truecarbon.Parse("0000-00-00 00:00:00").IsInvalid() // truecarbon.Parse("0000-00-00").IsInvalid() // truecarbon.Parse("00:00:00").IsInvalid() // truecarbon.Parse("2020-08-05 00:00:00").IsInvalid() // falsecarbon.Parse("2020-08-05").IsInvalid() // falsecarbon.Parse("2020-08-05").SetTimezone("xxx").IsInvalid() // true// 是否是上午carbon.Parse("2020-08-05 00:00:00").IsAM() // truecarbon.Parse("2020-08-05 08:00:00").IsAM() // truecarbon.Parse("2020-08-05 12:00:00").IsAM() // falsecarbon.Parse("2020-08-05 13:00:00").IsAM() // false// 是否是下午carbon.Parse("2020-08-05 00:00:00").IsPM() // falsecarbon.Parse("2020-08-05 08:00:00").IsPM() // falsecarbon.Parse("2020-08-05 12:00:00").IsPM() // truecarbon.Parse("2020-08-05 13:00:00").IsPM() // 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() // truecarbon.Parse("2020-08-04 00:00:00").IsYesterday() // truecarbon.Parse("2020-08-04").IsYesterday() // true// 是否是今天carbon.Parse("2020-08-05 13:14:15").IsToday() // truecarbon.Parse("2020-08-05 00:00:00").IsToday() // truecarbon.Parse("2020-08-05").IsToday() // true// 是否是来日诰日carbon.Parse("2020-08-06 13:14:15").IsTomorrow() // truecarbon.Parse("2020-08-06 00:00:00").IsTomorrow() // truecarbon.Parse("2020-08-06").IsTomorrow() // true// 是否是同一世纪carbon.Parse("2020-08-05 13:14:15").IsSameCentury(carbon.Parse("3020-08-05 13:14:15")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // falsecarbon.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")) // truecarbon.Parse("2020-08-05 13:14:15").Gt(carbon.Parse("2020-08-05 13:14:15")) // falsecarbon.Parse("2020-08-05 13:14:15").Compare(">", carbon.Parse("2020-08-04 13:14:15")) // truecarbon.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")) // truecarbon.Parse("2020-08-05 13:14:15").Lt(carbon.Parse("2020-08-05 13:14:15")) // falsecarbon.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")) // truecarbon.Parse("2020-08-05 13:14:15").Lte(carbon.Parse("2020-08-05 13:14:15")) // truecarbon.Parse("2020-08-05 13:14:15").Compare("