# Carbon English | [Chinese](./README.md) #### Introduction A simple, semantic and developer-friendly golang package for datetime If you think it is helpful, please give me a star github:[github.com/golang-module/carbon](https://github.com/golang-module/carbon "github.com/golang-module/carbon") gitee:[gitee.com/go-package/carbon](https://gitee.com/go-package/carbon "gitee.com/go-package/carbon") #### Installation ```go // By github go get -u github.com/golang-module/carbon import ( "github.com/golang-module/carbon" ) // By gitee go get -u gitee.com/go-package/carbon import ( "gitee.com/go-package/carbon" ) ``` #### Usage and example > The default timezone is Local, assuming the current time is 2020-08-05 13:14:15 ##### Yesterday,today and tomorrow ```go // Datetime of today carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15 // Date of today carbon.Now().ToDateString() // 2020-08-05 // Time of today carbon.Now().ToTimeString() // 13:14:15 // Timestamp with second of today carbon.Now().ToTimestamp() // 1596604455 carbon.Now().ToTimestampWithSecond() // 1596604455 // Timestamp with millisecond of today carbon.Now().ToTimestampWithMillisecond() // 1596604455000 // Timestamp with microsecond of today carbon.Now().ToTimestampWithMicrosecond() // 1596604455000000 // Timestamp with nanosecond of today carbon.Now().ToTimestampWithNanosecond() // 1596604455000000000 // Datetime of today in specific timezone carbon.SetTimezone(Carbon.NewYork).Now().ToDateTimeString() // 2020-08-05 01:14:15 // Datetime of yesterday carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15 // Date of yesterday carbon.Yesterday().ToDateString() // 2020-08-04 // Time of yesterday carbon.Yesterday().ToTimeString() // 13:14:15 // Timestamp with second of yesterday carbon.Yesterday().ToTimestamp() // 1596518055 carbon.Yesterday().ToTimestampWithSecond() // 1596518055 // Timestamp with millisecond of yesterday carbon.Yesterday().ToTimestampWithMillisecond() // 1596518055000 // Timestamp with microsecond of yesterday carbon.Yesterday().ToTimestampWithMicrosecond() // 1596518055000000 // Timestamp with nanosecond of yesterday carbon.Yesterday().ToTimestampWithNanosecond() // 1596518055000000000 // Datetime of yesterday in specific timezone carbon.SetTimezone(Carbon.NewYork).Yesterday().ToDateTimeString() // 2020-08-04 01:14:15 // Datetime of yesterday in specific day carbon.Parse("2021-01-28 13:14:15").Yesterday().ToDateTimeString() // 2021-01-27 13:14:15 // Datetime of tomorrow carbon.Tomorrow().ToDateTimeString() // 2020-08-06 13:14:15 // Date of tomorrow carbon.Tomorrow().ToDateString() // 2020-08-06 // Time of tomorrow carbon.Tomorrow().ToTimeString() // 13:14:15 // Timestamp with second of tomorrow carbon.Tomorrow().ToTimestamp() // 1596690855 carbon.Tomorrow().ToTimestampWithSecond() // 1596690855 // Timestamp with millisecond of tomorrow carbon.Tomorrow().ToTimestampWithMillisecond() // 1596690855000 // Timestamp with microsecond of tomorrow carbon.Tomorrow().ToTimestampWithMicrosecond() // 1596690855000000 // Timestamp with nanosecond of tomorrow carbon.Tomorrow().ToTimestampWithNanosecond() // 1596690855000000000 // Datetime of tomorrow in specific timezone carbon.SetTimezone(Carbon.NewYork).Tomorrow().ToDateTimeString() // 2020-08-06 01:14:15 // Datetime of tomorrow in specific day carbon.Parse("2021-01-28 13:14:15").Tomorrow().ToDateTimeString() // 2021-01-29 13:14:15 ``` ##### Create carbon instance ```go // Create Carbon instance from timestamp with second carbon.CreateFromTimestamp(1596604455).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from timestamp with millisecond carbon.CreateFromTimestamp(1596604455000).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from timestamp with microsecond carbon.CreateFromTimestamp(1596604455000000).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from timestamp with nanosecond carbon.CreateFromTimestamp(1596604455000000000).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from year,month,day,hour,minute and second carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from year,month and day carbon.CreateFromDate(2020, 8, 5).ToDateTimeString() // 2020-08-05 13:14:15 // Create Carbon instance from hour,minute and second carbon.CreateFromTime(13, 14, 15).ToDateTimeString() // 2020-08-05 13:14:15 ``` ##### Parse standard string ```go carbon.Parse("").ToDateTimeString() // empty string carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // empty string carbon.Parse("0000-00-00").ToDateTimeString() // empty string 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 ``` ##### Parse by format string as carbon ```go carbon.ParseByFormat("2020|08|05 13|14|15", "Y|m|d H|i|s").ToDateTimeString // 2020-08-05 13:14:15 carbon.ParseByFormat("It is 2020-08-05 13:14:15", "It is 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 ``` ##### Parse by layout string as carbon ```go carbon.ParseByLayout("2020|08|05 13|14|15", "2006|01|02 15:04:05").ToDateTimeString // 2020-08-05 13:14:15 carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006|01|02 15:04:05").ToDateTimeString // 2020-08-05 13:14:15 carbon.ParseByLayout("今天是 2020年08月05日13时14分15秒", "今天是 2006年01月02日15时04分05秒").ToDateTimeString() // 2020-08-05 13:14:15 ``` ##### Convert between carbon and time.Time ```go // Time.time convert to Carbon carbon.Time2Carbon(time.Now()) // Carbon convert to Time.time carbon.Now().Carbon2Time() or carbon.Now().Time ``` ##### Start and end ```go // Start of the year carbon.Parse("2020-08-05 13:14:15").StartOfYear().ToDateTimeString() // 2020-01-01 00:00:00 // End of the year carbon.Parse("2020-08-05 13:14:15").EndOfYear().ToDateTimeString() // 2020-12-31 23:59:59 // Start of the month carbon.Parse("2020-08-05 13:14:15").StartOfMonth().ToStartTimeString() // 2020-08-01 00:00:00 // End of the month carbon.Parse("2020-08-05 13:14:15").EndOfMonth().ToDateTimeString() // 2020-08-31 23:59:59 // Start of the week carbon.Parse("2020-08-05 13:14:15").StartOfWeek().ToDateTimeString() // 2020-08-03 00:00:00 // End of the week carbon.Parse("2020-08-05 13:14:15").LastOfWeek().ToDateTimeString() // 2020-08-09 23:59:59 // Start of the day carbon.Parse("2020-08-05 13:14:15").StartOfDay().ToDateTimeString() // 2020-08-05 00:00:00 // End of the day carbon.Parse("2020-08-05 13:14:15").EndOfDay().ToDateTimeString() // 2020-08-05 23:59:59 // Start of the hour carbon.Parse("2020-08-05 13:14:15").StartOfHour().ToDateTimeString() // 2020-08-05 13:00:00 // End of the hour carbon.Parse("2020-08-05 13:14:15").EndOfHour().ToDateTimeString() // 2020-08-05 13:59:59 // Start of the minute carbon.Parse("2020-08-05 13:14:15").StartOfMinute().ToDateTimeString() // 2020-08-05 13:14:00 // End of the minute carbon.Parse("2020-08-05 13:14:15").EndOfMinute().ToDateTimeString() // 2020-08-05 13:14:59 // Start of the second carbon.Parse("2020-08-05 13:14:15").StartOfSecond().Format("Y-m-d H:i:s.u") // 2020-08-05 13:14:15.0 // End of the second carbon.Parse("2020-08-05 13:14:15").EndOfSecond().Format("Y-m-d H:i:s.u") // 2020-08-05 13:14:15.999 ``` ##### Addition and Subtraction ```go // Add three centuries carbon.Parse("2020-02-29 13:14:15").AddCenturies(3).ToDateTimeString() // 2320-02-29 13:14:15 // Add three centuries with no overflow carbon.Parse("2020-02-29 13:14:15").AddCenturiesNoOverflow(3).ToDateTimeString() // 2320-02-29 13:14:15 // Add one century carbon.Parse("2020-02-29 13:14:15").AddCentury().ToDateTimeString() // 2120-02-29 13:14:15 // Add one century with no overflow carbon.Parse("2020-02-29 13:14:15").AddCenturyNoOverflow().ToDateTimeString() // 2120-02-29 13:14:15 // Subtract three centuries carbon.Parse("2020-02-29 13:14:15").SubCenturies(3).ToDateTimeString() // 1720-02-29 13:14:15 // Subtract three centuries with no overflow carbon.Parse("2020-02-29 13:14:15").SubCenturiesNoOverflow(3).ToDateTimeString() // 1720-02-29 13:14:15 // Subtract one century carbon.Parse("2020-02-29 13:14:15").SubCentury().ToDateTimeString() // 1920-02-29 13:14:15 // Subtract one century with no overflow carbon.Parse("2020-02-29 13:14:15").SubCenturyNoOverflow().ToDateTimeString() // 1920-02-20 13:14:15 // Add three years carbon.Parse("2020-02-29 13:14:15").AddYears(3).ToDateTimeString() // 2023-03-01 13:14:15 // Add three years with no overflow carbon.Parse("2020-02-29 13:14:15").AddYearsNoOverflow(3).ToDateTimeString() // 2023-02-28 13:14:15 // Add one year carbon.Parse("2020-02-29 13:14:15").AddYear().ToDateTimeString() // 2021-03-01 13:14:15 // Add one year with no overflow carbon.Parse("2020-02-29 13:14:15").AddYearNoOverflow().ToDateTimeString() // 2021-02-28 13:14:15 // Subtract three years carbon.Parse("2020-02-29 13:14:15").SubYears(3).ToDateTimeString() // 2017-03-01 13:14:15 // Subtract three years with no overflow carbon.Parse("2020-02-29 13:14:15").SubYearsNoOverflow(3).ToDateTimeString() // 2017-02-28 13:14:15 // Subtract one year carbon.Parse("2020-02-29 13:14:15").SubYear().ToDateTimeString() // 2019-03-01 13:14:15 // Subtract one year with no overflow carbon.Parse("2020-02-29 13:14:15").SubYearNoOverflow().ToDateTimeString() // 2019-02-28 13:14:15 // Add three quarters carbon.Parse("2019-08-31 13:14:15").AddQuarters(3).ToDateTimeString() // 2019-03-02 13:14:15 // Add three quarters with no overflow carbon.Parse("2019-08-31 13:14:15").AddQuartersNoOverflow(3).ToDateTimeString() // 2019-02-29 13:14:15 // Add one quarter carbon.Parse("2019-11-30 13:14:15").AddQuarter().ToDateTimeString() // 2020-03-01 13:14:15 // Add one quarter with no overflow carbon.Parse("2019-11-30 13:14:15").AddQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15 // Subtract three quarters carbon.Parse("2019-08-31 13:14:15").SubQuarters(3).ToDateTimeString() // 2019-03-03 13:14:15 // Subtract three quarters with no overflow carbon.Parse("2019-08-31 13:14:15").SubQuartersNoOverflow(3).ToDateTimeString() // 2019-02-28 13:14:15 // Subtract one quarter carbon.Parse("2020-05-31 13:14:15").SubQuarter().ToDateTimeString() // 2020-03-02 13:14:15 // Subtract one quarter with no overflow carbon.Parse("2020-05-31 13:14:15").SubQuarterNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15 // Add three months carbon.Parse("2020-02-29 13:14:15").AddMonths(3).ToDateTimeString() // 2020-05-29 13:14:15 // Add three months with no overflow carbon.Parse("2020-02-29 13:14:15").AddMonthsNoOverflow(3).ToDateTimeString() // 2020-05-29 13:14:15 // Add one month carbon.Parse("2020-01-31 13:14:15").AddMonth().ToDateTimeString() // 2020-03-02 13:14:15 // Add one month with no overflow carbon.Parse("2020-01-31 13:14:15").AddMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15 // Subtract three months carbon.Parse("2020-02-29 13:14:15").SubMonths(3).ToDateTimeString() // 2019-11-29 13:14:15 // Subtract three months with no overflow carbon.Parse("2020-02-29 13:14:15").SubMonthsNoOverflow(3).ToDateTimeString() // 2019-11-29 13:14:15 // Subtract one month carbon.Parse("2020-03-31 13:14:15").SubMonth().ToDateTimeString() // 2020-03-02 13:14:15 // Subtract one month with no overflow carbon.Parse("2020-03-31 13:14:15").SubMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15 // Add three weeks carbon.Parse("2020-02-29 13:14:15").AddWeeks(3).ToDateTimeString() // 2020-03-21 13:14:15 // Add one week carbon.Parse("2020-02-29 13:14:15").AddWeek().ToDateTimeString() // 2020-03-07 13:14:15 // Subtract three weeks carbon.Parse("2020-02-29 13:14:15").SubWeeks(3).ToDateTimeString() // 2020-02-08 13:14:15 // Subtract three week carbon.Parse("2020-02-29 13:14:15").SubWeek().ToDateTimeString() // 2020-02-22 13:14:15 // Add three days carbon.Parse("2020-08-05 13:14:15").AddDays(3).ToDateTimeString() // 2020-08-08 13:14:15 // Add one day carbon.Parse("2020-08-05 13:14:15").AddDay().ToDateTimeString() // 2020-08-05 13:14:15 // Subtract three days carbon.Parse("2020-08-05 13:14:15").SubDays(3).ToDateTimeString() // 2020-08-02 13:14:15 // Subtract one day carbon.Parse("2020-08-05 13:14:15").SubDay().ToDateTimeString() // 2020-08-04 13:14:15 // Add three hours carbon.Parse("2020-08-05 13:14:15").AddHours(3).ToDateTimeString() // 2020-08-05 16:14:15 // Add two and a half hours carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5h").ToDateTimeString() // 2020-08-05 15:44:15 carbon.Parse("2020-08-05 13:14:15").AddDuration("2h30m").ToDateTimeString() // 2020-08-05 15:44:15 // Add one hour carbon.Parse("2020-08-05 13:14:15").AddHour().ToDateTimeString() // 2020-08-05 14:14:15 // Subtract three hours carbon.Parse("2020-08-05 13:14:15").SubHours(3).ToDateTimeString() // 2020-08-05 10:14:15 // Subtract two and a half hours carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5h").ToDateTimeString() // 2020-08-05 10:44:15 carbon.Parse("2020-08-05 13:14:15").SubDuration("2h30m").ToDateTimeString() // 2020-08-05 10:44:15 // Subtract one hour carbon.Parse("2020-08-05 13:14:15").SubHour().ToDateTimeString() // 2020-08-05 12:14:15 // Add three minutes carbon.Parse("2020-08-05 13:14:15").AddMinutes(3).ToDateTimeString() // 2020-08-05 13:17:15 // Add two and a half minutes carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5m").ToDateTimeString() // 2020-08-05 13:16:45 carbon.Parse("2020-08-05 13:14:15").AddDuration("2m30s").ToDateTimeString() // 2020-08-05 13:16:45 // Add one minute carbon.Parse("2020-08-05 13:14:15").AddMinute().ToDateTimeString() // 2020-08-05 13:15:15 // Subtract three minutes carbon.Parse("2020-08-05 13:14:15").SubMinutes(3).ToDateTimeString() // 2020-08-05 13:11:15 // Subtract two and a half minutes carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5m").ToDateTimeString() // 2020-08-05 13:11:45 // Subtract one minute carbon.Parse("2020-08-05 13:14:15").SubMinute().ToDateTimeString() // 2020-08-05 13:13:15 // Add three seconds carbon.Parse("2020-08-05 13:14:15").AddSeconds(3).ToDateTimeString() // 2020-08-05 13:14:18 // Add two and a half seconds carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:17 // Add one second carbon.Parse("2020-08-05 13:14:15").AddSecond().ToDateTimeString() // 2020-08-05 13:14:16 // Subtract three seconds carbon.Parse("2020-08-05 13:14:15").SubSeconds(3).ToDateTimeString() // 2020-08-05 13:14:12 // Subtract two and a half seconds carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:12 // Subtract one second carbon.Parse("2020-08-05 13:14:15").SubSecond().ToDateTimeString() // 2020-08-05 13:14:14 ``` ##### Difference ```go // Difference in weeks carbon.Parse("2020-08-05 13:14:15").DiffInWeeks(carbon.Parse("2020-07-28 13:14:15")) // -1 // Difference in weeks with absolute value carbon.Parse("2020-08-05 13:14:15").DiffInWeeksWithAbs(carbon.Parse("2020-07-28 13:14:15")) // 1 // Difference in days carbon.Parse("2020-08-05 13:14:15").DiffInDays(carbon.Parse("2020-08-04 13:14:15")) // -1 // Difference in days with absolute value carbon.Parse("2020-08-05 13:14:15").DiffInDaysWithAbs(carbon.Parse("2020-08-04 13:14:15")) // 1 // Difference in hours carbon.Parse("2020-08-05 13:14:15").DiffInHours(carbon.Parse("2020-08-05 12:14:15")) // -1 // Difference in hours with absolute value carbon.Parse("2020-08-05 13:14:15").DiffInHoursWithAbs(carbon.Parse("2020-08-05 12:14:15")) // 1 // Difference in minutes carbon.Parse("2020-08-05 13:14:15").DiffInMinutes(carbon.Parse("2020-08-05 13:13:15")) // -1 // Difference in minutes with absolute value carbon.Parse("2020-08-05 13:14:15").DiffInMinutesWithAbs(carbon.Parse("2020-08-05 13:13:15")) // 1 // Difference in seconds carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14:14")) // -1 // Difference in seconds with absolute value carbon.Parse("2020-08-05 13:14:15").DiffInSecondsWithAbs(carbon.Parse("2020-08-05 13:14:14")) // 1 // Difference for humans carbon.Parse("2020-08-05 13:14:15").DiffForHumans()) // just now carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // 1 year ago carbon.Parse("2018-08-05 13:14:15").DiffForHumans() // 2 years ago carbon.Parse("2021-08-05 13:14:15").DiffForHumans() // 1 year from now carbon.Parse("2022-08-05 13:14:15").DiffForHumans() // 2 years from now carbon.Parse("2020-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year before carbon.Parse("2019-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years before carbon.Parse("2018-08-05 13:14:15").DiffForHumans(carbon.Now()) // 1 year after carbon.Parse("2022-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 years after ``` ##### Comparison ```go // Is zero time 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 // Is now time carbon.Now().IsNow() // true // Is future time carbon.Tomorrow().IsFuture() // true // Is pass time carbon.Yesterday().IsPast() // true // Is leap year carbon.Parse("2020-08-05 13:14:15").IsLeapYear() // true // Is long year carbon.Parse("2020-08-05 13:14:15").IsLongYear() // true // Is january carbon.Parse("2020-08-05 13:14:15").IsJanuary() // false // Is february carbon.Parse("2020-08-05 13:14:15").IsFebruary() // false // Is march carbon.Parse("2020-08-05 13:14:15").IsMarch() // false // Is april carbon.Parse("2020-08-05 13:14:15").IsApril() // false // Is may carbon.Parse("2020-08-05 13:14:15").IsMay() // false // Is june carbon.Parse("2020-08-05 13:14:15").IsJune() // false // Is july carbon.Parse("2020-08-05 13:14:15").IsJuly() // false // Is august carbon.Parse("2020-08-05 13:14:15").IsAugust() // false // Is september carbon.Parse("2020-08-05 13:14:15").IsSeptember() // true // Is october carbon.Parse("2020-08-05 13:14:15").IsOctober() // false // Is november carbon.Parse("2020-08-05 13:14:15").IsNovember() // false // Is december carbon.Parse("2020-08-05 13:14:15").IsDecember() // false // Is monday carbon.Parse("2020-08-05 13:14:15").IsMonday() // false // Is tuesday carbon.Parse("2020-08-05 13:14:15").IsTuesday() // true // Is wednesday carbon.Parse("2020-08-05 13:14:15").IsWednesday() // false // Is thursday carbon.Parse("2020-08-05 13:14:15").IsThursday() // false // Is friday carbon.Parse("2020-08-05 13:14:15").IsFriday() // false // Is saturday carbon.Parse("2020-08-05 13:14:15").IsSaturday() // false // Is sunday carbon.Parse("2020-08-05 13:14:15").IsSunday() // false // Is weekday carbon.Parse("2020-08-05 13:14:15").IsWeekday() // false // Is weekend carbon.Parse("2020-08-05 13:14:15").IsWeekend() // true // Is yesterday 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 // Is today 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 // Is tomorrow 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 // Greater than 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 // Less than 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 // Equal 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 // Not equal 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 // Greater than or equal 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 // Less than or equal 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 // Between 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 // Between included start time 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 // Between included end time 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 // Between included both 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 ``` ##### Output ```go // To timestamp with second carbon.Parse("2020-08-05 13:14:15").ToTimestamp() // 1596604455 carbon.Parse("2020-08-05 13:14:15").ToTimestampWithSecond() // 1596604455 // To timestamp with millisecond carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMillisecond() // 1596604455000 // To timestamp with microsecond carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMicrosecond() // 1596604455000000 // To timestamp with nanosecond carbon.Parse("2020-08-05 13:14:15").ToTimestampWithNanosecond() // 1596604455000000000 // To string of datetime format carbon.Parse("2020-08-05 13:14:15").ToDateTimeString() // 2020-08-05 13:14:15 // To string of date format carbon.Parse("2020-08-05 13:14:15").ToDateString() // 2020-08-05 // To string of time format carbon.Parse("2020-08-05 13:14:15").ToTimeString() // 13:14:15 // To string of Ansic format carbon.Parse("2020-08-05 13:14:15").ToAnsicString() // Wed Aug 5 13:14:15 2020 // To string of Atom format carbon.Parse("2020-08-05 13:14:15").ToAtomString() // Wed Aug 5 13:14:15 2020 // To string of UnixDate format carbon.Parse("2020-08-05 13:14:15").ToUnixDateString() // Wed Aug 5 13:14:15 CST 2020 // To string of RubyDate format carbon.Parse("2020-08-05 13:14:15").ToRubyDateString() // Wed Aug 05 13:14:15 +0800 2020 // To string of Kitchen format carbon.Parse("2020-08-05 13:14:15").ToKitchenString() // 1:14PM // To string of Cookie format carbon.Parse("2020-08-05 13:14:15").ToCookieString() // Wednesday, 05-Aug-2020 13:14:15 CST // To string of DayDateTime format carbon.Parse("2020-08-05 13:14:15").ToDayDateTimeString() // Wed, Aug 5, 2020 1:14 PM // To string of RSS format carbon.Parse("2020-08-05 13:14:15").ToRssString() // Wed, 05 Aug 2020 13:14:15 +0800 // To string of W3C format carbon.Parse("2020-08-05 13:14:15").ToW3cString() // 2020-08-05T13:14:15+08:00 // To string of RFC822 format carbon.Parse("2020-08-05 13:14:15").ToRfc822String() // 05 Aug 20 13:14 CST // To string of RFC822Z format carbon.Parse("2020-08-05 13:14:15").ToRfc822zString() // 05 Aug 20 13:14 +0800 // To string of RFC850 format carbon.Parse("2020-08-05 13:14:15").ToRfc850String() // Wednesday, 05-Aug-20 13:14:15 CST // To string of RFC1036 format carbon.Parse("2020-08-05 13:14:15").ToRfc1036String() // Wed, 05 Aug 20 13:14:15 +0800 // To string of RFC1123 format carbon.Parse("2020-08-05 13:14:15").ToRfc1123String() // Wed, 05 Aug 2020 13:14:15 CST // To string of RFC2822 format carbon.Parse("2020-08-05 13:14:15").ToRfc2822String() // Wed, 05 Aug 2020 13:14:15 +0800 // To string of RFC3339 format carbon.Parse("2020-08-05 13:14:15").ToRfc3339String() // 2020-08-05T13:14:15+08:00 // To string of RFC7231 format carbon.Parse("2020-08-05 13:14:15").ToRfc7231String() // Wed, 05 Aug 2020 05:14:15 GMT // To string carbon.Parse("2020-08-05 13:14:15").Time.String() // 2020-08-05 13:14:15 +0800 CST // To string of sign format，Format() is short of ToFormatString() 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").Format("YmdHis") // 20200805131415 carbon.Parse("2020-08-05 13:14:15").Format("l jS \\o\\f F Y h:i:s A") // Wednesday 5th of August 2020 01:14:15 PM ``` > For more format signs, please see the Format sign table ##### Setter ```go // Set timezone 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 // Set locale carbon.Parse("2020-07-05 13:14:15").SetLocale("en").DiffForHumans()) // 1 month before carbon.Parse("2020-07-05 13:14:15").SetLocale("zh-CN").DiffForHumans()) // 1 月前 // Set year carbon.Parse("2019-08-05").SetYear(2020).ToDateString() // 2020-08-05 carbon.Parse("2020-02-29").SetYear(2019).ToDateString() // 2019-03-01 // Set month carbon.Parse("2020-01-31").SetMonth(2).ToDateString() // 2020-03-02 carbon.Parse("2020-08-05").SetMonth(2).ToDateString() // 2020-02-05 // Set day carbon.Parse("2019-08-05").SetDay(31).ToDateString() // 2020-08-31 carbon.Parse("2020-02-01").SetDay(31).ToDateString() // 2020-03-02 // Set hour 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 // Set minute 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 // Set second 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 ``` ##### Getter ```go // Get total days of the year carbon.Parse("2019-08-05 13:14:15").DaysInYear() // 365 carbon.Parse("2020-08-05 13:14:15").DaysInYear() // 366 // Get total days of the month 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 // Get day of the year (start with 1) carbon.Parse("2020-08-05 13:14:15").DayOfYear() // 218 // Get week of the year (start with 1) carbon.Parse("2020-08-05 13:14:15").WeekOfYear() // 32 // Get day of the month (start with 1) carbon.Parse("2020-08-05 13:14:15").DayOfMonth() // 5 // Get week of the month (start with 1) carbon.Parse("2020-08-05 13:14:15").WeekOfMonth() // 1 // Get day of the week (start with 1) carbon.Parse("2020-08-05 13:14:15").DayOfWeek() // 3 // Get current century carbon.Parse("2020-08-05 13:14:15").Century() // 21 // Get current year carbon.Parse("2020-08-05 13:14:15").Year() // 2020 // Get current quarter carbon.Parse("2020-08-05 13:14:15").Quarter() // 3 // Get current month carbon.Parse("2020-08-05 13:14:15").Month() // 8 // Get current week(start with 0) carbon.Parse("2020-08-05 13:14:15").Week() // 3 carbon.Parse("2020-08-05 13:14:15").Week() // 3 // Get current day carbon.Parse("2020-08-05 13:14:15").Day() // 5 // Get current hour carbon.Parse("2020-08-05 13:14:15").Hour() // 13 // Get current minute carbon.Parse("2020-08-05 13:14:15").Minute() // 14 // Get current second carbon.Parse("2020-08-05 13:14:15").Second() // 15 // Get current millisecond carbon.Parse("2020-08-05 13:14:15").Millisecond() // 1596604455000 // Get current microsecond carbon.Parse("2020-08-05 13:14:15").Microsecond() // 1596604455000000 // Get current nanosecond carbon.Parse("2020-08-05 13:14:15").Nanosecond() // 1596604455000000000 // Get timezone name carbon.SetTimezone(carbon.PRC).Timezone() // PRC carbon.SetTimezone(carbon.Tokyo).Timezone() // Asia/Tokyo // Get locale name carbon.Now().SetLocale("en").Locale() // en carbon.Now().SetLocale("zh-CN").Locale() // zh-CN // Get constellation name carbon.Now().Constellation() // Leo carbon.Now().SetLocale("en").Constellation() // Leo carbon.Now().SetLocale("zh-CN").Constellation() // 狮子座 // Get current age carbon.Parse("2002-01-01 13:14:15").Age() // 17 carbon.Parse("2002-12-31 13:14:15").Age() // 18 ``` ##### Calendar ```go // To year of the animal carbon.Parse("2020-08-05 13:14:15").ToAnimalYear() // 鼠 // To lunar year carbon.Parse("2020-08-05 13:14:15").ToLunarYear() // 庚子 // Is year of the rat carbon.Parse("2020-08-05 13:14:15").IsYearOfRat() // true // Is year of the ox carbon.Parse("2020-08-05 13:14:15").IsYearOfOx() // false // Is year of the tiger carbon.Parse("2020-08-05 13:14:15").IsYearOfTiger() // false // Is year of the rabbit carbon.Parse("2020-08-05 13:14:15").IsYearOfRabbit() // false // Is year of the dragon carbon.Parse("2020-08-05 13:14:15").IsYearOfDragon() // false // Is year of the snake carbon.Parse("2020-08-05 13:14:15").IsYearOfSnake() // false // Is year of the horse carbon.Parse("2020-08-05 13:14:15").IsYearOfHorse() // false // Is year of the goat carbon.Parse("2020-08-05 13:14:15").IsYearOfGoat() // false // Is year of the monkey carbon.Parse("2020-08-05 13:14:15").IsYearOfMonkey() // false // Is year of the rooster carbon.Parse("2020-08-05 13:14:15").IsYearOfRooster() // false // Is year of the dog carbon.Parse("2020-08-05 13:14:15").IsYearOfDog() // false // Is year of the dig carbon.Parse("2020-08-05 13:14:15").IsYearOfPig() // false ``` ##### Constellation ```go // Get constellation carbon.Parse("2020-08-05 13:14:15").Constellation() // Leo // Is aries carbon.Parse("2020-08-05 13:14:15").IsAries() // false // Is taurus carbon.Parse("2020-08-05 13:14:15").IsTaurus() // false // Is gemini carbon.Parse("2020-08-05 13:14:15").IsGemini() // false // Is cancer carbon.Parse("2020-08-05 13:14:15").IsCancer() // false // Is leo carbon.Parse("2020-08-05 13:14:15").IsLeo() // true // Is virgo carbon.Parse("2020-08-05 13:14:15").IsVirgo() // false // Is libra carbon.Parse("2020-08-05 13:14:15").IsLibra() // false // Is scorpio carbon.Parse("2020-08-05 13:14:15").IsScorpio() // false // Is sagittarius carbon.Parse("2020-08-05 13:14:15").IsSagittarius() // false // Is capricorn carbon.Parse("2020-08-05 13:14:15").IsCapricorn() // false // Is aquarius carbon.Parse("2020-08-05 13:14:15").IsAquarius() // false // Is pisces carbon.Parse("2020-08-05 13:14:15").IsPisces() // false ``` ##### Database > Assuming the database table is users, its fields have 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) ###### Define model ```go 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"` } ``` ###### Instantiate model ```go user := UserModel { ID: 1153, Name: "gouguoyin", 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()}, } ``` ###### Output fields ```go user.ID // 1153 user.Name // gouguoyin 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 ``` ###### Output model by json ```go data, _ := json.Marshal(&user) fmt.Print(string(data)) // Output { "id": 1153, "name": "gouguoyin", "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, } ``` ###### Output custom format ```go // Define format type ToRssString struct { carbon.Carbon } // Define model type UserModel struct { Birthday carbon.ToRssString `json:"birthday"` } // Instantiate model user := UserModel { Birthday: carbon.ToRssString{carbon.Now()}, } // Overload MarshalJSON method func (c ToRssString) MarshalJSON() ([]byte, error) { return []byte(fmt.Sprintf(`"%s"`, c.ToRssString())), nil } // Output model by json.Marshal(&user) { "birthday": "Wed, 05 Aug 2020 13:14:15 +0800", } ``` ##### I18n > If you need to use i18n, please copy Lang directory to project directory first The following languages are supported * [simplified Chinese(zh-CN)](./lang/zh-CN.json "simplified Chinese") * [traditional Chinese(zh-TW)](./lang/zh-TW.json "traditional Chinese") * [English(en)](./lang/en.json "English") * [Japanese(jp)](./lang/jp.json "日语") The following methods are supported * ToMonthString()：to string of month * ToShortMonthString()：to string of short month * ToWeekString()：to string of week * ToShortWeekString()：to string of short week * Constellation()：get constellation name ###### Set locale ```go // Way one(recommend) c := carbon.Now().AddHours(1).SetLocale("zh-CN") if c.Error != nil { // Error handle... log.Fatal(c.Error) } c.DiffForHumans() // 1 小时后 c.ToMonthString() // 八月 c.ToShortMonthString() // 8月 c.ToWeekString() // 星期二 c.ToShortWeekString() // 周二 c.Constellation() // 狮子座 // Way two lang := NewLanguage() if err := lang.SetLocale("zh-CN");err != nil { // Error handle... log.Fatal(err) } c.DiffForHumans() // 1 小时后 c.ToMonthString() // 八月 c.ToShortMonthString() // 8月 c.ToWeekString() // 星期二 c.ToShortWeekString() // 周二 c.Constellation() // 狮子座 ``` ###### Set dir ```go lang := NewLanguage() if err := lang.SetDir("lang");err != nil { // Error handle... log.Fatal(err) } c.DiffForHumans() // 1 hour from now c.ToMonthString() // August c.ToShortMonthString() // Aug c.ToWeekString() // Tuesday c.ToShortWeekString() // Tue c.Constellation() // Leo ``` ###### Set some resources(the rest still translate from the specific locale) ```go lang := NewLanguage() if err := lang.SetLocale("en");err != nil { // Error handle... log.Fatal(err) } resources := map[string]string { "hour":"%dh", } lang.SetResources(resources) carbon.Now().AddYears(1).SetLanguage(lang).DiffForHumans() // 1 year from now carbon.Now().AddHours(1).SetLanguage(lang).DiffForHumans() // 1h from now carbon.Now().SetLanguage(lang).ToMonthString() // August carbon.Now().SetLanguage(lang).ToShortMonthString() // Aug carbon.Now().SetLanguage(lang).ToWeekString() // Tuesday carbon.Now().SetLanguage(lang).ToShortWeekString() // Tue carbon.Now().SetLanguage(lang).Constellation() // Leo ``` ###### Set all resources ```go lang := NewLanguage() resources := map[string]string { "months": "January|February|March|April|May|June|July|August|September|October|November|December", "months_short": "Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec", "weeks": "Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|Saturday", "weeks_short": "Sun|Mon|Tue|Wed|Thu|Fri|Sat", "constellations": "Aries|Taurus|Gemini|Cancer|Leo|Virgo|Libra|Scorpio|Sagittarius|Capricornus|Aquarius|Pisce", "year":"1 yr|%d yrs", "month":"1 mo|%d mos", "week":"%dw", "day":"%dd", "hour":"%dh", "minute":"%dm", "second":"%ds", "now": "just now", "ago":"%s ago", "from_now":"in %s", "before":"%s before", "after":"%s after", } lang.SetResources(resources) carbon.Now().AddYears(1).SetLanguage(lang).DiffForHumans() // 1 year from now carbon.Now().AddHours(1).SetLanguage(lang).DiffForHumans() // 1h from now carbon.Now().SetLanguage(lang).ToMonthString() // August carbon.Now().SetLanguage(lang).ToShortMonthString() // Aug carbon.Now().SetLanguage(lang).ToWeekString() // Tuesday carbon.Now().SetLanguage(lang).ToShortWeekString() // Tue carbon.Now().SetLanguage(lang).Constellation() // Leo ``` ##### Error handling > If more than one error occurs, only the first error message is returned ###### Scene one ```go c := carbon.SetTimezone(PRC).Parse("123456") if c.Error != nil { // Error handle... log.Fatal(c.Error) } fmt.Println(c.ToDateTimeString()) // Output the value "123456" can't parse string as time ``` ###### Scene two ```go c := carbon.SetTimezone("XXXX").Parse("2020-08-05") if c.Error != nil { // Error handle... log.Fatal(c.Error) } fmt.Println(c.ToDateTimeString()) // Output invalid timezone "XXXX", please see the $GOROOT/lib/time/zoneinfo.zip file for all valid timezone ``` ###### Scene three ```go c := carbon.SetTimezone("XXXX").Parse("12345678") if c.Error != nil { // Error handle... log.Fatal(c.Error) } fmt.Println(c.ToDateTimeString()) // Output invalid timezone "XXXX", please see the $GOROOT/lib/time/zoneinfo.zip file for all valid timezone ``` #### Appendix ##### Format sign table | sign | desc | length | range | example | | :------------: | :------------: | :------------: | :------------: | :------------: | | d | Day of the month, 2 digits with leading zeros | 2 | 01-31 | 05 | | D | A textual representation of a day, three letters | 3 | Mon-Sun | Wed | | j | Day of the month without leading zeros | - |1-31 | 5 | | S | English ordinal suffix for the day of the month, 2 characters. Eg: st, nd, rd or th. Works well with j | 2 | st/nd/rd/th | th | | l | A full textual representation of the day of the week | - | Monday-Sunday | Wednesday | | F | A full textual representation of a month | - | January-December | August | | m | Numeric representation of a month, with leading zeros | 2 | 01-12 | 08 | | M | A short textual representation of a month, three letters | 3 | Jan-Dec | Aug | | n | Numeric representation of a month, without leading zeros | - | 1-12 | 8 | | y | A two digit representation of a year | 2 | 00-99 | 20 | | Y | A full numeric representation of a year, 4 digits | 4 | 0000-9999 | 2020 | | a | A full numeric representation of a year, 4 digits | 2 | am/pm | pm | | A | Uppercase Ante meridiem and Post meridiem | 2 | AM/PM | PM | | g | 12-hour format of an hour without leading zeros | - | 1-12 | 1 | | G | 24-hour format of an hour without leading zeros | - | 0-23 | 15 | | h | 12-hour format of an hour with leading zeros | 2 | 00-11 | 03 | | H | 24-hour format of an hour with leading zeros | 2 | 00-23 | 15 | | i | Minutes with leading zeros | 2 | 01-59 | 14 | | s | Seconds with leading zeros | 2 | 01-59 | 15 | | c | ISO 8601 date | - | - | 2020-08-05T15:19:21+00:00 | | r | RFC 2822 date | - | - | Thu, 21 Dec 2020 16:01:07 +0200 | | O | Difference to Greenwich time (GMT) without colon between hours and minutes | - | - | +0200 | | P | Difference to Greenwich time (GMT) with colon between hours and minutes | - | - | +02:00 | | T | Timezone abbreviation | - | - | EST | | W | ISO-8601 numeric representation of the week of the year | - | 1-52 | 42 | | N | ISO-8601 numeric representation of the day of the week | 1 | 1-7 | 6 | | L | Whether it's a leap year | 1 | 0-1 | 1 | | U | Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) | 10 | - | 1611818268 | | u | Microseconds| - | - | 999 | | w | Numeric representation of the day of the week | 1 | 0-6 | 6 | | t | Number of days in the given month | 2 | 28-31 | 30 | | z | The day of the year (starting from 0) | - | 0-365 | 15 | | e | Timezone identifier | - | - | America/New_York | #### Reference * [briannesbitt/carbon](https://github.com/briannesbitt/Carbon) * [uniplaces/carbon](https://github.com/uniplaces/carbon) * [jinzhu/now](https://github.com/jinzhu/now/) * [araddon/dateparse](https://github.com/araddon/dateparse) * [goframe/gtime](https://github.com/gogf/gf/tree/master/os/gtime) * [kofoworola/godate](https://github.com/kofoworola/godate) * [arrow-py/arrow](https://github.com/arrow-py/arrow)