carbon

package module

v1.2.3 Latest Latest Go to latest Published: Nov 1, 2020 License: MIT Imports: 4 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/admpub/carbon

Links

Open Source Insights

README ¶

Carbon

中文 | 英文

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.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.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实例

// 从时间戳创建Carbon实例
carbon.CreateFromTimestamp(1596604455).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.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-30").SetMonth(2).ToDateString() // 2020-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("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-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").Duration("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").Duration("-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").Duration("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").Duration("-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").Duration("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").Duration("-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").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.Parse("2020-08-05 13:14:15").ToTimestamp() // 1596604455

// 输出字符串
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").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("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").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

时间判断

// 是否是零值时间
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(carbon.Now().ToDateTimeString()).IsNow() // true
// 是否是未来时间
carbon.Parse("2020-08-06 13:14:15").IsFuture() // true
// 是否是过去时间
carbon.Parse("2020-08-04 13:14:15").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").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)、graduated_at(date)、birthday(date)、created_at(datetime)、updated_at(datetime)、deleted_at(datetime)

定义模型

type UserModel struct {
    ID  int64  `json:"id"`
    Name string `json:"name"`
    Age int `json:"age"`
    Birthday carbon.Carbon `json:"birthday"`
    CreatedAt carbon.ToDateTimeString `json:"created_at"`
    DeletedAt carbon.ToTimestamp `json:"deleted_at"`
    GraduatedAt carbon.ToDateString `json:"graduated_at"`
    UpdatedAt carbon.ToTimeString `json:"updated_at"`
}

实例化模型

user := UserModel {
    Name: "勾国印",
    Age: 18,
    Birthday: carbon.Now().SubYears(18),
    CreatedAt: carbon.ToDateTimeString{carbon.Now()},
    DeletedAt: carbon.ToTimestamp{carbon.Parse("2020-08-05 13:14:15")},
    GraduatedAt: carbon.ToDateString{carbon.Parse("2012-09-09")},
    UpdatedAt: carbon.ToTimeString{carbon.Now()},
}

输出模型字段

user.ID // 18
user.Name // 勾国印
user.Birthday.ToDateString() // 2012-08-05
user.CreatedAt.ToTimestamp() // 2012-08-05 13:14:15
user.DeletedAt.ToDateTimeString() // 1596604455
user.GraduatedAt.AddDay().ToDateString() // 2012-09-10
user.UpdatedAt.ToDateString() // 2012-08-05

JSON输出模型

data, _ := json.Marshal(&user)
fmt.Print(string(data))
// 输出
{
    "id": 42,
    "name": "勾国印",
    "age": 18,
    "birthday": "2012-08-05 00:00:00",
    "created_at": "2020-08-05 13:14:15",
    "deleted_at": 1596604455
    "graduated_at": "2012-09-09",
    "updated_at": "13:14:15",
}

输出自定义格式

// 定义输出格式
type ToRssString struct {
    carbon.Carbon
}

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

// 实例化模型
user := UserModel {
    Birthday: Birthday: 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-10-22

新增SetYear()方法设置年
新增SetMonth()方法设置月
新增SetDay()方法设置日
新增SetHour()方法设置时
新增SetMinute()方法设置分
新增SetSecond方法设置秒
新增DiffInWeeks()方法计算相差多少周
新增DiffAbsInWeeks()方法计算相差多少周(绝对值)
新增DiffInDays()方法计算相差多少天
新增DiffAbsInDays()方法计算相差多少天(绝对值)
新增DiffInHours()方法计算相差多少小时
新增DiffAbsInHours()方法计算相差多少小时(绝对值)
新增DiffInMinutes()方法计算相差多少分钟
新增DiffAbsInMinutes()方法计算相差多少分钟(绝对值)
新增DiffInSeconds()方法计算相差多少秒
新增DiffAbsInSeconds()方法计算相差多少秒(绝对值)

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
Variables
type Carbon
type ToDateString
- func (c ToDateString) MarshalJSON() ([]byte, error)
type ToDateTimeString
- func (c ToDateTimeString) MarshalJSON() ([]byte, error)
type ToTimeString
- func (c ToTimeString) MarshalJSON() ([]byte, error)
type ToTimestamp
- func (c ToTimestamp) MarshalJSON() ([]byte, error)

Constants ¶

View Source

const (
	Version = "v1.2.2"
	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 ¶

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

CreateFromDate 从年月日创建Carbon实例

func CreateFromDateTime ¶

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

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

func CreateFromGoTime ¶

func CreateFromGoTime(t time.Time) Carbon

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

func CreateFromTime ¶

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

CreateFromTime 从时分秒创建Carbon实例

func CreateFromTimestamp ¶

func CreateFromTimestamp(timestamp int64) Carbon

CreateFromTimestamp 从时间戳创建Carbon实例

func Now ¶

func Now() Carbon

Now 当前

func Parse ¶

func Parse(value string) Carbon

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

func ParseByDuration ¶

func ParseByDuration(duration string) Carbon

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

func ParseByFormat ¶

func ParseByFormat(value string, format string) Carbon

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

func SetTimezone ¶

func SetTimezone(name string) Carbon

Timezone 设置时区

func Tomorrow ¶

func Tomorrow() Carbon

Tomorrow 明天

func Yesterday ¶

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) 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) AddSecond ¶

func (c Carbon) AddSecond() Carbon

AddSecond 1秒钟后

func (Carbon) AddSeconds ¶

func (c Carbon) AddSeconds(seconds int) Carbon

AddSeconds 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 ¶

func (c Carbon) Age() int

Age 获取年龄

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 ¶

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 ¶

func (c Carbon) Day() int

获取当前日

func (Carbon) DayOfMonth ¶

func (c Carbon) DayOfMonth() int

DayOfMonth 获取本月的第几天

func (Carbon) DayOfWeek ¶

func (c Carbon) DayOfWeek() int

DayOfWeek 获取本周的第几天

func (Carbon) DayOfYear ¶

func (c Carbon) DayOfYear() int

DayOfYear 获取本年的第几天

func (Carbon) DaysInMonth ¶

func (c Carbon) DaysInMonth() int

DaysInMonth 获取本月的总天数

func (Carbon) DaysInYear ¶

func (c Carbon) DaysInYear() int

DaysInYear 获取本年的总天数

func (Carbon) DiffAbsInDays ¶

func (start Carbon) DiffAbsInDays(end Carbon) int64

DiffAbsInDays 相差多少天（绝对值）

func (Carbon) DiffAbsInHours ¶

func (start Carbon) DiffAbsInHours(end Carbon) int64

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

func (Carbon) DiffAbsInMinutes ¶

func (start Carbon) DiffAbsInMinutes(end Carbon) int64

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

func (Carbon) DiffAbsInSeconds ¶

func (start Carbon) DiffAbsInSeconds(end Carbon) int64

DiffAbsInSeconds 相差多少秒（绝对值）

func (Carbon) DiffAbsInWeeks ¶

func (start Carbon) DiffAbsInWeeks(end Carbon) int64

DiffAbsInWeeks 相差多少周（绝对值）

func (Carbon) DiffInDays ¶

func (start Carbon) DiffInDays(end Carbon) int64

DiffInDays 相差多少天

func (Carbon) DiffInHours ¶

func (start Carbon) DiffInHours(end Carbon) int64

DiffInHours 相差多少小时

func (Carbon) DiffInMinutes ¶

func (start Carbon) DiffInMinutes(end Carbon) int64

DiffInMinutes 相差多少分钟

func (Carbon) DiffInSeconds ¶

func (start Carbon) DiffInSeconds(end Carbon) int64

DiffInSeconds 相差多少秒

func (Carbon) DiffInWeeks ¶

func (start Carbon) DiffInWeeks(end Carbon) int64

DiffInWeeks 相差多少周

func (Carbon) Duration ¶

func (c Carbon) Duration(duration string) Carbon

Duration 按照持续时间字符串改变时间(指定时区) 支持正负整数/浮点数和符号ns(纳秒)、us(微妙)、ms(毫秒)、s(秒)、m(分钟)、h(小时)的组合

func (Carbon) EndOfDay ¶

func (c Carbon) EndOfDay() Carbon

EndOfDay 本日结束时间

func (Carbon) EndOfHour ¶

func (c Carbon) EndOfHour() Carbon

EndOfHour 小时结束时间

func (Carbon) EndOfMinute ¶

func (c Carbon) EndOfMinute() Carbon

EndOfMinute 分钟结束时间

func (Carbon) EndOfMonth ¶

func (c Carbon) EndOfMonth() Carbon

EndOfMonth 本月结束时间

func (Carbon) EndOfWeek ¶

func (c Carbon) EndOfWeek() Carbon

EndOfWeek 本周结束时间

func (Carbon) EndOfYear ¶

func (c Carbon) EndOfYear() Carbon

EndOfYear 本年结束时间

func (Carbon) Format ¶

func (c Carbon) Format(format string) string

Format ToFormatString的简称

func (Carbon) Hour ¶

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 ¶

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 ¶

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 ¶

func (c Carbon) IsNow() bool

IsNow 是否是当前时间

func (Carbon) IsOctober ¶

func (c Carbon) IsOctober() bool

IsOctober 是否是十月

func (Carbon) IsPast ¶

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 ¶

func (c Carbon) IsWeekday() bool

IsWeekday 是否是工作日

func (Carbon) IsWeekend ¶

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 ¶

func (c Carbon) IsZero() bool

IsZero 是否是零值

func (Carbon) MarshalJSON ¶

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

func (Carbon) Minute ¶

func (c Carbon) Minute() int

获取当前分钟数

func (Carbon) Month ¶

func (c Carbon) Month() int

获取当前月

func (Carbon) MonthOfYear ¶

func (c Carbon) MonthOfYear() int

MonthOfYear 获取本年的第几月

func (Carbon) NextMonth ¶

func (c Carbon) NextMonth() Carbon

NextMonth 1月后

func (Carbon) NextMonths ¶

func (c Carbon) NextMonths(months int) Carbon

N月后

func (Carbon) NextYear ¶

func (c Carbon) NextYear() Carbon

NextYear 1年后

func (Carbon) NextYears ¶

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 ¶

func (c Carbon) PreMonth() Carbon

NextMonth 1月后

func (Carbon) PreMonths ¶

func (c Carbon) PreMonths(months int) Carbon

NextMonths N月后

func (Carbon) PreYear ¶

func (c Carbon) PreYear() Carbon

PreYear 1年前

func (Carbon) PreYears ¶

func (c Carbon) PreYears(years int) Carbon

PreYears N年前

func (*Carbon) Scan ¶

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

func (Carbon) Second ¶

func (c Carbon) Second() int

获取当前秒数

func (Carbon) SetDay ¶

func (c Carbon) SetDay(day int) Carbon

SetDay 设置日

func (Carbon) SetHour ¶

func (c Carbon) SetHour(hour int) Carbon

SetHour 设置时

func (Carbon) SetMinute ¶

func (c Carbon) SetMinute(minute int) Carbon

SetMinute 设置分

func (Carbon) SetMonth ¶

func (c Carbon) SetMonth(month int) Carbon

SetMonth 设置月

func (Carbon) SetSecond ¶

func (c Carbon) SetSecond(second int) Carbon

SetSecond 设置秒

func (Carbon) SetTimezone ¶

func (c Carbon) SetTimezone(name string) Carbon

Timezone 设置时区

func (Carbon) SetYear ¶

func (c Carbon) SetYear(year int) Carbon

SetYear 设置年

func (Carbon) StartOfDay ¶

func (c Carbon) StartOfDay() Carbon

StartOfDay 本日开始时间

func (Carbon) StartOfHour ¶

func (c Carbon) StartOfHour() Carbon

StartOfHour 小时开始时间

func (Carbon) StartOfMinute ¶

func (c Carbon) StartOfMinute() Carbon

StartOfMinute 分钟开始时间

func (Carbon) StartOfMonth ¶

func (c Carbon) StartOfMonth() Carbon

StartOfMonth 本月开始时间

func (Carbon) StartOfWeek ¶

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) 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) SubSecond ¶

func (c Carbon) SubSecond() Carbon

SubSecond 1秒钟前

func (Carbon) SubSeconds ¶

func (c Carbon) SubSeconds(seconds int) Carbon

SubSeconds 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 ¶

func (c Carbon) ToAnsicString() string

ToAnsicString 输出ANSIC格式字符串

func (Carbon) ToAtomString ¶

func (c Carbon) ToAtomString() string

ToAtomString 输出Atom格式字符串

func (Carbon) ToCookieString ¶

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 ¶

func (c Carbon) ToDayDateTimeString() string

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

func (Carbon) ToFormatString ¶

func (c Carbon) ToFormatString(format string) string

ToFormatString 输出指定格式时间

func (Carbon) ToKitchenString ¶

func (c Carbon) ToKitchenString() string

ToKitchenString 输出Kitchen格式字符串

func (Carbon) ToLunarYear ¶

func (c Carbon) ToLunarYear() string

ToLunarYear 获取农历年

func (Carbon) ToRFC1036String ¶

func (c Carbon) ToRFC1036String() string

ToRfc1036String 输出RFC1036格式字符串

func (Carbon) ToRFC1123String ¶

func (c Carbon) ToRFC1123String() string

ToRfc1123String 输出RFC1123格式字符串

func (Carbon) ToRFC1123ZString ¶

func (c Carbon) ToRFC1123ZString() string

ToRFC1123ZString 输出RFC1123Z格式字符串

func (Carbon) ToRFC2822String ¶

func (c Carbon) ToRFC2822String() string

ToRFC2822String 输出RFC2822格式字符串

func (Carbon) ToRFC3339String ¶

func (c Carbon) ToRFC3339String() string

ToRfc3339String 输出RFC3339格式字符串

func (Carbon) ToRFC7231String ¶

func (c Carbon) ToRFC7231String() string

ToRfc7231String 输出RFC7231格式字符串

func (Carbon) ToRFC822String ¶

func (c Carbon) ToRFC822String() string

ToRfc822String 输出RFC822格式字符串

func (Carbon) ToRFC822zString ¶

func (c Carbon) ToRFC822zString() string

ToRfc822String 输出RFC822Z格式字符串

func (Carbon) ToRFC850String ¶

func (c Carbon) ToRFC850String() string

ToRfc850String 输出RFC850格式字符串

func (Carbon) ToRssString ¶

func (c Carbon) ToRssString() string

ToRssString 输出RSS格式字符串

func (Carbon) ToRubyDateString ¶

func (c Carbon) ToRubyDateString() string

ToUnixDateString 输出RubyDate格式字符串

func (Carbon) ToString ¶

func (c Carbon) ToString() string

ToString 输出字符串

func (Carbon) ToTimeString ¶

func (c Carbon) ToTimeString() string

ToTimeString 输出时间字符串

func (Carbon) ToTimestamp ¶

func (c Carbon) ToTimestamp() int64

ToTimestamp 输出时间戳

func (Carbon) ToUnixDateString ¶

func (c Carbon) ToUnixDateString() string

ToUnixDateString 输出UnixDate格式字符串

func (Carbon) ToW3cString ¶

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 ¶

func (c Carbon) WeekOfMonth() int

WeekOfMonth 获取本月的第几周

func (Carbon) WeekOfYear ¶

func (c Carbon) WeekOfYear() int

WeekOfYear 获取本年的第几周

func (Carbon) Year ¶

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)

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL