carbon

package module
v1.4.8 Latest Latest
Warning

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

 Go to latest Published: Aug 5, 2021 License: MIT Imports: 8 Imported by: 0

README

Carbon

Build Status Go Report Card codecov Go doc

English | Chinese

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/kumparan/carbon

gitee:gitee.com/go-package/carbon

Installation
// By github
go get -u github.com/kumparan/carbon

import (
    "github.com/kumparan/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
// Datetime of today
fmt.Sprintf("%s", carbon.Now()) // 2020-08-05 13:14:15
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 given timezone
carbon.Now(Carbon.NewYork).ToDateTimeString() // 2020-08-05 14:14:15
carbon.SetTimezone(Carbon.NewYork).Now().ToDateTimeString() // 2020-08-05 14:14:15

// Datetime of yesterday 
fmt.Sprintf("%s", carbon.Yesterday()) // 2020-08-04 13:14:15
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 given day
carbon.Parse("2021-01-28 13:14:15").Yesterday().ToDateTimeString() // 2021-01-27 13:14:15
// Datetime of yesterday in given timezone
carbon.Yesterday(Carbon.NewYork).ToDateTimeString() // 2020-08-04 14:14:15
carbon.SetTimezone(Carbon.NewYork).Yesterday().ToDateTimeString() // 2020-08-04 14:14:15

// Datetime of tomorrow
fmt.Sprintf("%s", carbon.Tomorrow()) // 2020-08-06 13:14:15
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 given day
carbon.Parse("2021-01-28 13:14:15").Tomorrow().ToDateTimeString() // 2021-01-29 13:14:15
// Datetime of tomorrow in given timezone
carbon.Tomorrow(Carbon.NewYork).ToDateTimeString() // 2020-08-06 14:14:15
carbon.SetTimezone(Carbon.NewYork).Tomorrow().ToDateTimeString() // 2020-08-06 14:14:15
Create carbon instance
// Create carbon instance from timestamp with second
carbon.CreateFromTimestamp(-1).ToDateTimeString() // 1970-01-01 07:59:59
carbon.CreateFromTimestamp(-1, carbon.Tokyo).ToDateTimeString() // 1970-01-01 08:59:59
carbon.CreateFromTimestamp(0).ToDateTimeString() // 1970-01-01 08:00:00
carbon.CreateFromTimestamp(0, carbon.Tokyo).ToDateTimeString() // 1970-01-01 09:00:00
carbon.CreateFromTimestamp(1596604455).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromTimestamp(1596604455, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
// Create carbon instance from timestamp with millisecond
carbon.CreateFromTimestamp(1596604455000).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromTimestamp(1596604455000, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
// Create carbon instance from timestamp with microsecond
carbon.CreateFromTimestamp(1596604455000000).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromTimestamp(1596604455000000, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
// Create carbon instance from timestamp with nanosecond
carbon.CreateFromTimestamp(1596604455000000000).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromTimestamp(1596604455000000000, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14: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
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
// Create carbon instance from year, month and day
carbon.CreateFromDate(2020, 8, 5).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromDate(2020, 8, 5, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
// Create carbon instance from hour, minute and second
carbon.CreateFromTime(13, 14, 15).ToDateTimeString() // 2020-08-05 13:14:15
carbon.CreateFromTime(13, 14, 15, carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
Parse as carbon by standard string
carbon.Parse("").ToDateTimeString() // empty string
carbon.Parse("0").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 13:14:15
carbon.Parse("2020-08-05 13:14:15", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
Parse as carbon by format string
carbon.ParseByFormat("2020|08|05 13|14|15", "Y|m|d H|i|s").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("It is 2020-08-05 13:14:15", "\\I\\t \\i\\s Y-m-d H:i:s").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("今天是 2020年08月05日13时14分15秒", "今天是 Y年m月d日H时i分s秒").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("2020-08-05 13:14:15", "Y-m-d H:i:s", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
Parse as carbon by layout string
carbon.ParseByLayout("2020|08|05 13|14|15", "2006|01|02 15|04|05").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006-01-02 15:04:05").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("今天是 2020年08月05日13时14分15秒", "今天是 2006年01月02日15时04分05秒").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("2020-08-05 13:14:15", "2006-01-02 15:04:05", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
Convert between carbon and time.Time
// Time.time convert to Carbon
carbon.Time2Carbon(time.Now())
// Carbon convert to Time.time
carbon.Now().Carbon2Time()
Start and end
// Start of the century
carbon.Parse("2020-08-05 13:14:15").StartOfCentury().ToDateTimeString() // 2000-01-01 00:00:00
// End of the century
carbon.Parse("2020-08-05 13:14:15").EndOfCentury().ToDateTimeString() // 2999-12-31 23:59:59

// Start of the decade
carbon.Parse("2020-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
carbon.Parse("2021-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
carbon.Parse("2029-08-05 13:14:15").StartOfDecade().ToDateTimeString() // 2020-01-01 00:00:00
// End of the decade
carbon.Parse("2020-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
carbon.Parse("2021-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59
carbon.Parse("2029-08-05 13:14:15").EndOfDecade().ToDateTimeString() // 2029-12-31 23:59:59

// 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 quarter
carbon.Parse("2020-08-05 13:14:15").StartOfQuarter().ToDateTimeString() // 2020-07-01 00:00:00
// End of the quarter
carbon.Parse("2020-08-05 13:14:15").EndOfQuarter().ToDateTimeString() // 2020-09-30 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(time.Sunday).ToDateTimeString() // 2020-08-02 00:00:00
carbon.Parse("2020-08-05 13:14:15").StartOfWeek(time.Monday).ToDateTimeString() // 2020-08-03 00:00:00
// End of the week
carbon.Parse("2020-08-05 13:14:15").EndOfWeek(time.Sunday).ToDateTimeString() // 2020-08-08 23:59:59
carbon.Parse("2020-08-05 13:14:15").EndOfWeek(time.Monday).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
// 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
// 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 from now time
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
// Difference for humans from another time
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
// Whether 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
carbon.Parse("2020-08-05").SetTimezone("xxx").IsZero() // false

// Whether is invalid time
carbon.Parse("").IsInvalid() // true
carbon.Parse("0").IsInvalid() // true
carbon.Parse("0000-00-00 00:00:00").IsInvalid() // true
carbon.Parse("0000-00-00").IsInvalid() // true
carbon.Parse("00:00:00").IsInvalid() // true
carbon.Parse("2020-08-05 00:00:00").IsInvalid() // false
carbon.Parse("2020-08-05").IsInvalid() // false
carbon.Parse("2020-08-05").SetTimezone("xxx").IsInvalid() // true

// Whether is now time
carbon.Now().IsNow() // true
// Whether is future time
carbon.Tomorrow().IsFuture() // true
// Whether is pass time
carbon.Yesterday().IsPast() // true

// Whether is leap year
carbon.Parse("2020-08-05 13:14:15").IsLeapYear() // true
// Whether is long year
carbon.Parse("2020-08-05 13:14:15").IsLongYear() // true

// Whether is january 
carbon.Parse("2020-08-05 13:14:15").IsJanuary() // false
// Whether is february
carbon.Parse("2020-08-05 13:14:15").IsFebruary() // false
// Whether is march
carbon.Parse("2020-08-05 13:14:15").IsMarch() // false
// Whether is april
carbon.Parse("2020-08-05 13:14:15").IsApril()  // false
// Whether is may
carbon.Parse("2020-08-05 13:14:15").IsMay() // false
// Whether is june
carbon.Parse("2020-08-05 13:14:15").IsJune() // false
// Whether is july
carbon.Parse("2020-08-05 13:14:15").IsJuly() // false
// Whether is august
carbon.Parse("2020-08-05 13:14:15").IsAugust() // false
// Whether is september
carbon.Parse("2020-08-05 13:14:15").IsSeptember() // true
// Whether is october
carbon.Parse("2020-08-05 13:14:15").IsOctober() // false
// Whether is november
carbon.Parse("2020-08-05 13:14:15").IsNovember() // false
// Whether is december
carbon.Parse("2020-08-05 13:14:15").IsDecember() // false

// Whether is monday
carbon.Parse("2020-08-05 13:14:15").IsMonday() // false
// Whether is tuesday
carbon.Parse("2020-08-05 13:14:15").IsTuesday() // true
// Whether is wednesday
carbon.Parse("2020-08-05 13:14:15").IsWednesday() // false
// Whether is thursday
carbon.Parse("2020-08-05 13:14:15").IsThursday()  // false
// Whether is friday
carbon.Parse("2020-08-05 13:14:15").IsFriday() // false
// Whether is saturday
carbon.Parse("2020-08-05 13:14:15").IsSaturday() // false
// Whether is sunday
carbon.Parse("2020-08-05 13:14:15").IsSunday() // false
// Whether is weekday
carbon.Parse("2020-08-05 13:14:15").IsWeekday() // false
// Whether is weekend
carbon.Parse("2020-08-05 13:14:15").IsWeekend() // true

// Whether 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
// Whether 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
// Whether 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

// Whether 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

// Whether 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

// Whether 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

// Whether 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

// Whether 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

// Whether 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

// Whether 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

// Whether between included start
carbon.Parse("2020-08-05 13:14:15").BetweenIncludedStart(carbon.Parse("2020-08-05 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").BetweenIncludedStart(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true

// Whether between included end 
carbon.Parse("2020-08-05 13:14:15").BetweenIncludedEnd(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-05 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").BetweenIncludedEnd(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true

// Whether 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

For the definition of long year, please refer to https://en.wikipedia.org/wiki/ISO_8601#Week_dates

Output
// Output timestamp with second, ToTimestamp() is short for ToTimestampWithSecond()
carbon.Parse("2020-08-05 13:14:15").ToTimestamp() // 1596604455
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithSecond() // 1596604455
// Output timestamp with millisecond
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMillisecond() // 1596604455000
// Output timestamp with microsecond
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithMicrosecond() // 1596604455000000
// Output timestamp with nanosecond
carbon.Parse("2020-08-05 13:14:15").ToTimestampWithNanosecond() // 1596604455000000000

// Output datetime format string
carbon.Parse("2020-08-05 13:14:15").ToDateTimeString() // 2020-08-05 13:14:15
carbon.Parse("2020-08-05 13:14:15").ToDateTimeString(carbon.Tokyo) // 2020-08-05 14:14:15
// Output short datetime format string
carbon.Parse("2020-08-05 13:14:15").ToShortDateTimeString() // 20200805131415
carbon.Parse("2020-08-05 13:14:15").ToShortDateTimeString(carbon.Tokyo) // 20200805141415

// Output date format string
carbon.Parse("2020-08-05 13:14:15").ToDateString() // 2020-08-05
carbon.Parse("2020-08-05 13:14:15").ToDateString(carbon.Tokyo) // 2020-08-05
// Output short date format string
carbon.Parse("2020-08-05 13:14:15").ToShortDateString() // 20200805
carbon.Parse("2020-08-05 13:14:15").ToShortDateString(carbon.Tokyo) // 20200805

// Output time format string
carbon.Parse("2020-08-05 13:14:15").ToTimeString() // 13:14:15
carbon.Parse("2020-08-05 13:14:15").ToTimeString(carbon.Tokyo) // 14:14:15
// Output short time format string
carbon.Parse("2020-08-05 13:14:15").ToShortTimeString() // 131415
carbon.Parse("2020-08-05 13:14:15").ToShortTimeString(carbon.Tokyo) // 141415

// Output Ansic format string
carbon.Parse("2020-08-05 13:14:15").ToAnsicString() // Wed Aug  5 13:14:15 2020
carbon.Parse("2020-08-05 13:14:15").ToAnsicString(carbon.Tokyo) // Wed Aug  5 14:14:15 2020
// Output Atom format string
carbon.Parse("2020-08-05 13:14:15").ToAtomString() // 2020-08-05T13:14:15+08:00
carbon.Parse("2020-08-05 13:14:15").ToAtomString(carbon.Tokyo) // 2020-08-05T14:14:15+08:00
// Output UnixDate format string
carbon.Parse("2020-08-05 13:14:15").ToUnixDateString() // Wed Aug  5 13:14:15 CST 2020
carbon.Parse("2020-08-05 13:14:15").ToUnixDateString(carbon.Tokyo) // Wed Aug  5 14:14:15 JST 2020
// Output RubyDate format string
carbon.Parse("2020-08-05 13:14:15").ToRubyDateString() // Wed Aug 05 13:14:15 +0800 2020
carbon.Parse("2020-08-05 13:14:15").ToRubyDateString(carbon.Tokyo) // Wed Aug 05 14:14:15 +0900 2020
// Output Kitchen format string
carbon.Parse("2020-08-05 13:14:15").ToKitchenString() // 1:14PM
carbon.Parse("2020-08-05 13:14:15").ToKitchenString(carbon.Tokyo) // 2:14PM
// Output Cookie format string
carbon.Parse("2020-08-05 13:14:15").ToCookieString() // Wednesday, 05-Aug-2020 13:14:15 CST
carbon.Parse("2020-08-05 13:14:15").ToCookieString(carbon.Tokyo) // Wednesday, 05-Aug-2020 14:14:15 JST
// Output output day, date and time format string
carbon.Parse("2020-08-05 13:14:15").ToDayDateTimeString() // Wed, Aug 5, 2020 1:14 PM
carbon.Parse("2020-08-05 13:14:15").ToDayDateTimeString(carbon.Tokyo) // Wed, Aug 5, 2020 2:14 PM
// Output RSS format string
carbon.Parse("2020-08-05 13:14:15").ToRssString() // Wed, 05 Aug 2020 13:14:15 +0800
carbon.Parse("2020-08-05 13:14:15").ToRssString(carbon.Tokyo) // Wed, 05 Aug 2020 14:14:15 +0900
// Output W3C format string
carbon.Parse("2020-08-05 13:14:15").ToW3cString() // 2020-08-05T13:14:15+08:00
carbon.Parse("2020-08-05 13:14:15").ToW3cString(carbon.Tokyo) // 2020-08-05T14:14:15+09:00

// Output ISO8601 format string
carbon.Parse("2020-08-05 13:14:15").ToIso8601String() // 2020-08-05T13:14:15+08:00
carbon.Parse("2020-08-05 13:14:15").ToIso8601String(carbon.Tokyo) // 2020-08-05T14:14:15+09:00
// Output RFC822 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc822String() // 05 Aug 20 13:14 CST
carbon.Parse("2020-08-05 13:14:15").ToRfc822String(carbon.Tokyo) // 05 Aug 20 14:14 JST
// Output RFC822Z format string
carbon.Parse("2020-08-05 13:14:15").ToRfc822zString() // 05 Aug 20 13:14 +0800
carbon.Parse("2020-08-05 13:14:15").ToRfc822zString(carbon.Tokyo) // 05 Aug 20 14:14 +0900
// Output RFC850 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc850String() // Wednesday, 05-Aug-20 13:14:15 CST
carbon.Parse("2020-08-05 13:14:15").ToRfc850String(carbon.Tokyo) // Wednesday, 05-Aug-20 14:14:15 JST
// Output RFC1036 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc1036String() // Wed, 05 Aug 20 13:14:15 +0800
carbon.Parse("2020-08-05 13:14:15").ToRfc1036String(carbon.Tokyo) // Wed, 05 Aug 20 14:14:15 +0900
// Output RFC1123 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc1123String() // Wed, 05 Aug 2020 13:14:15 CST
carbon.Parse("2020-08-05 13:14:15").ToRfc1123String(carbon.Tokyo) // Wed, 05 Aug 2020 14:14:15 JST
// Output RFC1123Z format string
carbon.Parse("2020-08-05 13:14:15").ToRfc1123zString() // Wed, 05 Aug 2020 13:14:15 +0800
carbon.Parse("2020-08-05 13:14:15").ToRfc1123zString(carbon.Tokyo) // Wed, 05 Aug 2020 14:14:15 0800
// Output RFC2822 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc2822String() // Wed, 05 Aug 2020 13:14:15 +0800
carbon.Parse("2020-08-05 13:14:15").ToRfc2822String(carbon.Tokyo) // Wed, 05 Aug 2020 14:14:15 +0900
// Output RFC3339 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc3339String() // 2020-08-05T13:14:15+08:00
carbon.Parse("2020-08-05 13:14:15").ToRfc3339String(carbon.Tokyo) // 2020-08-05T14:14:15+09:00
// Output RFC7231 format string
carbon.Parse("2020-08-05 13:14:15").ToRfc7231String() // Wed, 05 Aug 2020 13:14:15 GMT
carbon.Parse("2020-08-05 13:14:15").ToRfc7231String(carbon.Tokyo) // Wed, 05 Aug 2020 14:14:15 GMT

// Output date and time format string
fmt.Sprintf("%s", carbon.Parse("2020-08-05 13:14:15")) // 2020-08-05 13:14:15
fmt.Sprintf("%s", carbon.Parse("2020-08-05 13:14:15", carbon.Tokyo)) // 2020-08-05 13:14:15

// Output "2006-01-02 15:04:05.999999999 -0700 MST" format string
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").ToString(carbon.Tokyo) // 2020-08-05 14:14:15 +0900 JST

// Output string by layout, Layout() is short for ToLayoutString()
carbon.Parse("2020-08-05 13:14:15").Layout("20060102150405") // 20200805131415
carbon.Parse("2020-08-05 13:14:15").Layout("2006年01月02日 15时04分05秒") // 2020年08月05日 13时14分15秒
carbon.Parse("2020-08-05 13:14:15").Layout("It is 2006-01-02 15:04:05") // It is 2020-08-05 13:14:15
carbon.Parse("2020-08-05 13:14:15").Layout("2006-01-02 15:04:05", carbon.Tokyo) // 2020-08-05 14:14:15

// Output string by format, Format() is short for ToFormatString()
carbon.Parse("2020-08-05 13:14:15").Format("YmdHis") // 20200805131415
carbon.Parse("2020-08-05 13:14:15").Format("Y年m月d日 H时i分s秒") // 2020年08月05日 13时14分15秒
carbon.Parse("2020-08-05 13:14:15").Format("l jS \\o\\f F Y h:i:s A") // Wednesday 5th of August 2020 01:14:15 PM
carbon.Parse("2020-08-05 13:14:15").Format("\\I\\t \\i\\s Y-m-d H:i:s") // It is 2020-08-05 13:14:15
carbon.Parse("2020-08-05 13:14:15").Format("Y-m-d H:i:s", carbon.Tokyo) // 2020-08-05 14:14:15

For more supported format signs, please see the Format sign table

Getter
// 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 decade
carbon.Parse("2019-08-05 13:14:15").Decade() // 10
carbon.Parse("2021-08-05 13:14:15").Decade() // 20
// 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() // CST
carbon.SetTimezone(carbon.Tokyo).Timezone() // JST

// Get location name
carbon.SetTimezone(carbon.PRC).Location() // PRC
carbon.SetTimezone(carbon.Tokyo).Location() // Asia/Tokyo

// Get offset seconds from the UTC timezone
carbon.SetTimezone(carbon.PRC).Offset() // 28800
carbon.SetTimezone(carbon.Tokyo).Offset() // 32400

// 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 season name
carbon.Now().Season() // Summer
carbon.Now().SetLocale("en").Season() // Summer
carbon.Now().SetLocale("zh-CN").Season() // 夏季

// Get current age
carbon.Parse("2002-01-01 13:14:15").Age() // 17
carbon.Parse("2002-12-31 13:14:15").Age() // 18

If you have any doubt about 'WeekOfYear()' and 'WeekOfMonth()', please refer to ISO8601 standard

Setter
// 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).Now().SetTimezone(carbon.PRC).ToDateTimeString() // 2020-08-05 12: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
Constellation
// Get constellation name
carbon.Parse("2020-08-05 13:14:15").Constellation() // Leo

// Whether is aries
carbon.Parse("2020-08-05 13:14:15").IsAries() // false
// Whether is taurus
carbon.Parse("2020-08-05 13:14:15").IsTaurus() // false
// Whether is gemini
carbon.Parse("2020-08-05 13:14:15").IsGemini() // false
// Whether is cancer
carbon.Parse("2020-08-05 13:14:15").IsCancer() // false
// Whether is leo
carbon.Parse("2020-08-05 13:14:15").IsLeo() // true
// Whether is virgo
carbon.Parse("2020-08-05 13:14:15").IsVirgo() // false
// Whether is libra
carbon.Parse("2020-08-05 13:14:15").IsLibra() // false
// Whether is scorpio
carbon.Parse("2020-08-05 13:14:15").IsScorpio() // false
// Whether is sagittarius
carbon.Parse("2020-08-05 13:14:15").IsSagittarius() // false
// Whether is capricorn
carbon.Parse("2020-08-05 13:14:15").IsCapricorn() // false
// Whether is aquarius
carbon.Parse("2020-08-05 13:14:15").IsAquarius() // false
// Whether is pisces
carbon.Parse("2020-08-05 13:14:15").IsPisces() // false
Season

According to the meteorological division, March to May is spring, June to August is summer, September to November is autumn, and December to February is winter

// Get season name
carbon.Parse("2020-08-05 13:14:15").Season() // Summer

// Start of the season
carbon.Parse("2020-08-05 13:14:15").StartOfSeason().ToDateTimeString() // 2020-06-01 00:00:00
// End of the season
carbon.Parse("2020-08-05 13:14:15").EndOfSeason().ToDateTimeString() // 2020-08-31 23:59:59

// Whether is spring
carbon.Parse("2020-08-05 13:14:15").IsSpring() // false
// Whether is summer
carbon.Parse("2020-08-05 13:14:15").IsSummer() // true
// Whether is autumn
carbon.Parse("2020-08-05 13:14:15").IsAutumn() // false
// Whether is winter
carbon.Parse("2020-08-05 13:14:15").IsWinter() // false
Lunar

Currently only 200 years from 1900 to 2100 are supported

// Get year of animal
carbon.Parse("2020-08-05 13:14:15").Lunar().Animal() // 鼠

// Get festival of lunar
carbon.Parse("2021-02-12 13:14:15").Lunar().Festival() // 春节

// Get year of lunar
carbon.Parse("2020-08-05 13:14:15").Lunar().Year() // 2020
// Get month of lunar
carbon.Parse("2020-08-05 13:14:15").Lunar().Month() // 6
// Get leap month of lunar
carbon.Parse("2020-08-05 13:14:15").Lunar().LeapMonth() // 4
// Get day of lunar
carbon.Parse("2020-08-05 13:14:15").Lunar().Day() // 16

// Get year in chinese
carbon.Parse("2020-08-05 13:14:15").Lunar().ToYearString() // 二零二零
// Get month in chinese
carbon.Parse("2020-08-05 13:14:15").Lunar().ToMonthString() // 六
// Get day in chinese
carbon.Parse("2020-08-05 13:14:15").Lunar().ToDayString() // 十六
// Get full string in chinese
fmt.Sprintf("%s", carbon.Parse("2020-08-05 13:14:15").Lunar()) // 二零二零年六月十六
carbon.Parse("2020-08-05 13:14:15").Lunar().ToString() // 二零二零年六月十六

// Whether is leap year
carbon.Parse("2020-08-05 13:14:15").Lunar().IsLeapYear() // true
// Whether is leap month
carbon.Parse("2020-08-05 13:14:15").Lunar().IsLeapMonth() // false

// Whether is year of the rat
carbon.Parse("2020-08-05 13:14:15").Lunar().IsRatYear() // true
// Whether is year of the ox
carbon.Parse("2020-08-05 13:14:15").Lunar().IsOxYear() // false
// Whether is year of the tiger
carbon.Parse("2020-08-05 13:14:15").Lunar().IsTigerYear() // false
// Whether is year of the rabbit
carbon.Parse("2020-08-05 13:14:15").Lunar().IsRabbitYear() // false
// Whether is year of the dragon
carbon.Parse("2020-08-05 13:14:15").Lunar().IsDragonYear() // false
// Whether is year of the snake
carbon.Parse("2020-08-05 13:14:15").Lunar().IsSnakeYear() // false
// Whether is year of the horse
carbon.Parse("2020-08-05 13:14:15").Lunar().IsHorseYear() // false
// Whether is year of the goat
carbon.Parse("2020-08-05 13:14:15").Lunar().IsGoatYear() // false
// Whether is year of the monkey
carbon.Parse("2020-08-05 13:14:15").Lunar().IsMonkeyYear() // false
// Whether is year of the rooster
carbon.Parse("2020-08-05 13:14:15").Lunar().IsRoosterYear() // false
// Whether is year of the dog
carbon.Parse("2020-08-05 13:14:15").Lunar().IsDogYear() // false
// Whether is year of the dig
carbon.Parse("2020-08-05 13:14:15").Lunar().IsPigYear() // false
JSON handling
Define model
type Person 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
person := Person {
	ID:          1,
	Name:        "gouguoyin",
	Age:         18,
	Birthday:    ToDateTimeString{Now().SubYears(18)},
	GraduatedAt: ToDateString{Parse("2020-08-05 13:14:15")},
	CreatedAt:   ToTimeString{Parse("2021-08-05 13:14:15")},
	UpdatedAt:   ToTimestamp{Parse("2022-08-05 13:14:15")},
	DateTime1:   ToTimestampWithSecond{Parse("2023-08-05 13:14:15")},
	DateTime2:   ToTimestampWithMillisecond{Parse("2024-08-05 13:14:15")},
	DateTime3:   ToTimestampWithMicrosecond{Parse("2025-08-05 13:14:15")},
	DateTime4:   ToTimestampWithNanosecond{Parse("2025-08-05 13:14:15")},
}
JSON encode
data, err := json.Marshal(&person)
if err != nil {
	t.Fatal(err)
}
fmt.Printf("%s",data)
// output
{
	"id":1,
	"name":"gouguoyin",
	"age":18,
	"birthday":"2003-07-16 16:22:02",
	"graduated_at":"2020-08-05",
	"created_at":"13:14:15",
	"updated_at":1659676455,
	"date_time1":1691212455,
	"date_time2":1722834855000,
	"date_time3":1754370855000000,
	"date_time4":1754370855000000000
}
JSON decode
str := `{
	"id":1,
	"name":"gouguoyin",
	"age":18,
	"birthday":"2003-07-16 16:22:02",
	"graduated_at":"2020-08-05",
	"created_at":"13:14:15",
	"updated_at":1659676455,
	"date_time1":1691212455,
	"date_time2":1722834855000,
	"date_time3":1754370855000000,
	"date_time4":1754370855000000000
}`
person := new(Person)
err := json.Unmarshal([]byte(str), &person)
if err != nil {
	t.Fatal(err)
}
fmt.Printf("%+v", *person)
// output
{ID:1 Name:gouguoyin Age:18 Birthday:2003-07-16 16:22:02 GraduatedAt:2020-08-05 00:00:00 CreatedAt:0000-01-01 13:14:15 UpdatedAt:2022-08-05 13:14:15 DTime1:2023-08-05 13:14:15 DateTime2:2024-08-05 13:14:15 DateTime3:2025-08-05 13:14:15 DateTime4:2025-08-05 13:14:15}
I18n

If you need to use i18n, please refer to the translation package

The following languages are supported

  • Simplified Chinese(zh-CN)
  • Traditional Chinese(zh-TW)
  • English(en)
  • Indonesian(id)
  • Japanese(jp)
  • Korean(kr)

The following methods are supported

  • DiffForHumans()：to string difference in human friendly readable format
  • 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
  • Season()：get season name
Set locale
lang := NewLanguage()
if err := lang.SetLocale("zh-CN");err != nil {
    // Error handle...
    log.Fatal(err)
}

c := carbon.SetLanguage(lang)
c.Now().AddHours(1).DiffForHumans() // 1 小时后
c.Now().AddHours(1).ToMonthString() // 八月
c.Now().AddHours(1).ToShortMonthString() // 8月
c.Now().AddHours(1).ToWeekString() // 星期二
c.Now().AddHours(1).ToShortWeekString() // 周二
c.Now().AddHours(1).Constellation() // 狮子座
c.Now().AddHours(1).Season() // 夏季
Set some resources(the rest still translate from the given locale)
lang := NewLanguage()

if err := lang.SetLocale("en");err != nil {
	// Error handle...
    log.Fatal(err)
}

resources := map[string]string {
    "hour":"%dh",
}
lang.SetResources(resources)

c := carbon.SetLanguage(lang)
c.Now().AddYears(1).DiffForHumans() // 1 year from now
c.Now().AddHours(1).DiffForHumans() // 1h from now
c.Now().ToMonthString() // August
c.Now().ToShortMonthString() // Aug
c.Now().ToWeekString() // Tuesday
c.Now().ToShortWeekString() // Tue
c.Now().Constellation() // Leo
c.Now().Season() // Summer
Set all resources
lang := NewLanguage()
resources := map[string]string {
    "seasons": "Spring|Summer|Autumn|Winter",
    "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",
    "yesterday": "yesterday",
    "tomorrow": "tomorrow",
}
lang.SetResources(resources)

c := carbon.SetLanguage(lang)
c.Now().AddYears(1).DiffForHumans() // in 1 yr
c.Now().AddHours(1).DiffForHumans() // in 1h
c.Now().ToMonthString() // August
c.Now().ToShortMonthString() // Aug
c.Now().ToWeekString() // Tuesday
c.Now().ToShortWeekString() // Tue
c.Now().Constellation() // Leo
c.Now().Season() // Summer
Error handling

If more than one error occurs, only the first error is returned

Scene one
c := carbon.SetTimezone(PRC).Parse("xxx")
if c.Error != nil {
    // Error handle...
    log.Fatal(c.Error)
}
fmt.Println(c.ToDateTimeString())
// Output
cannot parse "xxx" to carbon, please make sure the value is valid
Scene two
c := carbon.SetTimezone("xxx").Parse("2020-08-05")
if c.Error != nil {
    // Error handle...
    log.Fatal(c.Error)
}
fmt.Println(c.ToDateTimeString())
// Output
invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for all valid timezones
Scene three
c := carbon.SetTimezone("xxx").Parse("12345678")
if c.Error != nil {
    // Error handle...
    log.Fatal(c.Error)
}
fmt.Println(c.ToDateTimeString())
// Output
invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for all valid timezones
Appendix
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 Lowercase morning or afternoon sign 2 am/pm pm
A Uppercase morning or afternoon sign 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 Millisecond 3 - 999
w Numeric representation of the day of the week 1 0-6 6
t Total days of the month 2 28-31 30
z Day of the year - 0-365 15
e Location - - America/New_York
Q Quarter 1 1-4 1
C Century - 0-99 21
Reference

Documentation

Index

Constants

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"    // 土耳其

	Shanghai   = "Asia/Shanghai"       // 上海
	Chongqing  = "Asia/Chongqing"      // 重庆
	Harbin     = "Asia/Harbin"         // 哈尔滨
	HongKong   = "Asia/Hong_Kong"      // 香港
	Macao      = "Asia/Macao"          // 澳门
	Taipei     = "Asia/Taipei"         // 台北
	Tokyo      = "Asia/Tokyo"          // 东京
	Saigon     = "Asia/Saigon"         // 西贡
	Seoul      = "Asia/Seoul"          // 首尔
	Bangkok    = "Asia/Bangkok"        // 曼谷
	Dubai      = "Asia/Dubai"          // 迪拜
	NewYork    = "America/New_York"    // 纽约
	LosAngeles = "America/Los_Angeles" // 洛杉矶
	Chicago    = "America/Chicago"     // 芝加哥
	Moscow     = "Europe/Moscow"       // 莫斯科
	London     = "Europe/London"       // 伦敦
	Berlin     = "Europe/Berlin"       // 柏林
	Paris      = "Europe/Paris"        // 巴黎
	Rome       = "Europe/Rome"         // 罗马
)

时区常量

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
	Iso8601Format       = "2006-01-02T15:04:05-07:00"
	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

This section is empty.

Functions

This section is empty.

Types

type Carbon 

type Carbon struct {
	Time  time.Time
	Loc   *time.Location
	Lang  *Language
	Error error
}

Carbon 定义 Carbon 结构体

func CreateFromDate 

func CreateFromDate(year int, month int, day int, timezone ...string) Carbon

CreateFromDate 从年月日创建 Carbon 实例

func CreateFromDateTime 

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

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

func CreateFromTime 

func CreateFromTime(hour int, minute int, second int, timezone ...string) Carbon

CreateFromTime 从时分秒创建 Carbon 实例

func CreateFromTimestamp 

func CreateFromTimestamp(timestamp int64, timezone ...string) Carbon

CreateFromTimestamp 从时间戳创建 Carbon 实例

func NewCarbon 

func NewCarbon() Carbon

NewCarbon 初始化 Carbon 结构体

func Now 

func Now(timezone ...string) Carbon

Now 当前

func Parse 

func Parse(value string, timezone ...string) Carbon

Parse 将标准时间字符串解析成 Carbon 实例(默认时区)

func ParseByFormat 

func ParseByFormat(value string, format string, timezone ...string) Carbon

ParseByFormat 通过布局字符将字符串解析成 carbon 实例

func ParseByLayout 

func ParseByLayout(value string, layout string, timezone ...string) Carbon

ParseByLayout 将布局时间字符串解析成 Carbon 实例(默认时区)

func SetLanguage 

func SetLanguage(lang *Language) Carbon

SetLanguage 设置语言对象

func SetLocale 

func SetLocale(locale string) Carbon

SetLocale 设置语言区域

func SetTimezone 

func SetTimezone(name string) Carbon

SetTimezone 设置时区

func Time2Carbon 

func Time2Carbon(tt time.Time) Carbon

Time2Carbon 将 time.Time 转换成 Carbon

func Tomorrow 

func Tomorrow(timezone ...string) Carbon

Tomorrow 明天

func Yesterday 

func Yesterday(timezone ...string) Carbon

Yesterday 昨天

func (Carbon) AddCenturies 

func (c Carbon) AddCenturies(centuries int) Carbon

AddCenturies N世纪后

func (Carbon) AddCenturiesNoOverflow 

func (c Carbon) AddCenturiesNoOverflow(centuries int) Carbon

AddCenturiesNoOverflow N世纪后(月份不溢出)

func (Carbon) AddCentury 

func (c Carbon) AddCentury() Carbon

AddCentury 1世纪后

func (Carbon) AddCenturyNoOverflow 

func (c Carbon) AddCenturyNoOverflow() Carbon

AddCenturyNoOverflow 1世纪后(月份不溢出)

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 

func (c Carbon) AddDuration(duration string) Carbon

AddDuration 按照持续时长字符串增加时间 支持整数/浮点数和符号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) AddMonthNoOverflow 

func (c Carbon) AddMonthNoOverflow() Carbon

AddMonthNoOverflow 1月后(月份不溢出)

func (Carbon) AddMonths 

func (c Carbon) AddMonths(months int) Carbon

AddMonths N月后

func (Carbon) AddMonthsNoOverflow 

func (c Carbon) AddMonthsNoOverflow(months int) Carbon

AddMonthsNoOverflow N月后(月份不溢出)

func (Carbon) AddQuarter 

func (c Carbon) AddQuarter() Carbon

AddQuarter 1季度后

func (Carbon) AddQuarterNoOverflow 

func (c Carbon) AddQuarterNoOverflow() Carbon

AddQuarterNoOverflow 1季度后(月份不溢出)

func (Carbon) AddQuarters 

func (c Carbon) AddQuarters(quarters int) Carbon

AddQuarters N季度后

func (Carbon) AddQuartersNoOverflow 

func (c Carbon) AddQuartersNoOverflow(quarters int) Carbon

AddQuartersNoOverflow 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) AddYearNoOverflow 

func (c Carbon) AddYearNoOverflow() Carbon

AddYearNoOverflow 1年后(月份不溢出)

func (Carbon) AddYears 

func (c Carbon) AddYears(years int) Carbon

AddYears N年后

func (Carbon) AddYearsNoOverflow 

func (c Carbon) AddYearsNoOverflow(years int) Carbon

AddYearsNoOverflow N年后(月份不溢出)

func (Carbon) Age 

func (c Carbon) Age() int

Age 获取年龄

func (Carbon) Between 

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

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

func (Carbon) BetweenIncludedBoth 

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

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

func (Carbon) BetweenIncludedEnd 

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

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

func (Carbon) BetweenIncludedStart 

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

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

func (Carbon) Carbon2Time 

func (c Carbon) Carbon2Time() time.Time

Carbon2Time 将 Carbon 转换成 time.Time

func (Carbon) Century 

func (c Carbon) Century() int

Century 获取当前世纪

func (Carbon) Compare 

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

Compare 时间比较

func (Carbon) Constellation 

func (c Carbon) Constellation() string

Constellation 获取星座，支持i18n

func (Carbon) CreateFromDate 

func (c Carbon) CreateFromDate(year int, month int, day int, timezone ...string) Carbon

CreateFromDate 从年月日创建 Carbon 实例

func (Carbon) CreateFromDateTime 

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

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

func (Carbon) CreateFromTime 

func (c Carbon) CreateFromTime(hour int, minute int, second int, timezone ...string) Carbon

CreateFromTime 从时分秒创建 Carbon 实例

func (Carbon) CreateFromTimestamp 

func (c Carbon) CreateFromTimestamp(timestamp int64, timezone ...string) Carbon

CreateFromTimestamp 从时间戳创建 Carbon 实例

func (Carbon) Day 

func (c Carbon) Day() int

Day 获取当前日

func (Carbon) DayOfMonth 

func (c Carbon) DayOfMonth() int

DayOfMonth 获取本月的第几天(从1开始)

func (Carbon) DayOfWeek 

func (c Carbon) DayOfWeek() int

DayOfWeek 获取本周的第几天(从1开始)

func (Carbon) DayOfYear 

func (c Carbon) DayOfYear() int

DayOfYear 获取本年的第几天(从1开始)

func (Carbon) DaysInMonth 

func (c Carbon) DaysInMonth() int

DaysInMonth 获取本月的总天数

func (Carbon) DaysInYear 

func (c Carbon) DaysInYear() int

DaysInYear 获取本年的总天数

func (Carbon) Decade 

func (c Carbon) Decade() int

Decade 获取当前年代

func (Carbon) DiffForHumans 

func (c Carbon) DiffForHumans(carbon ...Carbon) string

DiffForHumans 获取对人类友好的可读格式时间差，支持i18n

func (Carbon) DiffInDays 

func (c Carbon) DiffInDays(carbon ...Carbon) int64

DiffInDays 相差多少天

func (Carbon) DiffInDaysWithAbs 

func (c Carbon) DiffInDaysWithAbs(carbon ...Carbon) int64

DiffInDaysWithAbs 相差多少天(绝对值)

func (Carbon) DiffInHours 

func (c Carbon) DiffInHours(carbon ...Carbon) int64

DiffInHours 相差多少小时

func (Carbon) DiffInHoursWithAbs 

func (c Carbon) DiffInHoursWithAbs(carbon ...Carbon) int64

DiffInHoursWithAbs 相差多少小时(绝对值)

func (Carbon) DiffInMinutes 

func (c Carbon) DiffInMinutes(carbon ...Carbon) int64

DiffInMinutes 相差多少分钟

func (Carbon) DiffInMinutesWithAbs 

func (c Carbon) DiffInMinutesWithAbs(carbon ...Carbon) int64

DiffInMinutesWithAbs 相差多少分钟(绝对值)

func (Carbon) DiffInMonths 

func (c Carbon) DiffInMonths(carbon ...Carbon) int64

DiffInMonths 相差多少月

func (Carbon) DiffInMonthsWithAbs 

func (c Carbon) DiffInMonthsWithAbs(carbon ...Carbon) int64

DiffInMonthsWithAbs 相差多少月(绝对值)

func (Carbon) DiffInSeconds 

func (c Carbon) DiffInSeconds(carbon ...Carbon) int64

DiffInSeconds 相差多少秒

func (Carbon) DiffInSecondsWithAbs 

func (c Carbon) DiffInSecondsWithAbs(carbon ...Carbon) int64

DiffInSecondsWithAbs 相差多少秒(绝对值)

func (Carbon) DiffInWeeks 

func (c Carbon) DiffInWeeks(carbon ...Carbon) int64

DiffInWeeks 相差多少周

func (Carbon) DiffInWeeksWithAbs 

func (c Carbon) DiffInWeeksWithAbs(carbon ...Carbon) int64

DiffInWeeksWithAbs 相差多少周(绝对值)

func (Carbon) DiffInYears 

func (c Carbon) DiffInYears(carbon ...Carbon) int64

DiffInYears 相差多少年

func (Carbon) DiffInYearsWithAbs 

func (c Carbon) DiffInYearsWithAbs(carbon ...Carbon) int64

DiffInYearsWithAbs 相差多少年(绝对值)

func (Carbon) EndOfCentury 

func (c Carbon) EndOfCentury() Carbon

EndOfCentury 本世纪结束时间

func (Carbon) EndOfDay 

func (c Carbon) EndOfDay() Carbon

EndOfDay 本日结束时间

func (Carbon) EndOfDecade 

func (c Carbon) EndOfDecade() Carbon

EndOfDecade 本年代结束时间

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) EndOfQuarter 

func (c Carbon) EndOfQuarter() Carbon

EndOfQuarter 本季度结束时间

func (Carbon) EndOfSeason 

func (c Carbon) EndOfSeason() Carbon

EndOfSeason 本季节结束时间

func (Carbon) EndOfSecond 

func (c Carbon) EndOfSecond() Carbon

EndOfSecond 秒结束时间

func (Carbon) EndOfWeek 

func (c Carbon) EndOfWeek(weekStartDay time.Weekday) Carbon

EndOfWeek 本周结束时间

func (Carbon) EndOfYear 

func (c Carbon) EndOfYear() Carbon

EndOfYear 本年结束时间

func (Carbon) Eq 

func (c Carbon) Eq(t Carbon) bool

Eq 等于

func (Carbon) Format 

func (c Carbon) Format(format string, timezone ...string) string

Format alias for ToFormatString Format ToFormatString的简写

func (Carbon) Gt 

func (c Carbon) Gt(t Carbon) bool

Gt 大于

func (Carbon) Gte 

func (c Carbon) Gte(t Carbon) bool

Gte 大于等于

func (Carbon) Hour 

func (c Carbon) Hour() int

Hour 获取当前小时

func (Carbon) IsApril 

func (c Carbon) IsApril() bool

IsApril 是否是四月

func (Carbon) IsAquarius 

func (c Carbon) IsAquarius() bool

IsAquarius 是否是水瓶座

func (Carbon) IsAries 

func (c Carbon) IsAries() bool

IsAries 是否是白羊座

func (Carbon) IsAugust 

func (c Carbon) IsAugust() bool

IsAugust 是否是八月

func (Carbon) IsAutumn 

func (c Carbon) IsAutumn() bool

IsAutumn 是否是秋季

func (Carbon) IsCancer 

func (c Carbon) IsCancer() bool

IsCancer 是否是巨蟹座

func (Carbon) IsCapricorn 

func (c Carbon) IsCapricorn() bool

IsCapricorn 是否是摩羯座

func (Carbon) IsDecember 

func (c Carbon) IsDecember() bool

IsDecember 是否是十二月

func (Carbon) IsFebruary 

func (c Carbon) IsFebruary() bool

IsFebruary 是否是二月

func (Carbon) IsFriday 

func (c Carbon) IsFriday() bool

IsFriday 是否是周五

func (Carbon) IsFuture 

func (c Carbon) IsFuture() bool

IsFuture 是否是未来时间

func (Carbon) IsGemini 

func (c Carbon) IsGemini() bool

IsGemini 是否是双子座

func (Carbon) IsInvalid 

func (c Carbon) IsInvalid() bool

IsInvalid 是否是无效的

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) IsLeo 

func (c Carbon) IsLeo() bool

IsLeo 是否是狮子座

func (Carbon) IsLibra 

func (c Carbon) IsLibra() bool

IsLibra 是否是天秤座

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) IsPisces 

func (c Carbon) IsPisces() bool

IsPisces 是否是双鱼座

func (Carbon) IsSagittarius 

func (c Carbon) IsSagittarius() bool

IsSagittarius 是否是射手座

func (Carbon) IsSaturday 

func (c Carbon) IsSaturday() bool

IsSaturday 是否是周六

func (Carbon) IsScorpio 

func (c Carbon) IsScorpio() bool

IsScorpio 是否是天蝎座

func (Carbon) IsSeptember 

func (c Carbon) IsSeptember() bool

IsSeptember 是否是九月

func (Carbon) IsSpring 

func (c Carbon) IsSpring() bool

IsSpring 是否是春季

func (Carbon) IsSummer 

func (c Carbon) IsSummer() bool

IsSummer 是否是夏季

func (Carbon) IsSunday 

func (c Carbon) IsSunday() bool

IsSunday 是否是周日

func (Carbon) IsTaurus 

func (c Carbon) IsTaurus() bool

IsTaurus 是否是金牛座

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) IsVirgo 

func (c Carbon) IsVirgo() bool

IsVirgo 是否是处女座

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) IsWinter 

func (c Carbon) IsWinter() bool

IsWinter 是否是冬季

func (Carbon) IsYesterday 

func (c Carbon) IsYesterday() bool

IsYesterday 是否是昨天

func (Carbon) IsZero 

func (c Carbon) IsZero() bool

IsZero 是否是零值

func (Carbon) Layout 

func (c Carbon) Layout(layout string, timezone ...string) string

Layout alias for ToLayoutString Layout ToLayoutString的简写

func (Carbon) Locale 

func (c Carbon) Locale() string

Locale 获取语言区域

func (Carbon) Location 

func (c Carbon) Location() string

Location 获取位置

func (Carbon) Lt 

func (c Carbon) Lt(t Carbon) bool

Lt 小于

func (Carbon) Lte 

func (c Carbon) Lte(t Carbon) bool

Lte 小于等于

func (Carbon) Lunar 

func (c Carbon) Lunar() (l lunar)

Lunar 将公历转为农历

func (Carbon) Microsecond 

func (c Carbon) Microsecond() int

Microsecond 获取当前微秒数，6位数字

func (Carbon) Millisecond 

func (c Carbon) Millisecond() int

Millisecond 获取当前毫秒数，3位数字

func (Carbon) Minute 

func (c Carbon) Minute() int

Minute 获取当前分钟数

func (Carbon) Month 

func (c Carbon) Month() int

Month 获取当前月

func (Carbon) MonthOfYear 

func (c Carbon) MonthOfYear() int

MonthOfYear 获取本年的第几月(从1开始)

func (Carbon) Nanosecond 

func (c Carbon) Nanosecond() int

Nanosecond 获取当前纳秒数，9位数字

func (Carbon) Ne 

func (c Carbon) Ne(t Carbon) bool

Ne 不等于

func (Carbon) Now 

func (c Carbon) Now(timezone ...string) Carbon

Now 当前

func (Carbon) Offset 

func (c Carbon) Offset() int

Offset 获取距离UTC时区的偏移量，单位秒

func (Carbon) Parse 

func (c Carbon) Parse(value string, timezone ...string) Carbon

Parse 将标准格式时间字符串解析成 Carbon 实例

func (Carbon) ParseByFormat 

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

ParseByFormat 通过格式化字符将字符串解析成 carbon 实例

func (Carbon) ParseByLayout 

func (c Carbon) ParseByLayout(value string, layout string, timezone ...string) Carbon

ParseByLayout 通过布局字符将字符串解析成 carbon 实例

func (Carbon) Quarter 

func (c Carbon) Quarter() (quarter int)

Quarter 获取当前季度

func (*Carbon) Scan 

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

Scan an interface used by Scan in package database/sql for Scanning value from database to local golang variable.

func (Carbon) Season 

func (c Carbon) Season() string

Season 获取当前季节(以气象划分)，支持i18n

func (Carbon) Second 

func (c Carbon) Second() int

Second 获取当前秒数，1-2位数字

func (Carbon) SetDay 

func (c Carbon) SetDay(day int) Carbon

SetDay 设置日

func (Carbon) SetHour 

func (c Carbon) SetHour(hour int) Carbon

SetHour 设置时

func (Carbon) SetLanguage 

func (c Carbon) SetLanguage(lang *Language) Carbon

SetLanguage 设置语言对象

func (Carbon) SetLocale 

func (c Carbon) SetLocale(locale string) Carbon

SetLocale 设置语言区域

func (Carbon) SetMicrosecond 

func (c Carbon) SetMicrosecond(microsecond int) Carbon

SetMicrosecond 设置微秒

func (Carbon) SetMillisecond 

func (c Carbon) SetMillisecond(millisecond int) Carbon

SetMillisecond 设置毫秒

func (Carbon) SetMinute 

func (c Carbon) SetMinute(minute int) Carbon

SetMinute 设置分

func (Carbon) SetMonth 

func (c Carbon) SetMonth(month int) Carbon

SetMonth 设置月

func (Carbon) SetNanosecond 

func (c Carbon) SetNanosecond(nanosecond int) Carbon

SetNanosecond 设置纳秒

func (Carbon) SetSecond 

func (c Carbon) SetSecond(second int) Carbon

SetSecond 设置秒

func (Carbon) SetTimezone 

func (c Carbon) SetTimezone(name string) Carbon

SetTimezone 设置时区

func (Carbon) SetYear 

func (c Carbon) SetYear(year int) Carbon

SetYear 设置年

func (Carbon) StartOfCentury 

func (c Carbon) StartOfCentury() Carbon

StartOfCentury 本世纪开始时间

func (Carbon) StartOfDay 

func (c Carbon) StartOfDay() Carbon

StartOfDay 本日开始时间

func (Carbon) StartOfDecade 

func (c Carbon) StartOfDecade() Carbon

StartOfDecade 本年代开始时间

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) StartOfQuarter 

func (c Carbon) StartOfQuarter() Carbon

StartOfQuarter 本季度开始时间

func (Carbon) StartOfSeason 

func (c Carbon) StartOfSeason() Carbon

StartOfSeason 本季节开始时间

func (Carbon) StartOfSecond 

func (c Carbon) StartOfSecond() Carbon

StartOfSecond 秒开始时间

func (Carbon) StartOfWeek 

func (c Carbon) StartOfWeek(weekStartDay time.Weekday) Carbon

StartOfWeek 本周开始时间

func (Carbon) StartOfYear 

func (c Carbon) StartOfYear() Carbon

StartOfYear 本年开始时间

func (Carbon) String 

func (c Carbon) String() string

String implement Stringer interface String 实现 Stringer 接口

func (Carbon) SubCenturies 

func (c Carbon) SubCenturies(centuries int) Carbon

SubCenturies N世纪前

func (Carbon) SubCenturiesNoOverflow 

func (c Carbon) SubCenturiesNoOverflow(centuries int) Carbon

SubCenturiesNoOverflow N世纪前(月份不溢出)

func (Carbon) SubCentury 

func (c Carbon) SubCentury() Carbon

SubCentury 1世纪前

func (Carbon) SubCenturyNoOverflow 

func (c Carbon) SubCenturyNoOverflow() Carbon

SubCenturyNoOverflow 1世纪前(月份不溢出)

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 

func (c Carbon) SubDuration(duration string) Carbon

SubDuration 按照持续时长字符串减少时间 支持整数/浮点数和符号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) SubMonthNoOverflow 

func (c Carbon) SubMonthNoOverflow() Carbon

SubMonthNoOverflow 1月前(月份不溢出)

func (Carbon) SubMonths 

func (c Carbon) SubMonths(months int) Carbon

SubMonths N月前

func (Carbon) SubMonthsNoOverflow 

func (c Carbon) SubMonthsNoOverflow(months int) Carbon

SubMonthsNoOverflow N月前(月份不溢出)

func (Carbon) SubQuarter 

func (c Carbon) SubQuarter() Carbon

SubQuarter 1季度前

func (Carbon) SubQuarterNoOverflow 

func (c Carbon) SubQuarterNoOverflow() Carbon

SubQuarterNoOverflow 1季度前(月份不溢出)

func (Carbon) SubQuarters 

func (c Carbon) SubQuarters(quarters int) Carbon

SubQuarters N季度前

func (Carbon) SubQuartersNoOverflow 

func (c Carbon) SubQuartersNoOverflow(quarters int) Carbon

SubQuartersNoOverflow 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) SubYearNoOverflow 

func (c Carbon) SubYearNoOverflow() Carbon

SubYearNoOverflow 1年前(月份不溢出)

func (Carbon) SubYears 

func (c Carbon) SubYears(years int) Carbon

SubYears N年前

func (Carbon) SubYearsNoOverflow 

func (c Carbon) SubYearsNoOverflow(years int) Carbon

SubYearsNoOverflow N年前(月份不溢出)

func (Carbon) Timezone 

func (c Carbon) Timezone() string

Timezone 获取时区

func (Carbon) ToAnsicString 

func (c Carbon) ToAnsicString(timezone ...string) string

ToAnsicString output ANSIC format string ToAnsicString 输出 ANSIC 格式字符串

func (Carbon) ToAtomString 

func (c Carbon) ToAtomString(timezone ...string) string

ToAtomString output ATOM format string ToAtomString 输出 ATOM 格式字符串

func (Carbon) ToCookieString 

func (c Carbon) ToCookieString(timezone ...string) string

ToCookieString output COOKIE format string ToCookieString 输出 COOKIE 格式字符串

func (Carbon) ToDateString 

func (c Carbon) ToDateString(timezone ...string) string

ToDateString output date format string ToDateString 输出日期字符串

func (Carbon) ToDateTimeString 

func (c Carbon) ToDateTimeString(timezone ...string) string

ToDateTimeString output date and time format string ToDateTimeString 输出日期时间字符串

func (Carbon) ToDayDateTimeString 

func (c Carbon) ToDayDateTimeString(timezone ...string) string

ToDayDateTimeString output day, date and time format string ToDayDateTimeString 输出天数日期时间字符串

func (Carbon) ToFormatString 

func (c Carbon) ToFormatString(format string, timezone ...string) string

ToFormatString output string by format string ToFormatString 输出指定格式的时间字符串

func (Carbon) ToIso8601String 

func (c Carbon) ToIso8601String(timezone ...string) string

ToIso8601String output ISO8601 format string ToIso8601String 输出 ISO8601 格式字符串

func (Carbon) ToKitchenString 

func (c Carbon) ToKitchenString(timezone ...string) string

ToKitchenString output KITCHEN format string ToKitchenString 输出 KITCHEN 格式字符串

func (Carbon) ToLayoutString 

func (c Carbon) ToLayoutString(layout string, timezone ...string) string

ToLayoutString output string by layout string ToLayoutString 输出指定布局的时间字符串

func (Carbon) ToMonthString 

func (c Carbon) ToMonthString(timezone ...string) string

ToMonthString output month format string, support i18n ToMonthString 输出完整月份字符串，支持i18n

func (Carbon) ToRfc1036String 

func (c Carbon) ToRfc1036String(timezone ...string) string

ToRfc1036String output RFC1036 format string ToRfc1036String 输出 RFC1036 格式字符串

func (Carbon) ToRfc1123String 

func (c Carbon) ToRfc1123String(timezone ...string) string

ToRfc1123String output RFC1123 format string ToRfc1123String 输出 RFC1123 格式字符串

func (Carbon) ToRfc1123zString 

func (c Carbon) ToRfc1123zString(timezone ...string) string

ToRfc1123zString output RFC1123z format string ToRfc1123ZString 输出 RFC1123z 格式字符串

func (Carbon) ToRfc2822String 

func (c Carbon) ToRfc2822String(timezone ...string) string

ToRfc2822String output RFC2822 format string ToRfc2822String 输出 RFC2822 格式字符串

func (Carbon) ToRfc3339String 

func (c Carbon) ToRfc3339String(timezone ...string) string

ToRfc3339String output RFC3339 format string ToRfc3339String 输出 RFC3339 格式字符串

func (Carbon) ToRfc7231String 

func (c Carbon) ToRfc7231String(timezone ...string) string

ToRfc7231String output RFC7231 format string ToRfc7231String 输出 RFC7231 格式字符串

func (Carbon) ToRfc822String 

func (c Carbon) ToRfc822String(timezone ...string) string

ToRfc822String output RFC822 format string ToRfc822String 输出 RFC822 格式字符串

func (Carbon) ToRfc822zString 

func (c Carbon) ToRfc822zString(timezone ...string) string

ToRfc822zString output RFC822Z format string ToRfc822zString 输出 RFC822Z 格式字符串

func (Carbon) ToRfc850String 

func (c Carbon) ToRfc850String(timezone ...string) string

ToRfc850String output RFC850 format string ToRfc850String 输出 RFC850 格式字符串

func (Carbon) ToRssString 

func (c Carbon) ToRssString(timezone ...string) string

ToRssString output RSS format string ToRssString 输出 RSS 格式字符串

func (Carbon) ToRubyDateString 

func (c Carbon) ToRubyDateString(timezone ...string) string

ToRubyDateString output ruby date format string ToRubyDateString 输出 RubyDate 格式字符串

func (Carbon) ToShortDateString 

func (c Carbon) ToShortDateString(timezone ...string) string

ToShortDateString output short date format string ToShortDateString 输出简写日期字符串

func (Carbon) ToShortDateTimeString 

func (c Carbon) ToShortDateTimeString(timezone ...string) string

ToShortDateTimeString output short date and time format string ToShortDateTimeString 输出简写日期时间字符串

func (Carbon) ToShortMonthString 

func (c Carbon) ToShortMonthString(timezone ...string) string

ToShortMonthString output short month format string, support i18n ToShortMonthString 输出缩写月份字符串，支持i18n

func (Carbon) ToShortTimeString 

func (c Carbon) ToShortTimeString(timezone ...string) string

ToShortTimeString output short time format string ToShortTimeString 输出简写时间字符串

func (Carbon) ToShortWeekString 

func (c Carbon) ToShortWeekString(timezone ...string) string

ToShortWeekString output short week format string, support i18n ToShortWeekString 输出缩写星期字符串，支持i18n

func (Carbon) ToString 

func (c Carbon) ToString(timezone ...string) string

ToString output "2006-01-02 15:04:05.999999999 -0700 MST" format string ToString 输出"2006-01-02 15:04:05.999999999 -0700 MST"格式字符串

func (Carbon) ToTimeString 

func (c Carbon) ToTimeString(timezone ...string) string

ToTimeString output time format string ToTimeString 输出时间字符串

func (Carbon) ToTimestamp 

func (c Carbon) ToTimestamp() int64

ToTimestamp ToTimestampWithSecond的简称 ToTimestamp alias for ToTimestampWithSecond

func (Carbon) ToTimestampWithMicrosecond 

func (c Carbon) ToTimestampWithMicrosecond() int64

ToTimestampWithMicrosecond output timestamp with microsecond ToTimestampWithMicrosecond 输出微秒级时间戳

func (Carbon) ToTimestampWithMillisecond 

func (c Carbon) ToTimestampWithMillisecond() int64

ToTimestampWithMillisecond output timestamp with millisecond ToTimestampWithMillisecond 输出毫秒级时间戳

func (Carbon) ToTimestampWithNanosecond 

func (c Carbon) ToTimestampWithNanosecond() int64

ToTimestampWithNanosecond output timestamp with nanosecond ToTimestampWithNanosecond 输出纳秒级时间戳

func (Carbon) ToTimestampWithSecond 

func (c Carbon) ToTimestampWithSecond() int64

ToTimestampWithSecond output timestamp with second ToTimestampWithSecond 输出秒级时间戳

func (Carbon) ToUnixDateString 

func (c Carbon) ToUnixDateString(timezone ...string) string

ToUnixDateString output unix date format string ToUnixDateString 输出 UnixDate 格式字符串

func (Carbon) ToW3cString 

func (c Carbon) ToW3cString(timezone ...string) string

ToW3cString output W3C format string ToW3cString 输出 W3C 格式字符串

func (Carbon) ToWeekString 

func (c Carbon) ToWeekString(timezone ...string) string

ToWeekString output week format string, support i18n ToWeekString 输出完整星期字符串，支持i18n

func (Carbon) Tomorrow 

func (c Carbon) Tomorrow(timezone ...string) Carbon

Tomorrow 明天

func (Carbon) Value 

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

Value the interface providing the Value method for package database/sql/driver

func (Carbon) Week 

func (c Carbon) Week() int

Week 获取当前周(从0开始)

func (Carbon) WeekOfMonth 

func (c Carbon) WeekOfMonth() int

WeekOfMonth 获取本月的第几周(从1开始)

func (Carbon) WeekOfYear 

func (c Carbon) WeekOfYear() int

WeekOfYear 获取本年的第几周(从1开始)

func (Carbon) Year 

func (c Carbon) Year() int

Year 获取当前年

func (Carbon) Yesterday 

func (c Carbon) Yesterday(timezone ...string) Carbon

Yesterday 昨天

type Language 

type Language struct {
	// contains filtered or unexported fields
}

Language 定义 Language 结构体

func NewLanguage 

func NewLanguage() *Language

NewLanguage 初始化 Language 结构体

func (*Language) SetLocale 

func (lang *Language) SetLocale(locale string) error

SetLocale 设置区域

func (*Language) SetResources 

func (lang *Language) SetResources(resources map[string]string)

SetResources 设置资源

type ToDateString 

type ToDateString struct {
	Carbon
}

ToDateString 日期字符串

func (ToDateString) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToDateString) UnmarshalJSON 

func (t *ToDateString) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToDateTimeString 

type ToDateTimeString struct {
	Carbon
}

ToDateTimeString 日期时间字符串

func (ToDateTimeString) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToDateTimeString) UnmarshalJSON 

func (t *ToDateTimeString) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimeString 

type ToTimeString struct {
	Carbon
}

ToTimeString 时间字符串

func (ToTimeString) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimeString) UnmarshalJSON 

func (t *ToTimeString) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimestamp 

type ToTimestamp struct {
	Carbon
}

ToTimestamp 秒级时间戳

func (ToTimestamp) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimestamp) UnmarshalJSON 

func (t *ToTimestamp) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimestampWithMicrosecond 

type ToTimestampWithMicrosecond struct {
	Carbon
}

ToTimestampWithMicrosecond 微秒级时间戳

func (ToTimestampWithMicrosecond) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimestampWithMicrosecond) UnmarshalJSON 

func (t *ToTimestampWithMicrosecond) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimestampWithMillisecond 

type ToTimestampWithMillisecond struct {
	Carbon
}

ToTimestampWithMillisecond 毫秒级时间戳

func (ToTimestampWithMillisecond) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimestampWithMillisecond) UnmarshalJSON 

func (t *ToTimestampWithMillisecond) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimestampWithNanosecond 

type ToTimestampWithNanosecond struct {
	Carbon
}

ToTimestampWithNanosecond 纳秒级时间戳

func (ToTimestampWithNanosecond) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimestampWithNanosecond) UnmarshalJSON 

func (t *ToTimestampWithNanosecond) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

type ToTimestampWithSecond 

type ToTimestampWithSecond struct {
	Carbon
}

ToTimestampWithSecond 秒级时间戳

func (ToTimestampWithSecond) MarshalJSON 

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

MarshalJSON implements the interface MarshalJSON for json.Marshal.

func (*ToTimestampWithSecond) UnmarshalJSON 

func (t *ToTimestampWithSecond) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

Source Files

View all Source files

Directories

Path Synopsis

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.