carbon

package module
v1.2.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 18, 2021 License: MIT Imports: 5 Imported by: 169

README

Carbon

中文 | English

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

如果您觉得不错，请给个 star 吧

github:github.com/golang-module/carbon

gitee:gitee.com/go-package/carbon

安装使用
// 使用 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 (
    "gitee.com/go-package/carbon"
)
用法示例

默认时区为 Local，即服务器所在时区，假设当前时间为 2020-08-05 13:14:15

昨天、今天、明天
// 今天此刻
carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15
// 今天日期
carbon.Now().ToDateString() // 2020-08-05
// 今天时间
carbon.Now().ToTimeString() // 13:14:15
// 今天秒级时间戳
carbon.Now().ToTimestamp() // 1596604455
carbon.Now().ToTimestampWithSecond() // 1596604455
// 今天毫秒级时间戳
carbon.Now().ToTimestampWithMillisecond() // 1596604455000
// 今天微秒级时间戳
carbon.Now().ToTimestampWithMicrosecond() // 1596604455000000
// 今天纳秒级时间戳
carbon.Now().ToTimestampWithNanosecond() // 1596604455000000000

// 昨天此刻
carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15
// 昨天日期
carbon.Yesterday().ToDateString() // 2020-08-04
// 昨天时间
carbon.Yesterday().ToTimeString() // 13:14:15
// 昨天秒级时间戳
carbon.Yesterday().ToTimestamp() // 1596518055
carbon.Yesterday().ToTimestampWithSecond() // 1596518055
// 明天毫秒级时间戳
carbon.Yesterday().ToTimestampWithMillisecond() // 1596518055000
// 明天微秒级时间戳
carbon.Yesterday().ToTimestampWithMicrosecond() // 1596518055000000
// 明天纳秒级时间戳
carbon.Yesterday().ToTimestampWithNanosecond() // 1596518055000000000

// 明天此刻
carbon.Tomorrow().ToDateTimeString() // 2020-08-06 13:14:15
// 明天日期
carbon.Tomorrow().ToDateString() // 2020-08-06
// 明天时间
carbon.Tomorrow().ToTimeString() // 13:14:15
// 明天秒级时间戳
carbon.Tomorrow().ToTimestamp() // 1596690855
carbon.Tomorrow().ToTimestampWithSecond() // 1596690855
// 明天毫秒级时间戳
carbon.Tomorrow().ToTimestampWithMillisecond() // 1596690855000
// 明天微秒级时间戳
carbon.Tomorrow().ToTimestampWithMicrosecond() // 1596690855000000
// 明天纳秒级时间戳
carbon.Tomorrow().ToTimestampWithNanosecond() // 1596690855000000000
创建 Carbon 实例
// 从秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestamp(1596604455).ToDateTimeString() // 2020-08-05 13:14:15
// 从毫秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestamp(1596604455000).ToDateTimeString() // 2020-08-05 13:14:15
// 从微秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestamp(1596604455000000).ToDateTimeString() // 2020-08-05 13:14:15
// 从纳级时间戳创建 Carbon 实例
carbon.CreateFromTimestamp(1596604455000000000).ToDateTimeString() // 2020-08-05 13:14:15

// 从年月日时分秒创建 Carbon 实例
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToDateTimeString() // 2020-08-05 13:14:15
// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)
carbon.CreateFromDate(2020, 8, 5).ToDateTimeString() // 2020-08-05 13:14:15
// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)
carbon.CreateFromTime(13, 14, 15).ToDateTimeString() // 2020-08-05 13:14:15
// 从原生 time.Time 创建 Carbon 实例
carbon.CreateFromGoTime(time.Now()).ToTimestamp() // 1596604455
carbon和time.Time互转
// Go 内置 Time.time 转 Carbon
carbon.CreateFromGoTime(time.Now())
// Carbon 转 Go 内置 Time.time
carbon.Now().ToGoTime()
解析标准格式时间字符串
carbon.Parse("").ToDateTimeString() // 空字符串
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空字符串
carbon.Parse("0000-00-00").ToDateTimeString() // 空字符串
carbon.Parse("2020-08-05 13:14:15").ToDateTimeString() // 2020-08-05 13:14:15
carbon.Parse("2020-08-05").ToDateTimeString() // 2020-08-05 00:00:00
carbon.Parse("20200805131415").ToDateTimeString() // 2020-08-05 13:14:15
carbon.Parse("20200805").ToDateTimeString() // 2020-08-05 00:00:00
carbon.Parse("2020-08-05T13:14:15+08:00").ToDateTimeString() // 2020-08-05 00:00:00
解析自定义格式时间字符串
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").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日", "Y年m月d日").ToDateTimeString() // 2020-08-05 00:00:00
carbon.ParseByFormat("13时14分15秒", "H时i分s秒").ToDateTimeString() // 2020-08-05 13:14:15
解析持续时间字符串(基于当前时间)

支持正负整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合

// 十小时后
carbon.ParseByDuration("10h").ToDateTimeString() // 2020-08-06 23:14:15
// 十小时半前
carbon.ParseByDuration("-10.5h").ToDateTimeString() // 2020-08-05 02:44:15
// 十分钟后
carbon.ParseByDuration("10m").ToDateTimeString() // 2020-08-05 13:24:15
// 十分钟半前
carbon.ParseByDuration("-10.5m").ToDateTimeString() // 2020-08-05 13:03:45
// 十秒后
carbon.ParseByDuration("10s").ToDateTimeString() // 2020-08-05 13:14:25
// 十秒半前
carbon.ParseByDuration("-10.5s").ToDateTimeString() // 2020-08-05 13:14:04
时间设置
// 设置时区
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).SetTimezone(carbon.PRC).Now().ToDateTimeString() // 2020-08-05 13:14:15

// 设置年
carbon.Parse("2019-08-05").SetYear(2020).ToDateString() // 2020-08-05
carbon.Parse("2020-02-29").SetYear(2019).ToDateString() // 2019-03-01

// 设置月
carbon.Parse("2020-01-31").SetMonth(2).ToDateString() // 2020-03-02
carbon.Parse("2020-08-05").SetMonth(2).ToDateString() // 2020-02-05

// 设置日
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

更多时区常量请查看const.go文件

开始时间、结束时间
// 本年开始时间
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").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-03 00:00:00
// 本周结束时间
carbon.Parse("2020-08-05 13:14:15").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-02-29 13:14:15").AddYears(3).ToDateTimeString() // 2023-03-01 13:14:15
carbon.Parse("2020-02-29 13:14:15").NextYears(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").NextYear().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").PreYears(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").PreYear().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").NextQuarters(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").NextQuarter().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").PreQuarters(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").PreQuarter().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").NextMonths(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").NextMonth().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").PreMonths(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").PreMonth().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").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").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").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").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").DiffInWeeks(carbon.Parse("2020-07-28 13:14:15")) // -1
// 相差多少周（绝对值）
carbon.Parse("2020-08-05 13:14:15").DiffInWeeksWithAbs(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").DiffInDaysWithAbs(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").DiffInHoursWithAbs(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").DiffInMinutesWithAbs(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").DiffInSecondsWithAbs(carbon.Parse("2020-08-05 13:14:14")) // 1
时间比较
// 是否大于
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").BetweenIncludedStartTime(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").BetweenIncludedStartTime(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").BetweenIncludedEndTime(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").BetweenIncludedEndTime(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
时间判断
// 是否是零值时间
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.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").ToTimestamp() // 1596604455
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithSecond() // 1596604455
// 输出毫秒级时间戳
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMillisecond() // 1596604455000
// 输出微秒级时间戳
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMicrosecond() // 1596604455000000
// 输出纳秒级时间戳
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithNanosecond() // 1596604455000000000

// 输出字符串
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").Format("YmdHis") // 20200805131415
carbon.Parse("2020-08-05 13:14:15").ToFormatString("YmdHis") // 20200805131415
carbon.Parse("2020-08-05 13:14:15").ToFormatString("Y年m月d H时i分s秒") // 2020年08月05日 13时14分15秒
// 输出日期时间字符串
carbon.Parse("2020-08-05 13:14:15").ToDateTimeString() // 2020-08-05 13:14:15
// 输出日期字符串
carbon.Parse("2020-08-05 13:14:15").ToDateString() // 2020-08-05
// 输出时间字符串
carbon.Parse("2020-08-05 13:14:15").ToTimeString() // 13:14:15

// 输出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() // Wed Aug  5 13:14:15 2020
// 输出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

// 输出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
// 输出RFC2822格式字符串
carbon.Parse("2020-08-05 13:14:15").ToRFC2822String() // Wed, 05 Aug 2020 13:14:15 +0800
// 输出RFC3339格式字符串
carbon.Parse("2020-08-05 13:14:15").ToRFC3339String() // 2020-08-05T13:14:15+08:00
// 输出RFC7231格式字符串
carbon.Parse("2020-08-05 13:14:15").ToRFC7231String() // Wed, 05 Aug 2020 05:14:15 GMT

更多格式化输出符号请查看附录 格式化符号表

时间获取
// 获取本年总天数
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").Year() // 2020
// 获取当前季度
carbon.Parse("2020-08-05 13:14:15").Quarter() // 3
// 获取当前月
carbon.Parse("2020-08-05 13:14:15").Month() // 8
// 获取当前日
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.SetTimezone(carbon.PRC).Timezone() // PRC
carbon.SetTimezone(carbon.Tokyo).Timezone() // Asia/Tokyo

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

关于第几周的计算请查看 ISO8601标准

农历支持
// 获取生肖年
carbon.Parse("2020-08-05 13:14:15").ToAnimalYear() // 鼠
// 获取农历年
carbon.Parse("2020-08-05 13:14:15").ToLunarYear() // 庚子

// 是否是鼠年
carbon.Parse("2020-08-05 13:14:15").IsYearOfRat() // true
// 是否是牛年
carbon.Parse("2020-08-05 13:14:15").IsYearOfOx() // false
// 是否是虎年
carbon.Parse("2020-08-05 13:14:15").IsYearOfTiger() // false
// 是否是兔年
carbon.Parse("2020-08-05 13:14:15").IsYearOfRabbit() // false
// 是否是龙年
carbon.Parse("2020-08-05 13:14:15").IsYearOfDragon() // false
// 是否是蛇年
carbon.Parse("2020-08-05 13:14:15").IsYearOfSnake() // false
// 是否是马年
carbon.Parse("2020-08-05 13:14:15").IsYearOfHorse() // false
// 是否是羊年
carbon.Parse("2020-08-05 13:14:15").IsYearOfGoat() // false
// 是否是猴年
carbon.Parse("2020-08-05 13:14:15").IsYearOfMonkey() // false
// 是否是鸡年
carbon.Parse("2020-08-05 13:14:15").IsYearOfRooster() // false
// 是否是狗年
carbon.Parse("2020-08-05 13:14:15").IsYearOfDog() // false
// 是否是猪年
carbon.Parse("2020-08-05 13:14:15").IsYearOfPig() // false
数据库支持

假设数据表为 users，字段有 id(int)、name(varchar)、age(int)、birthday(datetime)、graduated_at(datetime)、created_at(datetime)、updated_at(datetime)、date_time1(datetime)、date_time2(datetime)、date_time3(datetime)、date_time4(datetime)

定义模型
type UserModel struct {
    ID  int64  `json:"id"`
    Name string `json:"name"`
    Age int `json:"age"`
    Birthday carbon.ToDateTimeString `json:"birthday"`
    GraduatedAt carbon.ToDateString `json:"graduated_at"`
    CreatedAt carbon.ToTimeString `json:"created_at"`
    UpdatedAt carbon.ToTimestamp `json:"updated_at"`
    DateTime1 carbon.ToTimestampWithSecond `json:"date_time1"`
    DateTime2 carbon.ToTimestampWithMillisecond `json:"date_time2"`
    DateTime3 carbon.ToTimestampWithMicrosecond `json:"date_time3"`
    DateTime4 carbon.ToTimestampWithNanosecond `json:"date_time4"`
}
实例化模型
user := UserModel {
    ID: 1153,
    Name: "勾国印",
    Age: 18,
    Birthday: carbon.ToDateTimeString{carbon.Now().SubYears(18)},
    GraduatedAt: carbon.ToDateString{carbon.Parse("2012-09-09")},
    CreatedAt: carbon.ToTimeString{carbon.Now()},
    UpdatedAt: carbon.ToTimestamp{carbon.Now()},
    DateTime1: carbon.ToTimestampWithSecond{carbon.Now()},
    DateTime2: carbon.ToTimestampWithMillisecond{carbon.Now()},
    DateTime3: carbon.ToTimestampWithMicrosecond{carbon.Now()},
    DateTime4: carbon.ToTimestampWithNanosecond{carbon.Now()},
}
输出模型字段
user.ID // 1153
user.Name // 勾国印
user.Age // 18
user.Birthday.ToDateTimeString() // 2012-08-05 13:14:15
user.GraduatedAt.ToDateString() // 2012-09-09
user.CreatedAt.ToTimeString() // 13:14:15
user.UpdatedAt.ToTimestamp() // 1596604455
user.DateTime1.ToTimestampWithSecond() // 1596604455
user.DateTime2.ToTimestampWithMillisecond() // 1596604455000
user.DateTime3.ToTimestampWithMicrosecond() // 1596604455000000
user.DateTime4.ToTimestampWithNanosecond() // 1596604455000000000
JSON输出模型
data, _ := json.Marshal(&user)
fmt.Print(string(data))
// 输出
{
    "id": 1153,
    "name": "勾国印",
    "age": 18,
    "birthday": "2012-08-05 13:14:15",
    "graduated_at": "2012-09-09",
    "created_at": "13:14:15",
    "updated_at": 1596604455,
    "date_time1": 1596604455,
    "date_time2": 1596604455000,
    "date_time3": 1596604455000000,
    "date_time4": 1596604455000000000,
}
输出自定义格式
// 定义输出格式
type ToRssString struct {
    carbon.Carbon
}

// 定义模型
type UserModel struct {
    Birthday carbon.ToRssString `json:"birthday"`
}

// 实例化模型
user := UserModel {
    Birthday: carbon.ToRssString{carbon.Now()},
}

// 重写MarshalJSON方法
func (c ToRssString) MarshalJSON() ([]byte, error) {
	return []byte(fmt.Sprintf(`"%s"`, c.ToRssString())), nil
}

// json.Marshal(&user)输出
{
    "birthday": "Wed, 05 Aug 2020 13:14:15 +0800",
}
附录
格式化符号表
符号 描述 类型 长度 范围 示例
Y 年份 数字 4 0000-9999 2020
y 年份 数字 2 00-99 20
M 月份 字母 3 Jan-Dec Aug
m 月份 数字 2 01-12 08
F 月份 字母 - January-December August
n 月份 数字 1/2 1-12 8
l 周几 字母 - Monday-Sunday Wednesday
D 周几 字母 3 Mon-Sun Wed
d 天数 数字 2 01-31 05
j 天数 数字 1/2 1-31 5
H 小时 数字 2 00-23 15
h 小时 数字 2 00-11 03
i 分钟 数字 2 01-59 14
s 秒钟 数字 2 01-59 15
P 上下午 字母 2 AM/PM PM
p 上下午 字母 2 am/pm pm
参考项目
更新日志
2020-01-18
  • 更新readme.md文档
  • 修复已知错误
  • 将const.go改名为constant.go
  • 新增ToGoTime()将carbon实例转为time.Time
2020-11-06
  • 弃用Duration()方法，拆分为AddDuration()和SubDuration()
  • 新增Compare()方法比较时间
  • 新增Gt()方法判断是否大于
  • 新增Lt()方法判断是否小于
  • 新增Eq()方法判断是否等于
  • 新增Ne()方法判断是否不等于
  • 新增Gte()方法判断是否大于等于
  • 新增Lte()方法判断是否小于等于
  • 新增Between()方法判断是否在两个时间之间(不包括这两个时间)
  • 新增BetweenIncludedStartTime()方法判断是否在两个时间之间(包括开始时间)
  • 新增BetweenIncludedEndTime()方法判断是否在两个时间之间(包括结束时间)
  • 新增BetweenIncludedBoth()方法判断是否在两个时间之间(包括这两个时间)
2020-11-02
  • 新增测试覆盖率报告文件coverage.html
  • CreateFromTimestamp()方法支持秒、毫秒、微秒、纳秒级时间戳
  • 新增ToTimestampWithSecond()方法获取秒级时间戳，等价于ToTimestamp()
  • 新增ToTimestampWithMillisecond()方法获取毫秒级时间戳
  • 新增ToTimestampWithMicrosecond()方法获取微秒级时间戳
  • 新增ToTimestampWithNanosecond()方法获取微秒级时间戳
2020-10-22
  • 新增SetYear()方法设置年
  • 新增SetMonth()方法设置月
  • 新增SetDay()方法设置日
  • 新增SetHour()方法设置时
  • 新增SetMinute()方法设置分
  • 新增SetSecond方法设置秒
  • 新增DiffInWeeks()方法计算相差多少周
  • 新增DiffInWeeksWithAbs()方法计算相差多少周(绝对值)
  • 新增DiffInDays()方法计算相差多少天
  • 新增DiffInDaysWithAbs()方法计算相差多少天(绝对值)
  • 新增DiffInHours()方法计算相差多少小时
  • 新增DiffInHoursWithAbs()方法计算相差多少小时(绝对值)
  • 新增DiffInMinutes()方法计算相差多少分钟
  • 新增DiffInMinutesWithAbs()方法计算相差多少分钟(绝对值)
  • 新增DiffInSeconds()方法计算相差多少秒
  • 新增DiffInSecondsWithAbs()方法计算相差多少秒(绝对值)
2020-10-16
  • 新增Timezone()方法获取时区名
  • 新增Age()方法获取年龄
  • 新增Year()方法获取当前年
  • 新增Month()方法获取当前月
  • 新增Day()方法获取当前日
  • 新增Hour()方法获取当前小时
  • 新增Minute()方法获取当前分钟数
  • 新增Second()方法获取当前秒数
2020-10-12
  • 完善单元测试，代码覆盖率100%
  • 统一异常处理
  • 新增英文版README.MD说明文档
  • 统一输出函数命名规则，将Format() 改为 ToFormatString()
  • 新增CreateFromGoTime(t time.Time)方法从原生time.Time创建Carbon实例
2020-10-08
  • 完善单元测试
  • 完善优化对ORM的多场景支持
  • 优化代码组织结构，将不可继承的最终方法统一放到final.go文件里
  • 废弃New()初始化函数，无需初始化即可直接使用
  • 新增多种时间格式输出，如Cookie、W3C、RSS、RFC7231
  • 新增ParseByDuration()方法解析持续时间字符串(相对于今天)，支持正负整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合
  • 新增NextYears()、NextYear()、PreYears()、PreYear()方法防止出现添加/减少指定年时出现跨月的现象
  • 新增NextMonths()、NextMonth()、PreMonths()、PreMonth()方法防止出现添加/减少指定月后出现跨月的现象
  • 新增DaysInYear()方法获取本年的总天数
  • 新增DaysInMonth()方法获取本月的总天数
  • 新增MonthOfYear()方法获取本年的第几月
  • 新增DayOfYear()方法获取本年的第几天
  • 新增DayOfMonth()方法获取本月的第几天
  • 新增DayOfWeek()方法获取本周的第几天
  • 新增WeekOfYear()方法获取本年的第几周
  • 新增WeekOfMonth()方法获取本月的第几周
  • 新增IsZero()方法判断是否是零值时间
  • 新增IsFuture()方法判断是否是未来时间
  • 新增IsPast()方法判断是否是过去时间
  • 新增IsNow()方法判断是否是当前时间
2020-10-01
  • 完善单元测试
  • 修复 AddHours() 传入参数小于1天时变成浮点数的BUG
  • 修复 AddHour() 浮点数BUG
  • 修复 SubHours() 传入参数小于1天时变成浮点数的BUG
  • 修复 SubHour() 浮点数BUG
  • 修复 AddMinutes() 传入参数小于1天时变成浮点数的BUG
  • 修复 AddMinute() 浮点数BUG
  • 修复 SubMinutes() 传入参数小于1天时变成浮点数的BUG
  • 修复 SubMinute() 浮点数BUG
  • 修复 AddSeconds() 传入参数小于1天时变成浮点数的BUG
  • 修复 AddSecond() 浮点数BUG
  • 修复 SubSeconds() 传入参数小于1天时变成浮点数的BUG
  • 修复 SubSecond() 浮点数BUG
  • 修复orm中时间字段类型设置为carbon.ToDateTimeString时报错的BUG
  • 改名解析自定义时间格式方法ParseByCustom() 为 ParseByFormat()
  • 新增 ParseByDuration() 方法将持续时间字符串转化成时间实例
  • 新增 ToAnimalYear() 方法获取生肖年
  • 新增 ToLunarYear() 方法获取农历年
  • 新增 IsYearOfRat() 方法判断是否是鼠年
  • 新增 IsYearOfOx() 方法判断是否是牛年
  • 新增 IsYearOfTiger() 方法判断是否是虎年
  • 新增 IsYearOfRabbit() 方法判断是否是兔年
  • 新增 IsYearOfDragon() 方法判断是否是龙年
  • 新增 IsYearOfSnake() 方法判断是否是蛇年
  • 新增 IsYearOfHorse() 方法判断是否是马年
  • 新增 IsYearOfGoat() 方法判断是否是羊年
  • 新增 IsYearOfMonkey() 方法判断是否是猴年
  • 新增 IsYearOfRooster() 方法判断是否是鸡年
  • 新增 IsYearOfDog() 方法判断是否是狗年
  • 新增 IsYearOfPig() 方法判断是否是猪年
2020-09-14
  • 完善单元测试
  • 时区常量移到const.go文件里
  • 新增StartOfYear()方法获取当年开始时间
  • 新增EndOfYear()方法获取当年结束时间
  • 新增StartOfMonth()方法获取当月开始时间
  • 新增EndOfMonth()方法获取当月结束时间
  • 新增StartOfDay()方法获取当天开始时间
  • 新增EndOfDay()方法获取当天结束时间
  • 新增StartOfYesterday()方法获取昨天开始时间
  • 新增EndOfYesterday()方法获取昨天结束时间
  • 新增StartOfToday()方法获取今天开始时间
  • 新增EndOfToday()方法获取今天结束时间
  • 新增StartOfTomorrow()方法获取明天开始时间
  • 新增EndOfTomorrow方法获取明天结束时间
  • 新增ToDateStartString方法转换成日期开始时间
  • 新增ToDateEndString方法转换成日期结束时间
  • 新增ToTimeStartString方法转换成小时开始时间
  • 新增ToTimeEndString方法转换成小时结束时间
2020-09-10
  • 优化代码组织结构，将私有方法统一放到private.go文件里
  • 新增IsToday方法判断是否是今天
  • 新增IsYesterday方法判断是否是昨天
  • 新增IsTomorrow方法判断是否是明天
  • 新增IsStartOfToday方法判断是否是今天开始时间
  • 新增IsEndOfToday方法判断是否是今天结束时间
  • 新增IsStartOfTomorrow方法判断是否是明天开始时间
  • 新增IsEndOfTomorrow方法判断是否是明天结束时间
  • 新增IsStartOfYesterday方法判断是否是昨天开始时间
  • 新增IsEndOfYesterday方法判断是否是昨天结束时间
2020-09-02
  • 修复数据库中时间类型字段值为null或0000-00-00 00:00:00时，json格式化后为0001-01-01 00:00:00的BUG
  • 完善单元测试
  • 优化代码组织结构，精简代码
  • 新增对xorm结构体的json输出时间格式化支持，支持输出多种标准时间格式
  • 新增AddWeeks(N)方法获取N周后时间
  • 新增AddWeek()方法获取1周后时间
  • 新增SubWeeks(N)方法获取N周前时间
  • 新增SubWeek()方法获取1周前时间
2020-08-21
  • 修复readme.md错误描述
  • 完善单元测试
  • 新增对gorm结构体的json输出时间格式化支持，支持输出多种标准时间格式
  • 新增IsJanuary()方法判断是否是一月
  • 新增IsFebruary()方法判断是否是二月
  • 新增IsMarch()方法判断是否是三月
  • 新增IsApril()方法判断是否是四月
  • 新增IsMay()方法判断是否是五月
  • 新增IsJune()方法判断是否是六月
  • 新增IsJuly()方法判断是否是七月
  • 新增IsAugust()方法判断是否是八月
  • 新增IsSeptember()方法判断是否是九月
  • 新增IsOctober()方法判断是否是十月
  • 新增IsNovember()方法判断是否是十一月
  • 新增IsDecember()方法判断是否是十二月
2020-08-05
  • 修复已知BUG
  • 添加单元测试
  • 新增FirstOfYear()方法获取年初第一天
  • 新增LastOfYear()方法获取年末最后一天
  • 新增FirstOfMonth()方法获取月初第一天
  • 新增LastOfMonth()方法获取月末最后一天
  • 新增IsFirstOfYaer()方法判断是否年初第一天
  • 新增IsLastOfYear()方法判断是否年末最后一天
  • 新增IsFirstOfMonth()方法判断是否月初第一天
  • 新增IsLastOfMonth()方法判断是否月末最后一天

Documentation

Index

Constants

View Source 
const (
	Version = "v1.2.5"
	Author  = "gouguoyin"
	Email   = "mail@gouguoyin.cn"
	Blog    = "www.gouguoyin.cn"
)

版权信息

View Source 
const (
	Local = "Local"
	CET   = "CET"
	EET   = "EET"
	EST   = "EST"
	GMT   = "GMT"
	UTC   = "UTC"
	UCT   = "UCT"
	MST   = "MST"

	Cuba      = "Cuba"
	Egypt     = "Egypt"
	Eire      = "Eire"
	Greenwich = "Greenwich"
	Iceland   = "Iceland"
	Iran      = "Iran"
	Israel    = "Israel"
	Jamaica   = "Jamaica"
	Japan     = "Japan"
	Libya     = "Libya"
	Poland    = "Poland"
	Portugal  = "Portugal"
	PRC       = "PRC"
	Singapore = "Singapore"
	Turkey    = "Turkey"
	Zulu      = "Zulu"

	Shanghai   = "Asia/Shanghai"
	Chongqing  = "Asia/Chongqing"
	HongKong   = "Asia/Hong_Kong"
	Macao      = "Asia/Macao"
	Taipei     = "Asia/Taipei"
	Tokyo      = "Asia/Tokyo"
	London     = "Europe/London"
	NewYork    = "America/New_York"
	LosAngeles = "America/Los_Angeles"
)

时区常量

View Source 
const (
	January   = "January"   // 一月
	February  = "February"  // 二月
	March     = "March"     // 三月
	April     = "April"     // 四月
	May       = "May"       // 五月
	June      = "June"      // 六月
	July      = "July"      // 七月
	August    = "August"    // 八月
	September = "September" // 九月
	October   = "October"   // 十月
	November  = "November"  // 十一月
	December  = "December"  // 十二月
)

月份常量

View Source 
const (
	Monday    = "Monday"    // 周一
	Tuesday   = "Tuesday"   // 周二
	Wednesday = "Wednesday" // 周三
	Thursday  = "Thursday"  // 周四
	Friday    = "Friday"    // 周五
	Saturday  = "Saturday"  // 周六
	Sunday    = "Sunday"    // 周日
)

星期常量

View Source 
const (
	YearsPerMillennium = 1000 // 每千年1000年
	YearsPerCentury    = 100  // 每世纪100年
	YearsPerDecade     = 10   // 每十年10年
	QuartersPerYear    = 4    // 每年4季度
	MonthsPerYear      = 12   // 每年12月
	MonthsPerQuarter   = 3    // 每季度3月
	WeeksPerNormalYear = 52   // 每常规年52周

	WeeksPerMonth              = 4       // 每月4周
	DaysPerLeapYear            = 366     // 每闰年366天
	DaysPerNormalYear          = 365     // 每常规年365天
	DaysPerWeek                = 7       // 每周7天
	HoursPerWeek               = 168     // 每周168小时
	HoursPerDay                = 24      // 每天24小时
	MinutesPerDay              = 1440    // 每天1440分钟
	MinutesPerHour             = 60      // 每小时60分钟
	SecondsPerWeek             = 604800  // 每周604800秒
	SecondsPerDay              = 86400   // 每天86400秒
	SecondsPerHour             = 3600    // 每小时3600秒
	SecondsPerMinute           = 60      // 每分钟60秒
	MillisecondsPerSecond      = 1000    // 每秒1000毫秒
	MicrosecondsPerMillisecond = 1000    // 每毫秒1000微秒
	MicrosecondsPerSecond      = 1000000 // 每秒1000000微秒
)

数字常量

View Source 
const (
	AnsicFormat         = time.ANSIC
	UnixDateFormat      = time.UnixDate
	RubyDateFormat      = time.RubyDate
	RFC822Format        = time.RFC822
	RFC822ZFormat       = time.RFC822Z
	RFC850Format        = time.RFC850
	RFC1123Format       = time.RFC1123
	RFC1123ZFormat      = time.RFC1123Z
	RssFormat           = time.RFC1123Z
	RFC2822Format       = time.RFC1123Z
	RFC3339Format       = time.RFC3339
	KitchenFormat       = time.Kitchen
	CookieFormat        = "Monday, 02-Jan-2006 15:04:05 MST"
	RFC1036Format       = "Mon, 02 Jan 06 15:04:05 -0700"
	RFC7231Format       = "Mon, 02 Jan 2006 15:04:05 GMT"
	DayDateTimeFormat   = "Mon, Aug 2, 2006 3:04 PM"
	DateTimeFormat      = "2006-01-02 15:04:05"
	DateFormat          = "2006-01-02"
	TimeFormat          = "15:04:05"
	ShortDateTimeFormat = "20060102150405"
	ShortDateFormat     = "20060102"
	ShortTimeFormat     = "150405"
)

时间格式化常量

Variables

View Source 
var (
	// 十二生肖
	SymbolicAnimals = [12]string{"猴", "鸡", "狗", "猪", "鼠", "牛", "虎", "兔", "龙", "蛇", "马", "羊"}

	// 天干
	HeavenlyStems = [10]string{"庚", "辛", "壬", "癸", "甲", "乙", "丙", "丙", "戊", "己"}

	// 地支
	EarthlyBranches = [12]string{"申", "酉", "戌", "亥", "子", "丑", "寅", "卯", "辰", "巳", "午", "未"}
)

Functions

This section is empty.

Types

type Carbon 

type Carbon struct {
	Time time.Time
	// contains filtered or unexported fields
}

func CreateFromDate added in v1.2.0 

func CreateFromDate(year int, month int, day int) Carbon

CreateFromDate 从年月日创建Carbon实例

func CreateFromDateTime added in v1.2.0 

func CreateFromDateTime(year int, month int, day int, hour int, minute int, second int) Carbon

CreateFromDateTime 从年月日时分秒创建Carbon实例

func CreateFromGoTime added in v1.2.1 

func CreateFromGoTime(t time.Time) Carbon

CreateFromGoTime 从原生time.Time创建Carbon实例

func CreateFromTime added in v1.2.0 

func CreateFromTime(hour int, minute int, second int) Carbon

CreateFromTime 从时分秒创建Carbon实例

func CreateFromTimestamp added in v1.2.0 

func CreateFromTimestamp(timestamp int64) Carbon

CreateFromTimestamp 从时间戳创建Carbon实例

func Now added in v1.2.0 

func Now() Carbon

Now 当前

func Parse added in v1.2.0 

func Parse(value string) Carbon

Parse 解析标准格式时间字符串

func ParseByDuration added in v1.2.0 

func ParseByDuration(duration string) Carbon

ParseByDuration 解析持续时间字符串(基于现在时间) 支持正负整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合

func ParseByFormat added in v1.2.0 

func ParseByFormat(value string, format string) Carbon

ParseByFormat 解析指定格式时间字符串

func SetTimezone added in v1.2.2 

func SetTimezone(name string) Carbon

Timezone 设置时区

func Tomorrow added in v1.2.0 

func Tomorrow() Carbon

Tomorrow 明天

func Yesterday added in v1.2.0 

func Yesterday() Carbon

Yesterday 昨天

func (Carbon) AddDay 

func (c Carbon) AddDay() Carbon

AddDay 1天后

func (Carbon) AddDays 

func (c Carbon) AddDays(days int) Carbon

AddDays N天后

func (Carbon) AddDuration added in v1.2.4 

func (c Carbon) AddDuration(duration string) Carbon

AddDurations 按照持续时间字符串增加时间 支持整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合

func (Carbon) AddHour 

func (c Carbon) AddHour() Carbon

AddHour 1小时后

func (Carbon) AddHours 

func (c Carbon) AddHours(hours int) Carbon

AddHours N小时后

func (Carbon) AddMinute 

func (c Carbon) AddMinute() Carbon

AddMinute 1分钟后

func (Carbon) AddMinutes 

func (c Carbon) AddMinutes(minutes int) Carbon

AddMinutes N分钟后

func (Carbon) AddMonth 

func (c Carbon) AddMonth() Carbon

AddMonth 1月后

func (Carbon) AddMonths 

func (c Carbon) AddMonths(months int) Carbon

AddMonths N月后

func (Carbon) AddQuarter added in v1.2.3 

func (c Carbon) AddQuarter() Carbon

AddMonth 1季度后

func (Carbon) AddQuarters added in v1.2.3 

func (c Carbon) AddQuarters(quarters int) Carbon

AddMonths N季度后

func (Carbon) AddSecond 

func (c Carbon) AddSecond() Carbon

AddSecond 1秒钟后

func (Carbon) AddSeconds 

func (c Carbon) AddSeconds(seconds int) Carbon

AddSeconds N秒钟后

func (Carbon) AddWeek 

func (c Carbon) AddWeek() Carbon

AddWeek 1天后

func (Carbon) AddWeeks 

func (c Carbon) AddWeeks(weeks int) Carbon

AddWeeks N周后

func (Carbon) AddYear 

func (c Carbon) AddYear() Carbon

AddYear 1年后

func (Carbon) AddYears 

func (c Carbon) AddYears(years int) Carbon

AddYears N年后

func (Carbon) Age added in v1.2.1 

func (c Carbon) Age() int

Age 获取年龄

func (Carbon) Between added in v1.2.4 

func (c Carbon) Between(start Carbon, end Carbon) bool

Between 是否在两个时间之间(不包括这两个时间)

func (Carbon) BetweenIncludedBoth added in v1.2.4 

func (c Carbon) BetweenIncludedBoth(start Carbon, end Carbon) bool

BetweenIncludedBoth 是否在两个时间之间(包括这两个时间)

func (Carbon) BetweenIncludedEndTime added in v1.2.4 

func (c Carbon) BetweenIncludedEndTime(start Carbon, end Carbon) bool

BetweenIncludedEndTime 是否在两个时间之间(包括结束时间)

func (Carbon) BetweenIncludedStartTime added in v1.2.4 

func (c Carbon) BetweenIncludedStartTime(start Carbon, end Carbon) bool

BetweenIncludedStartTime 是否在两个时间之间(包括开始时间)

func (Carbon) Compare added in v1.2.4 

func (c Carbon) Compare(operator string, t Carbon) bool

Compare 时间比较

func (Carbon) CreateFromDate 

func (c Carbon) CreateFromDate(year int, month int, day int) Carbon

CreateFromDate 从年月日创建Carbon实例(指定时区)

func (Carbon) CreateFromDateTime 

func (c Carbon) CreateFromDateTime(year int, month int, day int, hour int, minute int, second int) Carbon

CreateFromDateTime 从年月日时分秒创建Carbon实例(指定时区)

func (Carbon) CreateFromGoTime added in v1.2.1 

func (c Carbon) CreateFromGoTime(t time.Time) Carbon

CreateFromGoTime 从原生time.Time创建Carbon实例(指定时区)

func (Carbon) CreateFromTime 

func (c Carbon) CreateFromTime(hour int, minute int, second int) Carbon

CreateFromTime 从时分秒创建Carbon实例(指定时区)

func (Carbon) CreateFromTimestamp 

func (c Carbon) CreateFromTimestamp(timestamp int64) Carbon

CreateFromTimestamp 从时间戳创建Carbon实例(指定时区)

func (Carbon) Day added in v1.2.1 

func (c Carbon) Day() int

获取当前日

func (Carbon) DayOfMonth added in v1.2.0 

func (c Carbon) DayOfMonth() int

DayOfMonth 获取本月的第几天

func (Carbon) DayOfWeek added in v1.2.0 

func (c Carbon) DayOfWeek() int

DayOfWeek 获取本周的第几天

func (Carbon) DayOfYear added in v1.2.0 

func (c Carbon) DayOfYear() int

DayOfYear 获取本年的第几天

func (Carbon) DaysInMonth added in v1.2.0 

func (c Carbon) DaysInMonth() int

DaysInMonth 获取本月的总天数

func (Carbon) DaysInYear added in v1.2.0 

func (c Carbon) DaysInYear() int

DaysInYear 获取本年的总天数

func (Carbon) DiffInDays added in v1.2.2 

func (start Carbon) DiffInDays(end Carbon) int64

DiffInDays 相差多少天

func (Carbon) DiffInDaysWithAbs added in v1.2.4 

func (start Carbon) DiffInDaysWithAbs(end Carbon) int64

DiffInDaysWithAbs 相差多少天（绝对值）

func (Carbon) DiffInHours added in v1.2.2 

func (start Carbon) DiffInHours(end Carbon) int64

DiffInHours 相差多少小时

func (Carbon) DiffInHoursWithAbs added in v1.2.4 

func (start Carbon) DiffInHoursWithAbs(end Carbon) int64

DiffInHoursWithAbs 相差多少小时（绝对值）

func (Carbon) DiffInMinutes added in v1.2.2 

func (start Carbon) DiffInMinutes(end Carbon) int64

DiffInMinutes 相差多少分钟

func (Carbon) DiffInMinutesWithAbs added in v1.2.4 

func (start Carbon) DiffInMinutesWithAbs(end Carbon) int64

DiffInMinutesWithAbs 相差多少分钟（绝对值）

func (Carbon) DiffInSeconds added in v1.2.2 

func (start Carbon) DiffInSeconds(end Carbon) int64

DiffInSeconds 相差多少秒

func (Carbon) DiffInSecondsWithAbs added in v1.2.4 

func (start Carbon) DiffInSecondsWithAbs(end Carbon) int64

DiffInSecondsWithAbs 相差多少秒（绝对值）

func (Carbon) DiffInWeeks added in v1.2.2 

func (start Carbon) DiffInWeeks(end Carbon) int64

DiffInWeeks 相差多少周

func (Carbon) DiffInWeeksWithAbs added in v1.2.4 

func (start Carbon) DiffInWeeksWithAbs(end Carbon) int64

DiffInWeeksWithAbs 相差多少周（绝对值）

func (Carbon) EndOfDay 

func (c Carbon) EndOfDay() Carbon

EndOfDay 本日结束时间

func (Carbon) EndOfHour added in v1.2.1 

func (c Carbon) EndOfHour() Carbon

EndOfHour 小时结束时间

func (Carbon) EndOfMinute added in v1.2.1 

func (c Carbon) EndOfMinute() Carbon

EndOfMinute 分钟结束时间

func (Carbon) EndOfMonth 

func (c Carbon) EndOfMonth() Carbon

EndOfMonth 本月结束时间

func (Carbon) EndOfWeek added in v1.2.1 

func (c Carbon) EndOfWeek() Carbon

EndOfWeek 本周结束时间

func (Carbon) EndOfYear 

func (c Carbon) EndOfYear() Carbon

EndOfYear 本年结束时间

func (Carbon) Eq added in v1.2.4 

func (c Carbon) Eq(t Carbon) bool

Eq 等于

func (Carbon) Format 

func (c Carbon) Format(format string) string

Format ToFormatString的简称

func (Carbon) Gt added in v1.2.4 

func (c Carbon) Gt(t Carbon) bool

Gt 大于

func (Carbon) Gte added in v1.2.4 

func (c Carbon) Gte(t Carbon) bool

Gte 大于等于

func (Carbon) Hour added in v1.2.1 

func (c Carbon) Hour() int

获取当前小时

func (Carbon) IsApril 

func (c Carbon) IsApril() bool

IsApril 是否是四月

func (Carbon) IsAugust 

func (c Carbon) IsAugust() bool

IsAugust 是否是八月

func (Carbon) IsDecember 

func (c Carbon) IsDecember() bool

IsDecember 是否是十二月

func (Carbon) IsFebruary 

func (c Carbon) IsFebruary() bool

IsMonday 是否是二月

func (Carbon) IsFriday 

func (c Carbon) IsFriday() bool

IsFriday 是否是周五

func (Carbon) IsFuture added in v1.2.0 

func (c Carbon) IsFuture() bool

IsFuture 是否是未来时间

func (Carbon) IsJanuary 

func (c Carbon) IsJanuary() bool

IsJanuary 是否是一月

func (Carbon) IsJuly 

func (c Carbon) IsJuly() bool

IsJuly 是否是七月

func (Carbon) IsJune 

func (c Carbon) IsJune() bool

IsJune 是否是六月

func (Carbon) IsLeapYear 

func (c Carbon) IsLeapYear() bool

IsLeapYear 是否是闰年

func (Carbon) IsLongYear added in v1.2.2 

func (c Carbon) IsLongYear() bool

IsLongYear 是否是长年

func (Carbon) IsMarch 

func (c Carbon) IsMarch() bool

IsMarch 是否是三月

func (Carbon) IsMay 

func (c Carbon) IsMay() bool

IsMay 是否是五月

func (Carbon) IsMonday 

func (c Carbon) IsMonday() bool

IsMonday 是否是周一

func (Carbon) IsNovember 

func (c Carbon) IsNovember() bool

IsNovember 是否是十一月

func (Carbon) IsNow added in v1.2.1 

func (c Carbon) IsNow() bool

IsNow 是否是当前时间

func (Carbon) IsOctober 

func (c Carbon) IsOctober() bool

IsOctober 是否是十月

func (Carbon) IsPast added in v1.2.0 

func (c Carbon) IsPast() bool

IsPast 是否是过去时间

func (Carbon) IsSaturday 

func (c Carbon) IsSaturday() bool

IsSaturday 是否是周六

func (Carbon) IsSeptember 

func (c Carbon) IsSeptember() bool

IsSeptember 是否是九月

func (Carbon) IsSunday 

func (c Carbon) IsSunday() bool

IsSunday 是否是周日

func (Carbon) IsThursday 

func (c Carbon) IsThursday() bool

IsThursday 是否是周四

func (Carbon) IsToday 

func (c Carbon) IsToday() bool

IsToday 是否是今天

func (Carbon) IsTomorrow 

func (c Carbon) IsTomorrow() bool

IsTomorrow 是否是明天

func (Carbon) IsTuesday 

func (c Carbon) IsTuesday() bool

IsTuesday 是否是周二

func (Carbon) IsWednesday 

func (c Carbon) IsWednesday() bool

IsWednesday 是否是周三

func (Carbon) IsWeekday added in v1.2.0 

func (c Carbon) IsWeekday() bool

IsWeekday 是否是工作日

func (Carbon) IsWeekend added in v1.2.0 

func (c Carbon) IsWeekend() bool

IsWeekend 是否是周末

func (Carbon) IsYearOfDog 

func (c Carbon) IsYearOfDog() bool

IsYearOfDog 是否是狗年

func (Carbon) IsYearOfDragon 

func (c Carbon) IsYearOfDragon() bool

IsYearOfDragon 是否是龙年

func (Carbon) IsYearOfGoat 

func (c Carbon) IsYearOfGoat() bool

IsYearOfGoat 是否是羊年

func (Carbon) IsYearOfHorse 

func (c Carbon) IsYearOfHorse() bool

IsYearOfHorse 是否是马年

func (Carbon) IsYearOfMonkey 

func (c Carbon) IsYearOfMonkey() bool

IsYearOfMonkey 是否是猴年

func (Carbon) IsYearOfOx 

func (c Carbon) IsYearOfOx() bool

IsYearOfOx 是否是牛年

func (Carbon) IsYearOfPig 

func (c Carbon) IsYearOfPig() bool

IsYearOfPig 是否是猪年

func (Carbon) IsYearOfRabbit 

func (c Carbon) IsYearOfRabbit() bool

IsYearOfRabbit 是否是兔年

func (Carbon) IsYearOfRat 

func (c Carbon) IsYearOfRat() bool

IsYearOfRat 是否是鼠年

func (Carbon) IsYearOfRooster 

func (c Carbon) IsYearOfRooster() bool

IsYearOfRooster 是否是鸡年

func (Carbon) IsYearOfSnake 

func (c Carbon) IsYearOfSnake() bool

IsYearOfSnake 是否是蛇年

func (Carbon) IsYearOfTiger 

func (c Carbon) IsYearOfTiger() bool

IsYearOfTiger 是否是虎年

func (Carbon) IsYesterday 

func (c Carbon) IsYesterday() bool

IsYesterday 是否是昨天

func (Carbon) IsZero added in v1.2.0 

func (c Carbon) IsZero() bool

IsZero 是否是零值

func (Carbon) Lt added in v1.2.4 

func (c Carbon) Lt(t Carbon) bool

Lt 小于

func (Carbon) Lte added in v1.2.4 

func (c Carbon) Lte(t Carbon) bool

Lte 小于等于

func (Carbon) Microsecond added in v1.2.3 

func (c Carbon) Microsecond() int

获取当前微秒数

func (Carbon) Millisecond added in v1.2.3 

func (c Carbon) Millisecond() int

获取当前毫秒数

func (Carbon) Minute added in v1.2.1 

func (c Carbon) Minute() int

获取当前分钟数

func (Carbon) Month added in v1.2.1 

func (c Carbon) Month() int

获取当前月

func (Carbon) MonthOfYear added in v1.2.0 

func (c Carbon) MonthOfYear() int

MonthOfYear 获取本年的第几月

func (Carbon) Nanosecond added in v1.2.3 

func (c Carbon) Nanosecond() int

获取当前纳秒数

func (Carbon) Ne added in v1.2.4 

func (c Carbon) Ne(t Carbon) bool

Ne 不等于

func (Carbon) NextMonth added in v1.2.0 

func (c Carbon) NextMonth() Carbon

NextMonth 1月后

func (Carbon) NextMonths added in v1.2.0 

func (c Carbon) NextMonths(months int) Carbon

NextMonths N月后

func (Carbon) NextQuarter added in v1.2.3 

func (c Carbon) NextQuarter() Carbon

NextQuarters 1季度后

func (Carbon) NextQuarters added in v1.2.3 

func (c Carbon) NextQuarters(quarters int) Carbon

NextQuarters N季度后

func (Carbon) NextYear added in v1.2.0 

func (c Carbon) NextYear() Carbon

NextYear 1年后

func (Carbon) NextYears added in v1.2.0 

func (c Carbon) NextYears(years int) Carbon

NextYears N年后

func (Carbon) Now 

func (c Carbon) Now() Carbon

Now 当前(指定时区)

func (Carbon) Parse 

func (c Carbon) Parse(value string) Carbon

Parse 解析标准格式时间字符串(指定时区)

func (Carbon) ParseByDuration 

func (c Carbon) ParseByDuration(duration string) Carbon

ParseByDuration 解析持续时间字符串(指定时区)

func (Carbon) ParseByFormat 

func (c Carbon) ParseByFormat(value string, format string) Carbon

ParseByFormat 解析指定格式时间字符串(指定时区)

func (Carbon) PreMonth added in v1.2.0 

func (c Carbon) PreMonth() Carbon

PreMonth 1月前

func (Carbon) PreMonths added in v1.2.0 

func (c Carbon) PreMonths(months int) Carbon

PreMonths N月前

func (Carbon) PreQuarter added in v1.2.3 

func (c Carbon) PreQuarter() Carbon

PreQuarter 1季度前

func (Carbon) PreQuarters added in v1.2.3 

func (c Carbon) PreQuarters(quarters int) Carbon

PreQuarters N季度前

func (Carbon) PreYear added in v1.2.0 

func (c Carbon) PreYear() Carbon

PreYear 1年前

func (Carbon) PreYears added in v1.2.0 

func (c Carbon) PreYears(years int) Carbon

PreYears N年前

func (Carbon) Quarter added in v1.2.3 

func (c Carbon) Quarter() int

获取当前季度

func (*Carbon) Scan 

func (c *Carbon) Scan(v interface{}) error

func (Carbon) Second added in v1.2.1 

func (c Carbon) Second() int

获取当前秒数

func (Carbon) SetDay added in v1.2.2 

func (c Carbon) SetDay(day int) Carbon

SetDay 设置日

func (Carbon) SetHour added in v1.2.2 

func (c Carbon) SetHour(hour int) Carbon

SetHour 设置时

func (Carbon) SetMinute added in v1.2.2 

func (c Carbon) SetMinute(minute int) Carbon

SetMinute 设置分

func (Carbon) SetMonth added in v1.2.2 

func (c Carbon) SetMonth(month int) Carbon

SetMonth 设置月

func (Carbon) SetSecond added in v1.2.2 

func (c Carbon) SetSecond(second int) Carbon

SetSecond 设置秒

func (Carbon) SetTimezone added in v1.2.2 

func (c Carbon) SetTimezone(name string) Carbon

Timezone 设置时区

func (Carbon) SetYear added in v1.2.2 

func (c Carbon) SetYear(year int) Carbon

SetYear 设置年

func (Carbon) StartOfDay 

func (c Carbon) StartOfDay() Carbon

StartOfDay 本日开始时间

func (Carbon) StartOfHour added in v1.2.2 

func (c Carbon) StartOfHour() Carbon

StartOfHour 小时开始时间

func (Carbon) StartOfMinute added in v1.2.2 

func (c Carbon) StartOfMinute() Carbon

StartOfMinute 分钟开始时间

func (Carbon) StartOfMonth 

func (c Carbon) StartOfMonth() Carbon

StartOfMonth 本月开始时间

func (Carbon) StartOfWeek added in v1.2.2 

func (c Carbon) StartOfWeek() Carbon

StartOfWeek 本周开始时间

func (Carbon) StartOfYear 

func (c Carbon) StartOfYear() Carbon

StartOfYear 本年开始时间

func (Carbon) SubDay 

func (c Carbon) SubDay() Carbon

SubDay 1天前

func (Carbon) SubDays 

func (c Carbon) SubDays(days int) Carbon

SubDays N天前

func (Carbon) SubDuration added in v1.2.4 

func (c Carbon) SubDuration(duration string) Carbon

SubDurations 按照持续时间字符串减少时间 支持整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合

func (Carbon) SubHour 

func (c Carbon) SubHour() Carbon

SubHour 1小时前

func (Carbon) SubHours 

func (c Carbon) SubHours(hours int) Carbon

SubHours N小时前

func (Carbon) SubMinute 

func (c Carbon) SubMinute() Carbon

SubMinute 1分钟前

func (Carbon) SubMinutes 

func (c Carbon) SubMinutes(minutes int) Carbon

SubMinutes N分钟前

func (Carbon) SubMonth 

func (c Carbon) SubMonth() Carbon

SubMonth 1月前

func (Carbon) SubMonths 

func (c Carbon) SubMonths(months int) Carbon

SubMonths N月前

func (Carbon) SubQuarter added in v1.2.3 

func (c Carbon) SubQuarter() Carbon

SubMonth 1季度前

func (Carbon) SubQuarters added in v1.2.3 

func (c Carbon) SubQuarters(quarters int) Carbon

SubMonths N季度前

func (Carbon) SubSecond 

func (c Carbon) SubSecond() Carbon

SubSecond 1秒钟前

func (Carbon) SubSeconds 

func (c Carbon) SubSeconds(seconds int) Carbon

SubSeconds N秒钟前

func (Carbon) SubWeek 

func (c Carbon) SubWeek() Carbon

SubWeek 1天后

func (Carbon) SubWeeks 

func (c Carbon) SubWeeks(weeks int) Carbon

SubWeeks N周后

func (Carbon) SubYear 

func (c Carbon) SubYear() Carbon

SubYear 1年前

func (Carbon) SubYears 

func (c Carbon) SubYears(years int) Carbon

SubYears N年前

func (Carbon) Timezone 

func (c Carbon) Timezone() string

Timezone 获取时区

func (Carbon) ToAnimalYear 

func (c Carbon) ToAnimalYear() string

ToAnimalYear 获取生肖年

func (Carbon) ToAnsicString added in v1.2.0 

func (c Carbon) ToAnsicString() string

ToAnsicString 输出ANSIC格式字符串

func (Carbon) ToAtomString added in v1.2.0 

func (c Carbon) ToAtomString() string

ToAtomString 输出Atom格式字符串

func (Carbon) ToCookieString added in v1.2.0 

func (c Carbon) ToCookieString() string

ToCookieString 输出Cookie格式字符串

func (Carbon) ToDateString 

func (c Carbon) ToDateString() string

ToDateString 输出日期字符串

func (Carbon) ToDateTimeString 

func (c Carbon) ToDateTimeString() string

ToDateTimeString 输出日期时间字符串

func (Carbon) ToDayDateTimeString added in v1.2.0 

func (c Carbon) ToDayDateTimeString() string

ToDayDateTimeString 输出天数日期时间字符串

func (Carbon) ToFormatString added in v1.2.0 

func (c Carbon) ToFormatString(format string) string

ToFormatString 输出指定格式时间

func (Carbon) ToGoTime added in v1.2.5 

func (c Carbon) ToGoTime() time.Time

ToGoTime 输出carbon实例

func (Carbon) ToKitchenString added in v1.2.0 

func (c Carbon) ToKitchenString() string

ToKitchenString 输出Kitchen格式字符串

func (Carbon) ToLunarYear 

func (c Carbon) ToLunarYear() string

ToLunarYear 获取农历年

func (Carbon) ToRFC1036String added in v1.2.0 

func (c Carbon) ToRFC1036String() string

ToRfc1036String 输出RFC1036格式字符串

func (Carbon) ToRFC1123String added in v1.2.0 

func (c Carbon) ToRFC1123String() string

ToRfc1123String 输出RFC1123格式字符串

func (Carbon) ToRFC1123ZString added in v1.2.0 

func (c Carbon) ToRFC1123ZString() string

ToRFC1123ZString 输出RFC1123Z格式字符串

func (Carbon) ToRFC2822String added in v1.2.0 

func (c Carbon) ToRFC2822String() string

ToRFC2822String 输出RFC2822格式字符串

func (Carbon) ToRFC3339String added in v1.2.0 

func (c Carbon) ToRFC3339String() string

ToRfc3339String 输出RFC3339格式字符串

func (Carbon) ToRFC7231String added in v1.2.0 

func (c Carbon) ToRFC7231String() string

ToRfc7231String 输出RFC7231格式字符串

func (Carbon) ToRFC822String added in v1.2.0 

func (c Carbon) ToRFC822String() string

ToRfc822String 输出RFC822格式字符串

func (Carbon) ToRFC822zString added in v1.2.0 

func (c Carbon) ToRFC822zString() string

ToRfc822String 输出RFC822Z格式字符串

func (Carbon) ToRFC850String added in v1.2.0 

func (c Carbon) ToRFC850String() string

ToRfc850String 输出RFC850格式字符串

func (Carbon) ToRssString added in v1.2.0 

func (c Carbon) ToRssString() string

ToRssString 输出RSS格式字符串

func (Carbon) ToRubyDateString added in v1.2.0 

func (c Carbon) ToRubyDateString() string

ToUnixDateString 输出RubyDate格式字符串

func (Carbon) ToString added in v1.2.0 

func (c Carbon) ToString() string

ToString 输出字符串

func (Carbon) ToTimeString 

func (c Carbon) ToTimeString() string

ToTimeString 输出时间字符串

func (Carbon) ToTimestamp 

func (c Carbon) ToTimestamp() int64

ToTimestamp ToTimestampWithSecond的简称

func (Carbon) ToTimestampWithMicrosecond added in v1.2.3 

func (c Carbon) ToTimestampWithMicrosecond() int64

ToTimestampWithMicrosecond 输出微秒级时间戳

func (Carbon) ToTimestampWithMillisecond added in v1.2.3 

func (c Carbon) ToTimestampWithMillisecond() int64

ToTimestampWithMillisecond 输出毫秒级时间戳

func (Carbon) ToTimestampWithNanosecond added in v1.2.3 

func (c Carbon) ToTimestampWithNanosecond() int64

ToTimestampWithNanosecond 输出纳秒级时间戳

func (Carbon) ToTimestampWithSecond added in v1.2.3 

func (c Carbon) ToTimestampWithSecond() int64

ToTimestampWithSecond 输出秒级时间戳

func (Carbon) ToUnixDateString added in v1.2.0 

func (c Carbon) ToUnixDateString() string

ToUnixDateString 输出UnixDate格式字符串

func (Carbon) ToW3cString added in v1.2.0 

func (c Carbon) ToW3cString() string

ToW3cString 输出W3C格式字符串

func (Carbon) Tomorrow 

func (c Carbon) Tomorrow() Carbon

Tomorrow 明天(指定时区)

func (Carbon) Value 

func (c Carbon) Value() (driver.Value, error)

func (Carbon) WeekOfMonth added in v1.2.0 

func (c Carbon) WeekOfMonth() int

WeekOfMonth 获取本月的第几周

func (Carbon) WeekOfYear added in v1.2.0 

func (c Carbon) WeekOfYear() int

WeekOfYear 获取本年的第几周

func (Carbon) Year added in v1.2.1 

func (c Carbon) Year() int

获取当前年

func (Carbon) Yesterday 

func (c Carbon) Yesterday() Carbon

Yesterday 昨天(指定时区)

type ToDateString 

type ToDateString struct {
	Carbon
}

func (ToDateString) MarshalJSON 

func (c ToDateString) MarshalJSON() ([]byte, error)

type ToDateTimeString 

type ToDateTimeString struct {
	Carbon
}

func (ToDateTimeString) MarshalJSON 

func (c ToDateTimeString) MarshalJSON() ([]byte, error)

type ToTimeString 

type ToTimeString struct {
	Carbon
}

func (ToTimeString) MarshalJSON 

func (c ToTimeString) MarshalJSON() ([]byte, error)

type ToTimestamp 

type ToTimestamp struct {
	Carbon
}

func (ToTimestamp) MarshalJSON 

func (c ToTimestamp) MarshalJSON() ([]byte, error)

type ToTimestampWithMicrosecond added in v1.2.4 

type ToTimestampWithMicrosecond struct {
	Carbon
}

func (ToTimestampWithMicrosecond) MarshalJSON added in v1.2.4 

func (c ToTimestampWithMicrosecond) MarshalJSON() ([]byte, error)

type ToTimestampWithMillisecond added in v1.2.4 

type ToTimestampWithMillisecond struct {
	Carbon
}

func (ToTimestampWithMillisecond) MarshalJSON added in v1.2.4 

func (c ToTimestampWithMillisecond) MarshalJSON() ([]byte, error)

type ToTimestampWithNanosecond added in v1.2.4 

type ToTimestampWithNanosecond struct {
	Carbon
}

func (ToTimestampWithNanosecond) MarshalJSON added in v1.2.4 

func (c ToTimestampWithNanosecond) MarshalJSON() ([]byte, error)

type ToTimestampWithSecond added in v1.2.4 

type ToTimestampWithSecond struct {
	Carbon
}

func (ToTimestampWithSecond) MarshalJSON added in v1.2.4 

func (c ToTimestampWithSecond) MarshalJSON() ([]byte, error)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.