Слияние кода завершено, страница обновится автоматически
Простой, семантический и удобный для разработчиков пакет времени для golang, 100% покрытие юнит-тестов, не зависит от любой сторонней библиотеки и включен в awesome-go
// Через github
go get -u github.com/dromara/carbon/v2
import "github.com/dromara/carbon/v2"
// Через gitee
go get -u gitee.com/dromara/carbon/v2
import "gitee.com/dromara/carbon/v2"
// Через gitcode
go get -u gitcode.com/dromara/carbon/v2
import "gitcode.com/dromara/carbon/v2"
Carbon был пожертвован в организацию dromara, URL репозитория изменился. Если ранее использовался репозиторий golang-module/carbon, пожалуйста, замените исходный репозиторий на новый репозиторий в go.mod, или выполните следующую команду:```go
go mod edit -replace github.com/golang-module/carbon/v2=github.com/dromara/carbon/v2
#### Пример использования
> По умолчанию часовой пояс `UTC`, язык локализации `English`, день недели, начинающийся с `Monday`, а выходные дни недели `Saturday` и `Sunday`.
> Предположим, что текущее время `2020-08-05 13:14:15.999999999 +0000 UTC`.
##### Установка глобальных по умолчанию
```go
carbon.SetLayout(carbon.DateTimeLayout)
carbon.SetTimezone(carbon.UTC)
carbon.SetLocale("en")
carbon.SetWeekStartsAt(carbon.Monday)
carbon.SetWeekendDays([]carbon.Weekday{carbon.Saturday, carbon.Sunday,})
или
carbon.SetDefault(carbon.Default{
Layout: carbon.DateTimeLayout,
Timezone: carbon.UTC,
Locale: "en",
WeekStartsAt: carbon.Monday,
WeekendDays: []carbon.Weekday{carbon.Saturday, carbon.Sunday,},
})
Carbon и time.Time
// Преобразование стандартного time.Time в Carbon
carbon.NewCarbon(time.Now())
// Преобразование Carbon в стандартное time.Time
carbon.Now().StdTime()
или
// Преобразование стандартного time.Time в Carbon
loc, _ := time.LoadLocation(carbon.PRC)
carbon.CreateFromStdTime(time.Now().In(loc))
// Преобразование Carbon в стандартное time.Time
carbon.Now(carbon.PRC).StdTime()
// Возвращает дату и время сегодня fmt.Printf("%s", carbon.Now()) // 2020-08-05 13:14:15 carbon.Now().String() // 2020-08-05 13:14:15 carbon.Now().ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15 // Возвращает дату сегодня carbon.Now().ToDateString() // 2020-08-05 // Возвращает время сегодня carbon.Now().ToTimeString() // 13:14:15 // Возвращает дату и время сегодня в заданном часовом поясе carbon.Now(carbon.NewYork).ToDateTimeString() // 2020-08-05 13:14:15 // Возвращает отметку времени с точностью до секунды сегодня carbon.Now().Timestamp() // 1596604455 // Возвращает отметку времени с точностью до миллисекунды сегодня carbon.Now().TimestampMilli() // 1596604455999 // Возвращает отметку времени с точностью до микросекунды сегодня carbon.Now().TimestampMicro() // 1596604455999999 // Возвращает отметку времени с точностью до наносекунды сегодня carbon.Now().TimestampNano() // 1596604455999999999
fmt.Printf("%s", carbon.Yesterday()) // 2020-08-04 13:14:15
carbon.Yesterday().String() // 2020-08-04 13:14:15
carbon.Yesterday().ToString() // 2020-08-04 13:14:15.999999999 +0000 UTC
carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15
// Возвращает дату вчерашнего дня
carbon.Yesterday().ToDateString() // 2020-08-04
// Возвращает время вчерашнего дня
carbon.Yesterday().ToTimeString() // 13:14:15
// Возвращает дату и время вчерашнего дня в заданной временной зоне
carbon.Yesterday(carbon.NewYork).ToDateTimeString() // 2020-08-04 13:14:15
// Возвращает таймстамп с точностью до секунды вчерашнего дня
carbon.Yesterday().Timestamp() // 1596546855
// Возвращает таймстамп с точностью до миллисекунды вчерашнего дня
carbon.Yesterday().TimestampMilli() // 1596546855999
```// Возвращает таймстамп с точностью до микросекунды вчерашнего дня
carbon. Yesterday(). TimestampMicro() // 1596546855999999
// Возвращает таймстамп с точностью до наносекунды вчерашнего дня
carbon. Yesterday(). TimestampNano() // 1596546855999999999
// Возвращает дату и время следующего дня
fmt. Printf("%s", carbon. Tomorrow()) // 2020-08-06 13:14:15
carbon. Tomorrow(). String() // 2020-08-06 13:14:15
carbon. Tomorrow(). ToString() // 2020-08-06 13:14:15.999999999 +0000 UTC
carbon. Tomorrow(). ToDateTimeString() // 2020-08-06 13:14:15
// Возвращает дату следующего дня
carbon. Tomorrow(). ToDateString() // 2020-08-06
// Возвращает время следующего дня
carbon. Tomorrow(). ToTimeString() // 13:14:15
// Возвращает дату и время следующего дня в заданной временной зоне
carbon. Tomorrow(carbon. NewYork). ToDateTimeString() // 2020-08-06 13:14:15
// Возвращает таймстамп с секундной точностью следующего дня
carbon. Tomorrow(). Timestamp() // 1596719655
// Возвращает таймстамп с миллисекундной точностью следующего дня
carbon. Tomorrow(). TimestampMilli() // 1596719655999
// Возвращает таймстамп с микросекундной точностью следующего дня
carbon. Tomorrow(). TimestampMicro() // 1596719655999999
// Возвращает таймстамп с наносекундной точностью следующего дня
carbon. Tomorrow(). TimestampNano() // 1596719655999999999```
##### Создание экземпляра `Carbon`
``````go
// Создание экземпляра Carbon из заданного таймстампа с секундной точностью
carbon.CreateFromTimestamp(-1).ToString() // 1969-12-31 23:59:59 +0000 UTC
carbon.CreateFromTimestamp(0).ToString() // 1970-01-01 00:00:00 +0000 UTC
carbon.CreateFromTimestamp(1).ToString() // 1970-01-01 00:00:01 +0000 UTC
carbon.CreateFromTimestamp(1596633255).ToString() // 2020-08-05 13:14:15 +0000 UTC
// Создание экземпляра Carbon из заданного таймстампа с миллисекундной точностью
carbon.CreateFromTimestampMilli(1596633255999999).ToString() // 2020-08-05 13:14:15. 999 +0000 UTC
// Создание экземпляра Carbon из заданного таймстампа с микросекундной точностью
carbon.CreateFromTimestampMicro(1596633255999999).ToString() // 2020-08-05 13:14:15. 999999 +0000 UTC
// Создание экземпляра Carbon из заданного таймстампа с наносекундной точностью
carbon.CreateFromTimestampNano(1596633255999999999).ToString() // 2020-08-05 13:14:15. 999999999 +0000 UTC
```// Создайте экземпляр Carbon из заданной даты и времени
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
// Создайте экземпляр Carbon из заданной даты и времени с миллисекундами
carbon.CreateFromDateTimeMilli(2020, 8, 5, 13, 14, 15, 999).ToString() // 2020-08-05 13:14:15. 999 +0000 UTC
// Создайте экземпляр Carbon из заданной даты и времени с микросекундами
carbon.CreateFromDateTimeMicro(2020, 8, 5, 13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15. 999999 +0000 UTC
// Создайте экземпляр Carbon из заданной даты и времени с наносекундами
carbon.CreateFromDateTimeNano(2020, 8, 5, 13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15. 999999999 +0000 UTC// Создайте экземпляр Carbon из заданного года, месяца и дня
carbon.CreateFromDate(2020, 8, 5).ToString() // 2020-08-05 00:00:00 +0000 UTC
// Создайте экземпляр Carbon из заданного года, месяца и дня с миллисекундами
carbon.CreateFromDateMilli(2020, 8, 5, 999). ToString() // 2020-08-05 00:00:00. 999 +0000 UTC
// Создайте экземпляр Carbon из заданного года, месяца и дня с микросекундами
carbon. CreateFromDateMicro(2020, 8, 5, 999999). ToString() // 2020-08-05 00:00:00. 999999 +0000 UTC
// Создайте экземпляр Carbon из заданного года, месяца и дня с наносекундами
carbon. CreateFromDateNano(2020, 8, 5, 999999999). ToString() // 2020-08-05 00:00:00. 999999999 +0000 UTC// Создайте экземпляр Carbon из заданного часа, минуты и секунды
carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
// Создайте экземпляр Carbon из заданного часа, минуты и секунды с миллисекундами
carbon.CreateFromTimeMilli(13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0000 UTC
// Создайте экземпляр Carbon из заданного часа, минуты и секунды с микросекундами
carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0000 UTC
// Создайте экземпляр Carbon из заданного часа, минуты и секунды с наносекундами
carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
Carbon
carbon.Parse("").ToDateTimeString() // пустая строка
carbon.Parse("0").ToDateTimeString() // пустая строка
carbon.Parse("xxx").ToDateTimeString() // пустая строка
carbon.Parse("00:00:00").ToDateTimeString() // пустая строка
carbon.Parse("0000-00-00").ToDateTimeString() // пустая строка
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // пустая строка
```carbon.Parse("now").ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Parse("yesterday").ToString() // 2020-08-04 13:14:15.999999999 +0000 UTC
carbon.Parse("tomorrow").ToString() // 2020-08-06 13:14:15.999999999 +0000 UTC
```carbon.Parse("2020").ToString() // 2020-01-01 00:00:00 +0000 UTC
carbon.Parse("2020-8").ToString() // 2020-08-01 00:00:00 +0000 UTC
carbon.Parse("2020-08").ToString() // 2020-08-01 00:00:00 +0000 UTC
carbon.Parse("2020-8-5").ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.Parse("2020-8-05").ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.Parse("2020-08-05.999").ToString() // 2020-08-05 00:00:00.999 +0000 UTC
carbon.Parse("2020-08-05.999999").ToString() // 2020-08-05 00:00:00.999999 +0000 UTC
carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0000 UTC
carbon.Parse("2020-8-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-8-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-05 13:14:15.999").ToString() // 2020-08-05 13:14:15.999 +0000 UTC
carbon.Parse("2020-08-05 13:14:15.999999").ToString() // 2020-08-05 13:14:15.999999 +0000 UTC
carbon.Parse("2020-08-05 13:14:15.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0000 UTCcarbon.Parse("2020-8-5T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-8-05T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-05T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-05T13:14:15.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0000 UTC
carbon.Parse("2020-08-05T13:14:15.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0000 UTC
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Parse("20200805").ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.Parse("20200805131415").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("20200805131415.999").ToString() // 2020-08-05 13:14:15.999 +0000 UTC
carbon.Parse("20200805131415.999999").ToString() // 2020-08-05 13:14:15.999999 +0000 UTC
carbon.Parse("20200805131415.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Parse("20200805131415.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0000 UTC
carbon.Parse("20200805131415.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0000 UTC
carbon.Parse("20200805131415.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Parse("2022-03-08T03:01:14-07:00").ToString() // 2022-03-08 10:01:14 +0000 UTC
carbon.Parse("2022-03-08T10:01:14Z").ToString() // 2022-03-08 10:01:14 +0000 UTC
##### Разбор строки времени как экземпляр `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
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", "\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-м-d H:м:i:с").ToDateTimeString() // 2020-08-05 13:14:15
##### Парсинг строки времени как экземпляр `Carbon` по нескольким размытым макетам
> Примечание: поддержка парсинга по макетам временных меток не поддерживается
```go
carbon.ParseByLayouts("2020|08|05 13|14|15", []string{"2006|01|02 15|04|05", "2006|1|2 3|4|5"}).ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayouts("2020|08|05 13|14|15", []string{"2006|01|02 15|04|05", "2006|1|2 3|4|5"}).CurrentLayout() // 2006|01|02 15|04|05
Carbon по нескольким размытым форматамПримечание: поддержка парсинга по макетам временных меток не поддерживается
carbon.ParseByFormats("2020|08|05 13|14|15", []string{"Y|m|d H|i|s", "y|m|d h|i|s"}).ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormats("2020|08|05 13|14|15", []string{"Y|m|d H|i|s", "y|m|d h|i|s"}).CurrentLayout() // 2006|01|02 15|04|05
now := carbon.Parse("2020-08-05")
carbon.SetTestNow(now)
carbon.IsTestNow() // true
carbon.Now().ToDateString() // 2020-08-05
carbon.Yesterday().ToDateString() // 2020-08-04
carbon.Tomorrow().ToDateString() // 2020-08-06
carbon.Now().DiffForHumans() // только что
carbon.Yesterday().DiffForHumans() // вчера
carbon.Tomorrow().DiffForHumans() // завтра
carbon.Parse("2020-10-05").DiffForHumans() // через 2 месяца
now.DiffForHumans(carbon.Parse("2020-10-05")) // 2 месяца назад
carbon.ClearTestNow()
carbon.IsTestNow() // false
// Начало века carbon.Parse("2020-08-05 13:14:15").StartOfCentury().ToDateTimeString() // 2000-01-01 00:00:00 // Конец века carbon.Parse("2020-08-05 13:14:15").EndOfCentury().ToDateTimeString() // 2999-12-31 23:59:59
// Начало десятилетия 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 // Конец десятилетия 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
// Начало года carbon.Parse("2020-08-05 13:14:15").StartOfYear().ToDateTimeString() // 2020-01-01 00:00:00 // Конец года carbon.Parse("2020-08-05 13:14:15").EndOfYear().ToDateTimeString() // 2020-12-31 23:59:59
carbon.Parse("2020-08-05 13:14:15").StartOfQuarter().ToDateTimeString() // 2020-07-01 00:00:00
// Конец квартала
carbon.Parse("2020-08-05 13:14:15").EndOfQuarter().ToDateTimeString() // 2020-09-30 23:59:59
// Начало месяца
carbon.Parse("2020-08-05 13:14:15").StartOfMonth().ToDateTimeString() // 2020-08-01 00:00:00
// Конец месяца
carbon.Parse("2020-08-05 13:14:15").EndOfMonth().ToDateTimeString() // 2020-08-31 23:59:59
// Начало недели
carbon.Parse("2020-08-05 13:14:15").StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).StartOfWeek().ToDateTimeString() // 2020-08-02 00:00:00
carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).StartOfWeek().ToDateTimeString() // 2020-08-03 00:00:00
// Конец недели
carbon.Parse("2020-08-05 13:14:15").EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Sunday).EndOfWeek().ToDateTimeString() // 2020-08-08 23:59:59
carbon.Parse("2020-08-05 13:14:15").SetWeekStartsAt(carbon.Monday).EndOfWeek().ToDateTimeString() // 2020-08-09 23:59:59
// Начало дня
carbon.Parse("2020-08-05 13:14:15").StartOfDay().ToDateTimeString() // 2020-08-05 00:00:00
// Конец дня
carbon.Parse("2020-08-05 13:14:15").EndOfDay().ToDateTimeString() // 2020-08-05 23:59:59
// Начало часа
carbon.Parse("2020-08-05 13:14:15").StartOfHour().ToDateTimeString() // 2020-08-05 13:00:00
// Конец часа
carbon.Parse("2020-08-05 13:14:15").EndOfHour().ToDateTimeString() // 2020-08-05 13:59:59
// Начало минуты
carbon.Parse("2020-08-05 13:14:15").StartOfMinute().ToDateTimeString() // 2020-08-05 13:14:00
// Конец минуты
carbon.Parse("2020-08-05 13:14:15").EndOfMinute().ToDateTimeString() // 2020-08-05 13:14:59
// Начало секунды
carbon.Parse("2020-08-05 13:14:15").StartOfSecond().ToString() // 2020-08-05 13:14:15 +0000 UTC
// Конец секунды
carbon.Parse("2020-08-05 13:14:15").EndOfSecond().ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
```##### Путешественник```go
// Add three centuries
carbon.Parse("2020-02-29 13:14:15").AddCenturies(3).ToDateTimeString() // 2320-02-29 13:14:15
// Add three centuries without overflowing the month
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 without overflowing the month
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 without overflowing the month
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 without overflowing the month
carbon.Parse("2020-02-29 13:14:15").SubCenturyNoOverflow().ToDateTimeString() // 1920-02-20 13:14:15
```// Добавить три десятилетия
carbon. Parse("2020-02-29 13:14:15"). AddDecades(3). ToDateTimeString() // 2050-03-01 13:14:15
// Добавить три десятилетия без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). AddDecadesNoOverflow(3). ToDateTimeString() // 2050-02-28 13:14:15
// Добавить одно десятилетие
carbon. Parse("2020-02-29 13:14:15"). AddDecade(). ToDateTimeString() // 2030-03-01 13:14:15
// Добавить одно десятилетие без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). AddDecadeNoOverflow(). ToDateTimeString() // 2030-02-28 13:14:15
// Вычесть три десятилетия
carbon. Parse("2020-02-29 13:14:15"). SubDecades(3). ToDateTimeString() // 1990-03-01 13:14:15
// Вычесть три десятилетия без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). SubDecadesNoOverflow(3). ToDateTimeString() // 1990-02-28 13:14:15
// Вычесть одно десятилетие
carbon. Parse("2020-02-29 13:14:15"). SubDecade(). ToDateTimeString() // 2010-03-01 13:14:15
// Вычесть одно десятилетие без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). SubDecadeNoOverflow(). ToDateTimeString() // 2010-02-28 13:14:15
```// Добавить три года
carbon. Parse("2020-02-29 13:14:15"). AddYears(3). ToDateTimeString() // 2023-03-01 13:14:15
// Добавить три года без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). AddYearsNoOverflow(3). ToDateTimeString() // 2023-02-28 13:14:15
// Добавить один год
carbon. Parse("2020-02-29 13:14:15"). AddYear(). ToDateTimeString() // 2021-03-01 13:14:15
// Добавить один год без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). AddYearNoOverflow(). ToDateTimeString() // 2021-02-28 13:14:15
// Вычесть три года
carbon. Parse("2020-02-29 13:14:15"). SubYears(3). ToDateTimeString() // 2017-03-01 13:14:15
// Вычесть три года без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). SubYearsNoOverflow(3). ToDateTimeString() // 2017-02-28 13:14:15
// Вычесть один год
carbon. Parse("2020-02-29 13:14:15"). SubYear(). ToDateTimeString() // 2019-03-01 13:14:15
```// Вычесть один год без переполнения месяца
carbon. Parse("2020-02-29 13:14:15"). SubYearNoOverflow(). ToDateTimeString() // 2019-02-28 13:14:15
// Добавить три квартала
carbon. Parse("2019-05-31 13:14:15"). AddQuarters(3). ToDateTimeString() // 2020-03-02 13:14:15
// Добавить три квартала без переполнения месяца
carbon. Parse("2019-05-31 13:14:15"). AddQuartersNoOverflow(3). ToDateTimeString() // 2020-02-29 13:14:15
// Добавить один квартал
carbon. Parse("2019-11-30 13:14:15"). AddQuarter(). ToDateTimeString() // 2020-03-01 13:14:15
// Добавить один квартал без переполнения месяца
carbon. Parse("2019-11-30 13:14:15"). AddQuarterNoOverflow(). ToDateTimeString() // 2020-02-29 13:14:15
// Вычесть три квартала
carbon. Parse("2019-08-31 13:14:15"). SubQuarters(3). ToDateTimeString() // 2019-03-03 13:14:15
// Вычесть три квартала без переполнения месяца
carbon. Parse("2019-08-31 13:14:15"). SubQuartersNoOverflow(3). ToDateTimeString() // 2019-02-28 13:14:15
// Вычесть один квартал
carbon. Parse("2020-05-31 13:14:15"). SubQuarter(). ToDateTimeString() // 2020-03-02 13:14:15
// Вычесть один квартал без переполнения месяца
carbon. Parse("2020-05-31 13:14:15"). SubQuarterNoOverflow(). ToDateTimeString() // 2020-02-29 13:14:15// Добавить три месяца
carbon.Parse("2020-02-29 13:14:15").AddMonths(3).ToDateTimeString() // 2020-05-29 13:14:15
// Добавить три месяца без переполнения месяца
carbon.Parse("2020-02-29 13:14:15").AddMonthsNoOverflow(3).ToDateTimeString() // 2020-05-29 13:14:15
// Добавить один месяц
carbon.Parse("2020-01-31 13:14:15").AddMonth().ToDateTimeString() // 2020-03-02 13:14:15
// Добавить один месяц без переполнения месяца
carbon.Parse("2020-01-31 13:14:15").AddMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
// Вычесть три месяца
carbon.Parse("2020-02-29 13:14:15").SubMonths(3).ToDateTimeString() // 2019-11-29 13:14:15
// Вычесть три месяца без переполнения месяца
carbon.Parse("2020-02-29 13:14:15").SubMonthsNoOverflow(3).ToDateTimeString() // 2019-11-29 13:14:15
// Вычесть один месяц
carbon.Parse("2020-03-31 13:14:15").SubMonth().ToDateTimeString() // 2020-02-29 13:14:15
// Вычесть один месяц без переполнения месяца
carbon.Parse("2020-03-31 13:14:15").SubMonthNoOverflow().ToDateTimeString() // 2020-02-29 13:14:15
// Добавить три недели
carbon.Parse("2020-02-29 13:14:15").AddWeeks(3).ToDateTimeString() // 2020-03-21 13:14:15
// Добавить одну неделю
carbon.Parse("2020-02-29 13:14:15").AddWeek().ToDateTimeString() // 2020-03-07 13:14:15
// Вычесть три недели
carbon.Parse("2020-02-29 13:14:15").SubWeeks(3).ToDateTimeString() // 2020-02-08 13:14:15
// Вычесть одну неделю
carbon.Parse("2020-02-29 13:14:15").SubWeek().ToDateTimeString() // 2020-02-22 13:14:15
// Добавить три дня
carbon.Parse("2020-08-05 13:14:15").AddDays(3).ToDateTimeString() // 2020-08-08 13:14:15
// Добавить один день
carbon.Parse("2020-08-05 13:14:15").AddDay().ToDateTimeString() // 2020-08-06 13:14:15
// Вычесть три дня
carbon.Parse("2020-08-05 13:14:15").SubDays(3).ToDateTimeString() // 2020-08-02 13:14:15
// Вычесть один день
carbon.Parse("2020-08-05 13:14:15").SubDay().ToDateTimeString() // 2020-08-04 13:14:15// Добавить три часа
carbon.Parse("2020-08-05 13:14:15").AddHours(3).ToDateTimeString() // 2020-08-05 16:14:15
// Добавить два с половиной часа
carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5h").ToDateTimeString() // 2020-08-05 15:44:15
carbon.Parse("2020-08-05 13:14:15").AddDuration("2h30m").ToDateTimeString() // 2020-08-05 15:44:15
// Добавить один час
carbon.Parse("2020-08-05 13:14:15").AddHour().ToDateTimeString() // 2020-08-05 14:14:15
// Вычесть три часа
carbon.Parse("2020-08-05 13:14:15").SubHours(3).ToDateTimeString() // 2020-08-05 10:14:15
// Вычесть два с половиной часа
carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5h").ToDateTimeString() // 2020-08-05 10:44:15
carbon.Parse("2020-08-05 13:14:15").SubDuration("2h30m").ToDateTimeString() // 2020-08-05 10:44:15
// Вычесть один час
carbon.Parse("2020-08-05 13:14:15").SubHour().ToDateTimeString() // 2020-08-05 12:14:15// Добавить три минуты
carbon.Parse("2020-08-05 13:14:15").AddMinutes(3).ToDateTimeString() // 2020-08-05 13:17:15
// Добавить два с половиной минуты
carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5m").ToDateTimeString() // 2020-08-05 13:16:45
carbon.Parse("2020-08-05 13:14:15").AddDuration("2m30s").ToDateTimeString() // 2020-08-05 13:16:45
// Добавить одну минуту
carbon.Parse("2020-08-05 13:14:15").AddMinute().ToDateTimeString() // 2020-08-05 13:15:15
// Вычесть три минуты
carbon.Parse("2020-08-05 13:14:15").SubMinutes(3).ToDateTimeString() // 2020-08-05 13:11:15
// Вычесть два с половиной минуты
carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5m").ToDateTimeString() // 2020-08-05 13:11:45
// Вычесть одну минуту
carbon.Parse("2020-08-05 13:14:15").SubMinute().ToDateTimeString() // 2020-08-05 13:13:15
// Добавить три секунды
carbon.Parse("2020-08-05 13:14:15").AddSeconds(3).ToDateTimeString() // 2020-08-05 13:14:18
// Добавить две с половиной секунды
carbon.Parse("2020-08-05 13:14:15").AddDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:17
// Добавить одну секунду
carbon.Parse("2020-08-05 13:14:15").AddSecond().ToDateTimeString() // 2020-08-05 13:14:16
// Вычесть три секунды
carbon.Parse("2020-08-05 13:14:15").SubSeconds(3).ToDateTimeString() // 2020-08-05 13:14:12
// Вычесть две с половиной секунды
carbon.Parse("2020-08-05 13:14:15").SubDuration("2.5s").ToDateTimeString() // 2020-08-05 13:14:12
// Вычесть одну секунду
carbon.Parse("2020-08-05 13:14:15").SubSecond().ToDateTimeString() // 2020-08-05 13:14:14
```md
// Добавить три миллисекунды
carbon.Parse("2020-08-05 13:14:15.222222222").AddMilliseconds(3).ToString() // 2020-08-05 13:14:15.225222222 +0000 UTC
// Добавить одну миллисекунду
carbon.Parse("2020-08-05 13:14:15.222222222").AddMillisecond().ToString() // 2020-08-05 13:14:15.223222222 +0000 UTC
// Вычесть три миллисекунды
carbon.Parse("2020-08-05 13:14:15.222222222").SubMilliseconds(3).ToString() // 2020-08-05 13:14:15.219222222 +0000 UTC
// Вычесть одну миллисекунду
carbon.Parse("2020-08-05 13:14:15.222222222").SubMillisecond().ToString() // 2020-08-05 13:14:15.221222222 +0000 UTC
``````markdown
// Добавить три микросекунды
carbon.Parse("2020-08-05 13:14:15.222222222").AddMicroseconds(3).ToString() // 2020-08-05 13:14:15.222225222 +0000 UTC
// Добавить одну микросекунду
carbon.Parse("2020-08-05 13:14:15.222222222").AddMicrosecond().ToString() // 2020-08-05 13:14:15.222223222 +0000 UTC
// Вычесть три микросекунды
carbon.Parse("2020-08-05 13:14:15.222222222").SubMicroseconds(3).ToString() // 2020-08-05 13:14:15.222219222 +0000 UTC
// Вычесть одну микросекунду
carbon.Parse("2020-08-05 13:14:15.222222222").SubMicrosecond().ToString() // 2020-08-05 13:14:15.222221222 +0000 UTC
// Добавить три наносекунды
carbon.Parse("2020-08-05 13:14:15.222222222").AddNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222225 +0000 UTC
// Добавить одну наносекунду
carbon.Parse("2020-08-05 13:14:15.222222222").AddNanosecond().ToString() // 2020-08-05 13:14:15.222222223 +0000 UTC
// Вычесть три наносекунды
carbon.Parse("2020-08-05 13:14:15.222222222").SubNanoseconds(3).ToString() // 2020-08-05 13:14:15.222222219 +0000 UTC
// Вычесть одну наносекунду
carbon.Parse("2020-08-05 13:14:15.222222222").SubNanosecond().ToString() // 2020-08-05 13:14:15.222222221 +0000 UTC
// Разница в годах
carbon.Parse("2021-08-05 13:14:15").DiffInYears(carbon.Parse("2020-08-05 13:14:15")) // -1
// Разница в годах с абсолютным значением
carbon.Parse("2021-08-05 13:14:15").DiffAbsInYears(carbon.Parse("2020-08-05 13:14:15")) // 1
// Разница в месяцах
carbon.Parse("2020-08-05 13:14:15").DiffInMonths(carbon.Parse("2020-07-05 13:14:15")) // -1
// Разница в месяцах с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInMonths(carbon.Parse("2020-07-05 13:14:15")) // 1
// Разница в неделях
carbon.Parse("2020-08-05 13:14:15").DiffInWeeks(carbon.Parse("2020-07-28 13:14:15")) // -1
// Разница в неделях с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInWeeks(carbon.Parse("2020-07-28 13:14:15")) // 1
```// Разница в днях
carbon.Parse("2020-08-05 13:14:15").DiffInDays(carbon.Parse("2020-08-04 13:14:15")) // 1
// Разница в днях с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInDays(carbon.Parse("2020-08-04 13:14:15")) // 1
// Разница в часах
carbon.Parse("2020-08-05 13:14:15").DiffInHours(carbon.Parse("2020-08-05 12:14:15")) // 1
// Разница в часах с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInHours(carbon.Parse("2020-08-05 12:14:15")) // 1
// Разница в минутах
carbon.Parse("2020-08-05 13:14:15").DiffInMinutes(carbon.Parse("2020-08-05 13:13:15")) // 1
// Разница в минутах с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInMinutes(carbon.Parse("2020-08-05 13:13:15")) // 1
// Разница в секундах
carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14:14")) // 1
// Разница в секундах с абсолютным значением
carbon.Parse("2020-08-05 13:14:15").DiffAbsInSeconds(carbon.Parse("2020-08-05 13:14:14")) // 1
// Разница в строке
carbon.Now().DiffInString() // сейчас
carbon.Now().AddYearsNoOverflow(1).DiffInString() // 1 год
carbon.Now().SubYearsNoOverflow(1).DiffInString() // -1 год
// Разница в строке с абсолютным значением
carbon.Now().DiffAbsInString(carbon.Now()) // сейчас
carbon.Now().AddYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 год
carbon.Now().SubYearsNoOverflow(1).DiffAbsInString(carbon.Now()) // 1 год// Разница в продолжительности
now := carbon.Now()
now.DiffInDuration(now).String() // 0s
now.Copy().AddHour().DiffInDuration(now).String() // 1h0m0s
now.Copy().SubHour().DiffInDuration(now).String() // -1h0m0s
// Разница в продолжительности с абсолютным значением
now.DiffAbsInDuration(now).String() // 0s
now.Copy().AddHour().DiffAbsInDuration(now).String() // 1h0m0s
now.Copy().SubHour().DiffAbsInDuration(now).String() // 1h0m0s
// Разница в человекочитаемом формате
carbon.Parse("2020-08-05 13:14:15").DiffForHumans() // только что
carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // год назад
carbon.Parse("2018-08-05 13:14:15").DiffForHumans() // 2 года назад
carbon.Parse("2021-08-05 13:14:15").DiffForHumans() // через год
carbon.Parse("2022-08-05 13:14:15").DiffForHumans() // через 2 года
// Разница в человекочитаемом формате от текущего времени
carbon.Parse("2020-08-05 13:14:15").DiffForHumans(carbon.Now()) // год назад
carbon.Parse("2019-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 года назад
carbon.Parse("2018-08-05 13:14:15").DiffForHumans(carbon.Now()) // год вперед
carbon.Parse("2022-08-05 13:14:15").DiffForHumans(carbon.Now()) // 2 года вперед
```##### Экстремум``````go
c1 := carbon.Parse("2023-03-28")
c2 := carbon.Parse("2023-04-16")
// Возвращает ближайший Carbon объект
carbon.Parse("2023-04-01").Closest(c1, c2) // c1
// Возвращает наиболее удалённый Carbon объект
carbon.Parse("2023-04-01").Farthest(c1, c2) // c2
вчера := carbon.Yesterday()
сегодня := carbon.Now()
завтра := carbon.Tomorrow()
// Возвращает максимальный Carbon объект
carbon.Max(вчера, сегодня, завтра) // завтра
// Возвращает минимальный Carbon объект
carbon.Min(вчера, сегодня, завтра) // вчера
// Возвращает Carbon объект для наибольшей поддерживаемой даты
carbon.MaxValue().ToString() // 9999-12-31 23:59:59.999999999 +0000 UTC
// Возвращает Carbon объект для наименьшей поддерживаемой даты
carbon.MinValue().ToString() // 0001-01-01 00:00:00 +0000 UTC
// Возвращает максимальную продолжительность
carbon.MaxDuration().Seconds() // 9223372036854.776
// Возвращает минимальную продолжительность
carbon.MinDuration().Seconds() // -9223372036854.776
// Проверяет наличие ошибки
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").HasError() // false
carbon.NewCarbon().HasError() // false
carbon.Parse("").HasError() // false
carbon.Parse("0").HasError() // true
carbon.Parse("xxx").HasError() // true
carbon.Parse("2020-08-05").HasError() // false
carbon.CreateFromTimestamp(0).HasError() // false
// Проверяет, является ли время nil
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsNil() // false
carbon.NewCarbon().IsNil() // false
carbon.Parse("").IsNil() // true
carbon.Parse("0").IsNil() // false
carbon.Parse("xxx").IsNil() // false
carbon.NewCarbon().IsNil() // false
carbon.CreateFromTimestamp(0).IsNil() // false
```// Проверяет, является ли время нулевым (0001-01-01 00:00:00 +0000 UTC)
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsZero() // true
carbon.NewCarbon().IsZero() // true
carbon.CreateFromTimestamp(0).IsZero() // false
carbon.Parse("").IsZero() // false
carbon.Parse("xxx").IsZero() // false
carbon.Parse("0").IsZero() // false
carbon.Parse("0000-00-00 00:00:00").IsZero() // false
carbon.Parse("0000-00-00").IsZero() // false
carbon.Parse("00:00:00").IsZero() // false
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
```// Проверка на пустое время
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsEmpty() // true
carbon.NewCarbon().IsEmpty() // false
carbon.CreateFromTimestamp(0).IsEmpty() // false
carbon.Parse("").IsEmpty() // true
carbon.Parse("xxx").IsEmpty() // false
carbon.Parse("0").IsEmpty() // false
carbon.Parse("0000-00-00 00:00:00").IsEmpty() // false
carbon.Parse("0000-00-00").IsEmpty() // false
carbon.Parse("00:00:00").IsEmpty() // false
carbon.Parse("2020-08-05 00:00:00").IsEmpty() // false
carbon.Parse("2020-08-05").IsEmpty() // false
carbon.Parse("2020-08-05").SetTimezone("xxx").IsEmpty() // false
```// Проверка на время эпохи Unix (1 января 1970, 00:00:00 +0000 UTC).
carbon.Parse("1970-01-01 00:00:00 +0000 UTC").IsEpoch() // true
carbon.CreateFromTimestamp(0).IsEpoch() // true
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsEpoch() // false
carbon.NewCarbon().IsEpoch() // false
carbon.Parse("").IsEpoch() // false
carbon.Parse("0").IsEpoch() // false
carbon.Parse("xxx").IsEpoch() // false
carbon.Parse("0000-00-00 00:00:00").IsEpoch() // false
carbon.Parse("0000-00-00").IsEpoch() // false
carbon.Parse("00:00:00").IsEpoch() // false
carbon.Parse("2020-08-05 00:00:00").IsEpoch() // false
carbon.Parse("2020-08-05").IsEpoch() // false
carbon.Parse("2020-08-05").SetTimezone("xxx").IsEpoch() // false
// Проверка на корректное время
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsValid()
carbon.CreateFromTimestamp(0).IsValid() // true
carbon.NewCarbon().IsValid() // true
carbon.Parse("").IsValid() // false
carbon.Parse("0").IsValid() // false
carbon.Parse("xxx").IsValid() // false
carbon.Parse("0000-00-00 00:00:00").IsValid() // false
carbon.Parse("0000-00-00").IsValid() // false
carbon.Parse("00:00:00").IsValid() // false
carbon.Parse("2020-08-05 00:00:00").IsValid() // true
carbon.Parse("2020-08-05").IsValid() // true
carbon.Parse("2020-08-05").SetTimezone("xxx").IsValid() // false
// Является ли недопустимым временем
carbon.Parse("0001-01-01 00:00:00 +0000 UTC").IsInvalid() // false
carbon.CreateFromTimestamp(0).IsInvalid() // false
carbon.NewCarbon().IsInvalid() // false
carbon.Parse("").IsInvalid() // true
carbon.Parse("0").IsInvalid() // true
carbon.Parse("xxx").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
// Время с переведением на летнее время
carbon.Parse("").IsDST() // false
carbon.Parse("0").IsDST() // false
carbon.Parse("xxx").IsDST() // false
carbon.Parse("0000-00-00 00:00:00").IsDST() // false
carbon.Parse("0000-00-00").IsDST() // false
carbon.Parse("00:00:00").IsDST() // false
carbon.Parse("2023-01-01", "Australia/Brisbane").IsDST() // false
carbon.Parse("2023-01-01", "Australia/Sydney").IsDST() // true// Утреннее время
carbon.Parse("2020-08-05 00:00:00").IsAM() // true
carbon.Parse("2020-08-05 08:00:00").IsAM() // true
carbon.Parse("2020-08-05 12:00:00").IsAM() // false
carbon.Parse("2020-08-05 13:00:00").IsAM() // false
// Дневное время
carbon.Parse("2020-08-05 00:00:00").IsPM() // false
carbon.Parse("2020-08-05 08:00:00").IsPM() // false
carbon.Parse("2020-08-05 12:00:00").IsPM() // true
carbon.Parse("2020-08-05 13:00:00").IsPM() // true
// Текущее время
carbon.Now().IsNow() // true
// Будущее время
carbon.Tomorrow().IsFuture() // true
// Прошлое время
carbon.Yesterday().IsPast() // true
// Високосный год
carbon.Parse("2020-08-05 13:14:15").IsLeapYear() // true
// Долгий год
carbon.Parse("2020-08-05 13:14:15").IsLongYear() // true// Месяц январь
carbon.Parse("2020-08-05 13:14:15").IsJanuary() // false
// Месяц февраль
carbon.Parse("2020-08-05 13:14:15").IsFebruary() // false
// Месяц март
carbon.Parse("2020-08-05 13:14:15").IsMarch() // false
// Месяц апрель
carbon.Parse("2020-08-05 13:14:15").IsApril() // false
// Месяц май
carbon.Parse("2020-08-05 13:14:15").IsMay() // false
// Месяц июнь
carbon.Parse("2020-08-05 13:14:15").IsJune() // false
// Месяц июль
carbon.Parse("2020-08-05 13:14:15").IsJuly() // false
// Месяц август
carbon.Parse("2020-08-05 13:14:15").IsAugust() // false
// Месяц сентябрь
carbon.Parse("2020-08-05 13:14:15").IsSeptember() // true
// Месяц октябрь
carbon.Parse("2020-08-05 13:14:15").IsOctober() // false
// Месяц ноябрь
carbon.Parse("2020-08-05 13:14:15").IsNovember() // false
// Месяц декабрь
carbon.Parse("2020-08-05 13:14:15").IsDecember() // false
// Является ли понедельником
carbon.Parse("2020-08-05 13:14:15").IsMonday() // false
// Является ли вторником
carbon.Parse("2020-08-05 13:14:15").IsTuesday() // true
// Является ли средой
carbon.Parse("2020-08-05 13:14:15").IsWednesday() // false
// Является ли четвергом
carbon.Parse("2020-08-05 13:14:15").IsThursday() // false
// Является ли пятницей
carbon.Parse("2020-08-05 13:14:15").IsFriday() // false
// Является ли субботой
carbon.Parse("2020-08-05 13:14:15").IsSaturday() // false
// Является ли воскресеньем
carbon.Parse("2020-08-05 13:14:15").IsSunday() // false
// Является ли рабочим днём
carbon.Parse("2020-08-05 13:14:15").IsWeekday() // false
// Является ли выходным днём
carbon.Parse("2020-08-05 13:14:15").IsWeekend() // true
// Это вчерашний день
carbon.Parse("2020-08-04 13:14:15").IsYesterday() // true
carbon.Parse("2020-08-04 00:00:00").IsYesterday() // true
carbon.Parse("2020-08-04").IsYesterday() // true
// Это сегодняшний день
carbon.Parse("2020-08-05 13:14:15").IsToday() // true
carbon.Parse("2020-08-05 00:00:00").IsToday() // true
carbon.Parse("2020-08-05").IsToday() // true
// Это завтрашний день
carbon.Parse("2020-08-06 13:14:15").IsTomorrow() //IsTomorrow() // true
carbon.Parse("2020-08-06 00:00:00").IsTomorrow() // true
carbon.Parse("2020-08-06").IsTomorrow() // true// Это одинаковый век
carbon.Parse("2020-08-05 13:14:15").IsSameCentury(carbon.Parse("3020-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").IsSameCentury(carbon.Parse("2099-08-05 13:14:15")) // true
// Это одинаковое десятилетие
carbon.Parse("2020-08-05 13:14:15").IsSameDecade(carbon.Parse("2030-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").IsSameDecade(carbon.Parse("2120-08-05 13:14:15")) // true
// Это одинаковый год
carbon.Parse("2020-08-05 00:00:00").IsSameYear(carbon.Parse("2021-08-05 13:14:15")) // false
carbon.Parse("2020-01-01 00:00:00").IsSameYear(carbon.Parse("2020-12-31 13:14:15")) // true
// Это одинаковый квартал
carbon.Parse("2020-08-05 00:00:00").IsSameQuarter(carbon.Parse("2020-09-05 13:14:15")) // false
carbon.Parse("2020-01-01 00:00:00").IsSameQuarter(carbon.Parse("2021-01-31 13:14:15")) // true
// Это одинаковый месяц
carbon.Parse("2020-01-01 00:00:00").IsSameMonth(carbon.Parse("2021-01-31 13:14:15")) // false
carbon.Parse("2020-01-01 00:00:00").IsSameMonth(carbon.Parse("2020-01-31 13:14:15")) // true
// Это одинаковый день
carbon.Parse("2020-08-05 13:14:15").IsSameDay(carbon.Parse("2021-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 00:00:00").IsSameDay(carbon.Parse("2020-08-05 13:14:15")) // true
// Это одинаковый час
carbon.Parse("2020-08-05 13:14:15").IsSameHour(carbon.Parse("2021-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:00:00").IsSameHour(carbon.Parse("2020-08-05 13:14:15")) // true
// Это одинаковая минута
carbon.Parse("2020-08-05 13:14:15").IsSameMinute(carbon.Parse("2021-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:00").IsSameMinute(carbon.Parse("2020-08-05 13:14:15")) // true
// Это одинаковая секунда
carbon.Parse("2020-08-05 13:14:15").IsSameSecond(carbon.Parse("2021-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").IsSameSecond(carbon.Parse("2020-08-05 13:14:15")) // true
// Больше ли
carbon.Parse("2020-08-05 13:14:15").Gt(carbon.Parse("2020-08-04 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Gt(carbon.Parse("2020-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").Compare(">", carbon.Parse("2020-08-04 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare(">", carbon.Parse("2020-08-05 13:14:15")) // false// Меньше ли
carbon.Parse("2020-08-05 13:14:15").Lt(carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Lt(carbon.Parse("2020-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").Compare("<", carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare("<", carbon.Parse("2020-08-05 13:14:15")) // false
// Равно ли
carbon.Parse("2020-08-05 13:14:15").Eq(carbon.Parse("2020-08-05 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Eq(carbon.Parse("2020-08-05 13:14:00")) // false
carbon.Parse("2020-08-05 13:14:15").Compare("=", carbon.Parse("2020-08-05 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare("=", carbon.Parse("2020-08-05 13:14:00")) // false
// Не равно ли
carbon.Parse("2020-08-05 13:14:15").Ne(carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Ne(carbon.Parse("2020-08-05 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").Compare("!=", carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare("<>", carbon.Parse("2020-08-05 13:14:15")) // false
// Больше ли или равно
carbon.Parse("2020-08-05 13:14:15").Gte(carbon.Parse("2020-08-04 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Gte(carbon.Parse("2020-08-05 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare(">=", carbon.Parse("2020-08-04 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare(">=", carbon.Parse("2020-08-05 13:14:15")) // true
// Меньше ли или равно
carbon.Parse("2020-08-05 13:14:15").Lte(carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Lte(carbon.Parse("2020-08-05 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare("<=", carbon.Parse("2020-08-06 13:14:15")) // true
carbon.Parse("2020-08-05 13:14:15").Compare("<=", carbon.Parse("2020-08-05 13:14:15")) // true
// Определяет, находится ли Carbon-объект между двумя другими Carbon-объектами, исключая начальный и конечный Carbon-объект
carbon.Parse("2020-08-05 13:14:15").Between(carbon.Parse("2020-08-05 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // false
carbon.Parse("2020-08-05 13:14:15").Between(carbon.Parse("2020-08-04 13:14:15"), carbon.Parse("2020-08-06 13:14:15")) // true// Определяет, находится ли Carbon-объект между двумя другими Carbon-объектами, включая начальный Carbon-объект
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
// Определяет, находится ли Carbon-объект между двумя другими Carbon-объектами, включая конечный Carbon-объект
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
// Определяет, находится ли Carbon-объект между двумя другими Carbon-объектами, включая начальный и конечный Carbon-объект
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
См. https://en.wikipedia.org/wiki/ISO_8601#Week_dates для определения длинного года
// Установка часового пояса
carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToString() // 2020-08-05 21:14:15 +0800 CST
carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
```// Установка местоположения
utc, _ := time.LoadLocation(carbon.UTC)
carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToString() // 2020-08-05 13:14:15 +0000 UTC
prc, _ := time.LoadLocation(carbon.PRC)
carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToString() // 2020-08-05 21:14:15 +0800 CST
tokyo, _ := time.LoadLocation(carbon.Tokyo)
carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
```// Установка локали
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 месяц назад```// Установка года, месяца, дня, часа, минуты и секунды
carbon.Parse("2020-01-01").SetDateTime(2019, 2, 2, 13, 14, 15).ToString() // 2019-02-02 13:14:15 +0000 UTC
carbon.Parse("2020-01-01").SetDateTime(2019, 2, 31, 13, 14, 15).ToString() // 2019-03-03 13:14:15 +0000 UTC
// Установка года, месяца, дня, часа, минуты, секунды и миллисекунды
carbon.Parse("2020-01-01").SetDateTimeMilli(2019, 2, 2, 13, 14, 15, 999).ToString() // 2019-02-02 13:14:15.999 +0000 UTC
carbon.Parse("2020-01-01").SetDateTimeMilli(2019, 2, 31, 13, 14, 15, 999).ToString() // 2019-03-03 13:14:15.999 +0000 UTC
// Установка года, месяца, дня, часа, минуты, секунды и микросекунды
carbon.Parse("2020-01-01").SetDateTimeMicro(2019, 2, 2, 13, 14, 15, 999999).ToString() // 2019-02-02 13:14:15.999999 +0000 UTC
carbon.Parse("2020-01-01").SetDateTimeMicro(2019, 2, 31, 13, 14, 15, 999999).ToString() // 2019-03-03 13:14:15.999999 +0000 UTC
// Установка года, месяца, дня, часа, минуты, секунды и наносекунды
carbon.Parse("2020-01-01").SetDateTimeNano(2019, 2, 2, 13, 14, 15, 999999999).ToString() // 2019-02-02 13:14:15.999999999 +0000 UTC
carbon.Parse("2020-01-01").SetDateTimeNano(2019, 2, 31, 13, 14, 15, 999999999).ToString() // 2019-03-03 13:14:15.999999999 +0000 UTC// Установка года, месяца и дня
carbon.Parse("2020-01-01").SetDate(2019, 2, 2).ToString() // 2019-02-02 00:00:00 +0000 UTC
carbon.Parse("2020-01-01").SetDate(2019, 2, 31).ToString() // 2019-03-03 00:00:00 +0000 UTC
// Установка года, месяца, дня и миллисекунды
carbon.Parse("2020-01-01").SetDateMilli(2019, 2, 2, 999).ToString() // 2019-02-02 00:00:00.999 +0000 UTC
carbon.Parse("2020-01-01").SetDateMilli(2019, 2, 31, 999).ToString() // 2019-03-03 00:00:00.999 +0000 UTC
// Установка года, месяца, дня и микросекунды
carbon.Parse("2020-01-01").SetDateMicro(2019, 2, 2, 999999).ToString() // 2019-02-02 00:00:00.999999 +0000 UTC
carbon.Parse("2020-01-01").SetDateMicro(2019, 2, 31, 999999).ToString() // 2019-03-03 00:00:00.999999 +0000 UTC
// Установка года, месяца, дня и наносекунды
carbon.Parse("2020-01-01").SetDateNano(2019, 2, 2, 999999999).ToString() // 2019-02-02 00:00:00.999999999 +0000 UTC
carbon.Parse("2020-01-01").SetDateNano(2019, 2, 31, 999999999).ToString() // 2019-03-03 00:00:00.999999999 +0000 UTC
// Установка часа, минуты и секунды
carbon.Parse("2020-01-01").SetTime(13, 14, 15).ToString() // 2020-01-01 13:14:15 +0000 UTC
carbon.Parse("2020-01-01").SetTime(13, 14, 90).ToString() // 2020-01-01 13:15:30 +0000 UTC
// Установка часа, минуты, секунды и миллисекунды
carbon.Parse("2020-01-01").SetTimeMilli(13, 14, 15, 999).ToString() // 2020-01-01 13:14:15.999 +0000 UTC
carbon.Parse("2020-01-01").SetTimeMilli(13, 14, 90, 999).ToString() // 2020-01-01 13:15:30.999 +0000 UTC
// Установка часа, минуты, секунды и микросекунды
carbon.Parse("2020-01-01").SetTimeMicro(13, 14, 15, 999999).ToString() // 2020-01-01 13:14:15.999999 +0000 UTC
carbon.Parse("2020-01-01").SetTimeMicro(13, 14, 90, 999999).ToString() // 2020-01-01 13:15:30.999999 +0000 UTC
// Установка часа, минуты, секунды и наносекунды
carbon.Parse("2020-01-01").SetTimeNano(13, 14, 15, 999999999).ToString() // 2020-01-01 13:14:15.999999999 +0000 UTC
carbon.Parse("2020-01-01").SetTimeNano(13, 14, 90, 999999999).ToString() // 2020-01-01 13:15:30.999999999 +0000 UTC// Установка года
carbon.Parse("2020-02-29").SetYear(2021).ToDateString() // 2021-03-01
// Установка года без переполнения месяца
carbon.Parse("2020-02-29").SetYearNoOverflow(2021).ToDateString() // 2021-02-28
// Установка месяца
carbon.Parse("2020-01-31").SetMonth(2).ToDateString() // 2020-03-02
// Установка месяца без переполнения месяца
carbon.Parse("2020-01-31").SetMonthNoOverflow(2).ToDateString() // 2020-02-29
// Установка дня начала недели
carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Sunday).Week() // 0
carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Monday).Week() // 6
// Установка выходных дней недели
wd := []carbon.Weekday{
carbon.Saturday, carbon.Sunday,
}
carbon.Parse("2025-04-11").SetWeekendDays(wd).IsWeekend() // false
carbon.Parse("2025-04-12").SetWeekendDays(wd).IsWeekend() // true
carbon.Parse("2025-04-13").SetWeekendDays(wd).IsWeekend() // true
// Установка дня
carbon.Parse("2019-08-05").SetDay(31).ToDateString() // 2020-08-31
carbon.Parse("2020-02-01").SetDay(31).ToDateString() // 2020-03-02
// Установка часа
carbon.Parse("2020-08-05 13:14:15").SetHour(10).ToDateTimeString() // 2020-08-05 10:14:15
carbon.Parse("2020-08-05 13:14:15").SetHour(24).ToDateTimeString() // 2020-08-06 00:14:15
// Установка минуты
carbon.Parse("2020-08-05 13:14:15").SetMinute(10).ToDateTimeString() // 2020-08-05 13:10:15
carbon.Parse("2020-08-05 13:14:15").SetMinute(60).ToDateTimeString() // 2020-08-05 14:00:15
// Установка секунды
carbon.Parse("2020-08-05 13:14:15").SetSecond(10).ToDateTimeString() // 2020-08-05 13:14:10
carbon.Parse("2020-08-05 13:14:15").SetSecond(60).ToDateTimeString() // 2020-08-05 13:15:00
// Установка миллисекунды
carbon.Parse("2020-08-05 13:14:15").SetMillisecond(100).Millisecond() // 100
carbon.Parse("2020-08-05 13:14:15").SetMillisecond(999).Millisecond() // 999
// Установка микросекунды
carbon.Parse("2020-08-05 13:14:15").SetMicrosecond(100000).Microsecond() // 100000
carbon.Parse("2020-08-05 13:14:15").SetMicrosecond(999999).Microsecond() // 999999// Установка наносекунд
carbon.Parse("2020-08-05 13:14:15").SetNanosecond(100000000).Nanosecond() // 100000000
carbon.Parse("2020-08-05 13:14:15").SetNanosecond(999999999).Nanosecond() // 999999999
// Получение общего количества дней в году
carbon.Parse("2019-08-05 13:14:15").DaysInYear() // 365
carbon.Parse("2020-08-05 13:14:15").DaysInYear() // 366
// Получение общего количества дней в месяце
carbon.Parse("2020-02-01 13:14:15").DaysInMonth() // 29
carbon.Parse("2020-04-01 13:14:15").DaysInMonth() // 30
carbon.Parse("2020-08-01 13:14:15").DaysInMonth() // 31
// Получение дня в году
carbon.Parse("2020-08-05 13:14:15").DayOfYear() // 218
// Получение недели в году
carbon.Parse("2020-08-05 13:14:15").WeekOfYear() // 32
// Получение дня в месяце
carbon.Parse("2020-08-05 13:14:15").DayOfMonth() // 5
// Получение недели в месяце
carbon.Parse("2020-08-05 13:14:15").WeekOfMonth() // 1
// Получение дня недели
carbon.Parse("2020-08-05 13:14:15").DayOfWeek() // 3
```// Получение текущего года, месяца, дня, часа, минуты и секунды
carbon.Parse("2020-08-05 13:14:15").DateTime() // 2020, 8, 5, 13, 14, 15
// Получение текущего года, месяца, дня, часа, минуты, секунды и миллисекунды
carbon.Parse("2020-08-05 13:14:15").DateTimeMilli() // 2020, 8, 5, 13, 14, 15, 999
// Получение текущего года, месяца, дня, часа, минуты, секунды и микросекунды
carbon.Parse("2020-08-05 13:14:15").DateTimeMicro() // 2020, 8, 5, 13, 14, 15, 999999
// Получение текущего года, месяца, дня, часа, минуты, секунды и наносекунды
carbon.Parse("2020-08-05 13:14:15").DateTimeNano() // 2020, 8, 5, 13, 14, 15, 999999999
// Получение текущего года, месяца и дня
carbon.Parse("2020-08-05 13:14:15.999999999").Date() // 2020, 8, 5
// Получение текущего года, месяца, дня и миллисекунды
carbon.Parse("2020-08-05 13:14:15.999999999").DateMilli() // 2020, 8, 5, 999
// Получение текущего года, месяца, дня и микросекунды
carbon.Parse("2020-08-05 13:14:15.999999999").DateMicro() // 2020, 8, 5, 999999
// Получение текущего года, месяца, дня и наносекунды
carbon.Parse("2020-08-05 13:14:15.999999999").DateNano() // 2020, 8, 5, 999999999
// Получение текущего часа, минуты и секунды
carbon.Parse("2020-08-05 13:14:15.999999999").Time() // 13, 14, 15
// Получение текущего часа, минуты, секунды и миллисекунды
carbon.Parse("2020-08-05 13:14:15.999999999").TimeMilli() // 13, 14, 15, 999
// Получение текущего часа, минуты, секунды и микросекунды
carbon.Parse("2020-08-05 13:14:15.999999999").TimeMicro() // 13, 14, 15, 999999
// Получение текущего часа, минуты, секунды и наносекунды
carbon.Parse("2020-08-05 13:14:15.999999999").TimeNano() // 13, 14, 15, 999999999// Получение текущего века
carbon.Parse("2020-08-05 13:14:15").Century() // 21
// Получение текущего десятилетия
carbon.Parse("2019-08-05 13:14:15").Decade() // 10
carbon.Parse("2021-08-05 13:14:15").Decade() // 20
// Получение текущего года
carbon.Parse("2020-08-05 13:14:15").Year() // 2020
// Получение текущего квартала
carbon.Parse("2020-08-05 13:14:15").Quarter() // 3
// Получение текущего месяца
carbon.Parse("2020-08-05 13:14:15").Month() // 8
// Получение текущей недели (начинается с 0)
carbon.Parse("2020-08-02 13:14:15").Week() // 0
carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Sunday).Week() // 0
carbon.Parse("2020-08-02").SetWeekStartsAt(carbon.Monday).Week() // 6
// Получение текущего дня
carbon.Parse("2020-08-05 13:14:15").Day() // 5
// Получение текущего часа
carbon.Parse("2020-08-05 13:14:15").Hour() // 13
// Получение текущей минуты
carbon.Parse("2020-08-05 13:14:15").Minute() // 14
// Получение текущей секунды
carbon.Parse("2020-08-05 13:14:15").Second() // 15
// Получение текущей миллисекунды
carbon.Parse("2020-08-05 13:14:15.999").Millisecond() // 999
// Получение текущей микросекунды
carbon.Parse("2020-08-05 13:14:15.999").Microsecond() // 999000
// Получение текущей наносекунды
carbon.Parse("2020-08-05 13:14:15.999").Nanosecond() // 999000000
// Получение метки времени с точностью до секунды
carbon.Parse("2020-08-05 13:14:15").Timestamp() // 1596633255
// Получение метки времени с точностью до миллисекунды
carbon.Parse("2020-08-05 13:14:15.999").TimestampMilli() // 1596633255999
// Получение метки времени с точностью до микросекунды
carbon.Parse("2020-08-05 13:14:15.999999").TimestampMicro() // 1596633255999999
// Получение метки времени с точностью до наносекунды
carbon.Parse("2020-08-05 13:14:15.999999999").TimestampNano() // 1596633255999999999// Получение местоположения часового пояса
carbon.SetTimezone(carbon.PRC).Timezone() // Asia/Shanghai
carbon.SetTimezone(carbon.Tokyo).Timezone() // Asia/Tokyo
// Получение названия часового пояса
carbon.SetTimezone(carbon.PRC).ZoneName() // CST
carbon.SetTimezone(carbon.Tokyo).ZoneName() // JST
// Получение смещения часового пояса от UTC в секундах
carbon.SetTimezone(carbon.PRC).ZoneOffset() // 28800
carbon.SetTimezone(carbon.Tokyo).ZoneOffset() // 32400
// Получение названия локали
carbon.Now().SetLocale("en").Locale() // en
carbon.Now().SetLocale("zh-CN").Locale() // zh-CN
// Получение названия созвездия
carbon.Now().Constellation() // Leo
carbon.Now().SetLocale("en").Constellation() // Leo
carbon.Now().SetLocale("zh-CN").Constellation() // Стрелец
// Получение названия сезона
carbon.Now().Season() // Лето
carbon.Now().SetLocale("en").Season() // Summer
carbon.Now().SetLocale("zh-CN").Season() // 夏季
// Получение дня начала недели
carbon.SetWeekStartsAt(carbon.Sunday).WeekStartsAt() // Воскресенье
carbon.SetWeekStartsAt(carbon.Monday).WeekStartsAt() // Понедельник
// Получение дня конца недели
carbon.SetWeekStartsAt(carbon.Sunday).WeekEndsAt() // Суббота
carbon.SetWeekStartsAt(carbon.Monday).WeekEndsAt() // Воскресенье
// Получение текущего формата даты и времени
carbon.Parse("now").CurrentLayout() // "2006-01-02 15:04:05"
carbon.ParseByLayout("2020-08-05", DateLayout).CurrentLayout() // "2006-01-02"
// Получение текущего возраста
carbon.Parse("2002-01-01 13:14:15").Age() // 17
carbon.Parse("2002-12-31 13:14:15").Age() // 18```go
// Вывод строки формата даты и времени
carbon.Parse("2020-08-05 13:14:15").ToDateTimeString() // 2020-08-05 13:14:15
// Вывод строки формата даты и времени с миллисекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeMilliString() // 2020-08-05 13:14:15.999
// Вывод строки формата даты и времени с микросекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeMicroString() // 2020-08-05 13:14:15.999999
// Вывод строки формата даты и времени с наносекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToDateTimeNanoString() // 2020-08-05 13:14:15.999999999
```// Вывод строки с коротким форматом даты и времени
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeString() // 20200805131415
// Вывод строки с коротким форматом даты и времени с миллисекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeMilliString() // 20200805131415.999
// Вывод строки с коротким форматом даты и времени с микросекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeMicroString() // 20200805131415.999999
// Вывод строки с коротким форматом даты и времени с наносекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToShortDateTimeNanoString() // 20200805131415.999999999// Форматирование строки даты
carbon.Parse("2020-08-05 13:14:15.999999999").ToDateString() // 2020-08-05
// Форматирование строки даты с миллисекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToDateMilliString() // 2020-08-05.999
// Форматирование строки даты с микросекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToDateMicroString() // 2020-08-05.999999
// Форматирование строки даты с наносекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToDateNanoString() // 2020-08-05.999999999
```// Форматирование короткой строки даты
carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateString() // 05.08.2020
// Форматирование короткой строки даты с миллисекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateMilliString() // 05.08.2020.999
// Форматирование короткой строки даты с микросекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateMicroString() // 05.08.2020.999999
// Форматирование короткой строки даты с наносекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToShortDateNanoString() // 05.08.2020.999999999
// Форматирование строки времени
carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeString() // 13:14:15
// Форматирование строки времени с миллисекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeMilliString() // 13:14:15.999
// Форматирование строки времени с микросекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeMicroString() // 13:14:15.999999
// Форматирование строки времени с наносекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToTimeNanoString() // 13:14:15.999999999// Форматирование короткой строки времени
carbon.Parse("2020-08-05 13:14:15. 999999999").ToShortTimeString() // 13:14:15
// Форматирование короткой строки времени с миллисекундами
carbon.Parse("2020-08-05 13:14:15. 999999999").ToShortTimeMilliString() // 13:14:15. 999
// Форматирование короткой строки времени с микросекундами
carbon.Parse("2020-08-05 13:14:15. 999999999").ToShortTimeMicroString() // 13:14:15. 999999
// Форматирование короткой строки времени с наносекундами
carbon.Parse("2020-08-05 13:14:15. 999999999").ToShortTimeNanoString() // 13:14:15. 999999999
// Вывод строки формата Ansic
carbon.Parse("2020-08-05 13:14:15").ToAnsicString() // Ср, 5 авг 13:14:15 2020
// Вывод строки формата Atom
carbon.Parse("2020-08-05 13:14:15").ToAtomString() // 2020-08-05T13:14:15+08:00
// Вывод строки формата Unix date
carbon.Parse("2020-08-05 13:14:15").ToUnixDateString() // Ср, 5 авг 13:14:15 UTC 2020
// Вывод строки формата Ruby date
carbon.Parse("2020-08-05 13:14:15").ToRubyDateString() // Ср, 5 авг 13:14:15 +0000 2020
// Вывод строки формата Kitchen
carbon.Parse("2020-08-05 13:14:15").ToKitchenString() // 1:14PM
// Вывод строки формата Cookie
carbon.Parse("2020-08-05 13:14:15").ToCookieString() // Wednesday, 05-Aug-2020 13:14:15 UTC
// Вывод строки формата day, date and time
carbon.Parse("2020-08-05 13:14:15").ToDayDateTimeString() // Ср, 5 авг 2020 1:14 PM
// Вывод строки формата RSS
carbon.Parse("2020-08-05 13:14:15").ToRssString() // Ср, 05 авг 2020 13:14:15 +0000
// Вывод строки формата W3C
carbon.Parse("2020-08-05 13:14:15").ToW3cString() // 2020-08-05T13:14:15Z
// Вывод строки формата ISO8601
carbon.Parse("2020-08-05 13:14:15. 999999999").ToIso8601String() // 2020-08-05T13:14:15+00:00
// Вывод строки формата ISO8601 с миллисекундами
carbon.Parse("2020-08-05 13:14:15. 999999999").ToIso8601MilliString() // 2020-08-05T13:14:15. 999+00:00
// Вывод строки формата ISO8601 с микросекундами
carbon.Parse("2020-08-05 13:14:15. 999999999").ToIso8601MicroString() // 2020-08-05T13:14:15. 999999+00:00ToIso8601MicroString() // 2020-08-05T13:14:15.999999+00:00
// Вывод строки формата ISO8601 с микросекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601NanoString() // 2020-08-05T13:14:15.999999999+00:00
// Вывод строки формата ISO8601Zulu
carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601ZuluString() // 2020-08-05T13:14:15Z
// Вывод строки формата ISO8601Zulu с миллисекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601ZuluMilliString() // 2020-08-05T13:14:15.999Z
// Вывод строки формата ISO8601Zulu с микросекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601ZuluMicroString() // 2020-08-05T13:14:15.999999Z
// Вывод строки формата ISO8601Zulu с наносекундами
carbon.Parse("2020-08-05 13:14:15.999999999").ToIso8601ZuluNanoString() // 2020-08-05T13:14:15.999999999Z// Вывод строки формата RFC822
carbon.Parse("2020-08-05 13:14:15").ToRfc822String() // 05 Aug 20 13:14 UTC
// Вывод строки формата RFC822Z
carbon.Parse("2020-08-05 13:14:15").ToRfc822zString() // 05 Aug 20 13:14 +0000
// Вывод строки формата RFC850
carbon.Parse("2020-08-05 13:14:15").ToRfc850String() // Wednesday, 05-Aug-20 13:14:15 UTC
// Вывод строки формата RFC1036
carbon.Parse("2020-08-05 13:14:15").ToRfc1036String() // Wed, 05 Aug 20 13:14:15 +0000
// Вывод строки формата RFC1123
carbon.Parse("2020-08-05 13:14:15").ToRfc1123String() // Wed, 05 Aug 2020 13:14:15 UTC
// Вывод строки формата RFC1123Z
carbon.Parse("2020-08-05 13:14:15").ToRfc1123zString() // Wed, 05 Aug 2020 13:14:15 +0000
// Вывод строки формата RFC2822
carbon.Parse("2020-08-05 13:14:15").ToRfc2822String() // Wed, 05 Aug 2020 13:14:15 +0000
// Вывод строки формата RFC7231
carbon.Parse("2020-08-05 13:14:15").ToRfc7231String() // Wed, 05 Aug 2020 13:14:15 UTC
// Вывод строки в формате RFC3339
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339String() // 2020-08-05T05:14:15Z
// Вывод строки в формате RFC3339 с миллисекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339MilliString() // 2020-08-05T05:14:15.999Z
// Вывод строки в формате RFC3339 с микросекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339MicroString() // 2020-08-05T05:14:15.999999Z
// Вывод строки в формате RFC3339 с наносекундами
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToRfc3339NanoString() // 2020-08-05T05:14:15.999999999Z
// Вывод строки с датой и временем в формате datetime
fmt.Printf("%s", carbon.Parse("2020-08-05 13:14:15")) // 2020-08-05 13:14:15
// Вывод строки в формате "2006-01-02 15:04:05.999999999 -0700 MST"
carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
// Вывод строки в формате "Jan 2, 2006"
carbon.Parse("2020-08-05 13:14:15").ToFormattedDateString() // Aug 5, 2020
// Вывод строки в формате "Mon, Jan 2, 2006"
carbon.Parse("2020-08-05 13:14:15").ToFormattedDayDateString() // Wed, Aug 5, 2020// Вывод строки по шаблону
carbon.Parse("2020-08-05 13:14:15").Layout(carbon.ISO8601Layout) // 2020-08-05T13:14:15+00:00
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").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 jK \\o\\f F Y h:i:s A") // среда 5-го августа 2020 13:14:15
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").Constellation() // Лев
```// Является ли знаком зодиака Овен
carbon.Parse("2020-08-05 13:14:15").IsAries() // false
// Является ли знаком зодиака Телец
carbon.Parse("2020-08-05 13:14:15").IsTaurus() // false
// Является ли знаком зодиака Близнецы
carbon.Parse("2020-08-05 13:14:15").IsGemini() // false
// Является ли знаком зодиака Рак
carbon.Parse("2020-08-05 13:14:15").IsCancer() // false
// Является ли знаком зодиака Лев
carbon.Parse("2020-08-05 13:14:15").IsLeo() // true
// Является ли знаком зодиака Дева
carbon.Parse("2020-08-05 13:14:15").IsVirgo() // false
// Является ли знаком зодиака Весы
carbon.Parse("2020-08-05 13:14:15").IsLibra() // false
// Является ли знаком зодиака Скорпион
carbon.Parse("2020-08-05 13:14:15").IsScorpio() // false
// Является ли знаком зодиака Стрелец
carbon.Parse("2020-08-05 13:14:15").IsSagittarius() // false
// Является ли знаком зодиака Козерог
carbon.Parse("2020-08-05 13:14:15").IsCapricorn() // false
// Является ли знаком зодиака Водолей
carbon.Parse("2020-08-05 13:14:15").IsAquarius() // false
// Является ли знаком зодиака Рыбы
carbon.Parse("2020-08-05 13:14:15").IsPisces() // false
```##### Период```> Согласно методу деления на метеорологические сезоны, март по май — весна, июнь по август — лето, сентябрь по ноябрь — осень, декабрь по февраль — зима
```go
// Получить название сезона
carbon.Parse("2020-08-05 13:14:15").Season() // Лето
// Начало сезона
carbon.Parse("2020-08-05 13:14:15").StartOfSeason().ToDateTimeString() // 2020-06-01 00:00:00
// Конец сезона
carbon.Parse("2020-08-05 13:14:15").EndOfSeason().ToDateTimeString() // 2020-08-31 23:59:59
// Является ли весной
carbon.Parse("2020-08-05 13:14:15").IsSpring() // false
// Является ли летом
carbon.Parse("2020-08-05 13:14:15").IsSummer() // true
// Является ли осенью
carbon.Parse("2020-08-05 13:14:15").IsAutumn() // false
// Является ли зимой
carbon.Parse("2020-08-05 13:14:15").IsWinter() // false
type User struct {
Date *carbon.Date `json:"date"`
DateMilli *carbon.DateMilli `json:"date_milli"`
DateMicro *carbon.DateMicro `json:"date_micro"`
DateNano *carbon.DateNano `json:"date_nano"`
Time *carbon.Time `json:"time"`
TimeMilli *carbon.TimeMilli `json:"time_milli"`
TimeMicro *carbon.TimeMicro `json:"time_micro"`
TimeNano *carbon.TimeNano `json:"time_nano"`
DateTime *carbon.DateTime `json:"date_time"`
DateTimeMilli *carbon.DateTimeMilli `json:"date_time_milli"`
DateTimeMicro *carbon.DateTimeMicro `json:"date_time_micro"`
DateTimeNano *carbon.DateTimeNano `json:"date_time_nano"`
Timestamp *carbon.Timestamp `json:"timestamp"`
TimestampMilli *carbon.TimestampMilli `json:"timestamp_milli"`
TimestampMicro *carbon.TimestampMicro `json:"timestamp_micro"`
TimestampNano *carbon.TimestampNano `json:"timestamp_nano"`
CreatedAt *carbon.DateTime `json:"created_at"`
UpdatedAt *carbon.DateTime `json:"updated_at"`
DeletedAt *carbon.Timestamp `json:"deleted_at"`
}
var user User
c := carbon.Parse("2020-08-05 13:14:15.999999999")
user.Date = carbon.NewDate(c)
user.DateMilli = carbon.NewDateMilli(c)
user.DateMicro = carbon.NewDateMicro(c)
user.DateNano = carbon.NewDateNano(c)
``````go
user.Time = carbon.NewTime(c)
user.TimeMilli = carbon.NewTimeMilli(c)
user.TimeMicro = carbon.NewTimeMicro(c)
user.TimeNano = carbon.NewTimeNano(c)
user.DateTime = carbon.NewDateTime(c)
user.DateTimeMilli = carbon.NewDateTimeMilli(c)
user.DateTimeMicro = carbon.NewDateTimeMicro(c)
user.DateTimeNano = carbon.NewDateTimeNano(c)
user.Timestamp = carbon.NewTimestamp(c)
user.TimestampMilli = carbon.NewTimestampMilli(c)
user.TimestampMicro = carbon.NewTimestampMicro(c)
user.TimestampNano = carbon.NewTimestampNano(c)
user.CreatedAt = carbon.NewDateTime(c)
user.UpdatedAt = carbon.NewDateTime(c)
user.DeletedAt = carbon.NewTimestamp(c)
data, err := json.Marshal(&user)
if err != nil {
// Обработка ошибки...
log.Fatal(err)
}
fmt.Printf("%s\n", data)
// Вывод
{
"date": "2020-08-05",
"date_milli": "2020-08-05.999",
"date_micro": "2020-08-05.999999",
"date_nano": "2020-08-05.999999999",
"time": "13:14:15",
"time_milli": "13:14:15.999",
"time_micro": "13:14:15.999999",
"time_nano": "13:14:15.999999999",
"date_time": "2020-08-05 13:14:15",
"date_time_milli": "2020-08-05 13:14:15.999",
"date_time_micro": "2020-08-05 13:14:15.999999",
"date_time_nano": "2020-08-05 13:14:15.999999999",
"timestamp": 1596633255,
"timestamp_milli": 1596633255999,
"timestamp_micro": 1596633255999999,
"timestamp_nano": 1596633255999999999,
"created_at": "2020-08-05 13:14:15",
"updated_at": "2020-08-05 13:14:15",
"deleted_at": 1596633255
}
var person User
err := json.Unmarshal(data, &person)
if err != nil {
// Обработка ошибки...
log.Fatal(err)
}
fmt.Printf("person: %+v\n", person)
// Вывод
person: {Date:2020-08-05 DateMilli:2020-08-05.999 DateMicro:2020-08-05.999999 DateNano:2020-08-05.999999999 Time:13:14:15 TimeMilli:13:14:15.999 TimeMicro:13:14:15.999999 TimeNano:13:14:15.999999999 DateTime:2020-08-05 13:14:15 DateTimeMilli:2020-08-05 13:14:15.999 DateTimeMicro:2020-08-05 13:14:15.999999 DateTimeNano:2020-08-05 13:14:15.999999999 Timestamp:1596633255 TimestampMilli:1596633255999 TimestampMicro:1596633255999999 TimestampNano:1596633255999999999 CreatedAt:2020-08-05 13:14:15 UpdatedAt:2020-08-05 13:14:15 DeletedAt:1596633255}
type RFC3339Type string
func (t RFC3339Type) Layout() string {
return carbon.RFC3339Layout
}
type ISO8601Type string
func (t ISO8601Type) Format() string {
return carbon.ISO8601Format
}
```type User struct {
Customer1 *carbon.LayoutType[RFC3339Type] `json:"customer1"`
Customer2 *carbon.FormatType[ISO8601Type] `json:"customer2"`
}
var user User
c := carbon.Parse("2020-08-05 13:14:15")
user.Customer1 = carbon.NewLayoutType[RFC3339Type](c)
user.Customer2 = carbon.NewFormatType[ISO8601Type](c)
data, err := json.Marshal(&user)
if err != nil {
// Обработка ошибки...
log.Fatal(err)
}
fmt.Printf("%s\n", data)
// Вывод
{"customer1":"2020-08-05T13:14:15Z","customer2":"2020-08-05T13:14:15+00:00"}
var person User
err := json.Unmarshal(data, &person)
if err != nil {
// Обработка ошибки...
log.Fatal(err)
}
fmt.Printf("person: %+v\n", person)
// Вывод
person: {Customer1:2020-08-05T13:14:15Z Customer2:2020-08-05T13:14:15+00:00}
##### Календарь
Поддерживаются следующие календари
* [Юлианский день/Модифицированный юлианский день](./calendar/julian/README.md "JD/MJD")
* [Китайский лунный](./calendar/lunar/README.md "Китайский лунный")
* [Персидский/Джалаали](./calendar/persian/README.md "Персидский/Джалаали")
##### Многокультурность
Поддерживаются следующие языки (в порядке времени перевода)* [Упрощенный китайский (zh-CN)](. /lang/zh-CN. json "Упрощенный китайский"): переведено [gouguoyin](https://github. com/gouguoyin "gouguoyin")
* [Традиционный китайский (zh-TW)](. /lang/zh-TW. json "Традиционный китайский"): переведено [gouguoyin](https://github. com/gouguoyin "gouguoyin")
* [Английский (en)](. /lang/en. json "Английский"): переведено [gouguoyin](https://github. com/gouguoyin "gouguoyin")
* [Японский (jp)](. /lang/jp. json "Японский"): переведено [gouguoyin](https://github. com/gouguoyin "gouguoyin")
* [Корейский (kr)](. /lang/kr. json "Корейский"): переведено [nannul](https://github. com/nannul "nannul")
* [Немецкий (de)](. /lang/de. json "Немецкий"): переведено [benzammour](https://github. com/benzammour "benzammour")
* [Испанский (es)](. /lang/es. json "Испанский"): переведено [hgisinger](https://github. com/hgisinger "hgisinger")
* [Турецкий (tr)](. /lang/tr. json "Турецкий"): переведено [emresenyuva](https://github. com/emresenyuva "emresenyuva")
* [Португальский (pt)](. /lang/pt. json "Португальский"): переведено [felipear89](https://github. com/felipear89 "felipear89")
* [Русский (ru)](. /lang/ru. json "Русский"): переведено [zemlyak](https://github. com/zemlyak "zemlyak")
* [Украинский (uk)](. /lang/uk. json "Украинский"): переведено [open-git](https://github. com/open-git "open-git")
* [Румынский (ro)](. /lang/ro. json "Румынский"): переведено [DrOctavius](https://github. com/DrOctavius "DrOctavius")
* [Индонезийский (id)](. /lang/id. json "Индонезийский"): переведено [justpoypoy](https://github. com/justpoypoy "justpoypoy")
* [Итальянский (it)](. /lang/it. json "Итальянский"): переведено [nicoloHevelop](https://github. com/nicoloHevelop "nicoloHevelop")
* [Малайский (ms-MY)](. /lang/ms-MY. json "Малайский"): переведено [hollowaykeanho](https://github. com/hollowaykeanho "hollowaykeanho")com/hollowaykeanho "hollowaykeanho")
* [Французский (fr)](. /lang/fr. json "Французский"): переведено [hollowaykeanho](https://github. com/hollowaykeanho "hollowaykeanho")
* [Тайский (th)](. /lang/th. json "Тайский"): переведено [izcream](https://github. com/izcream "izcream")
* [Шведский (sv)](. /lang/se. json "Шведский"): переведено [jwanglof](https://github. com/jwanglof "jwanglof")
* [Персидский (fa)](. /lang/fa. json "Персидский"): переведено [erfanMomeniii](https://github. com/erfanMomeniii "erfanMomeniii")
* [Нидерландский (nl)](. /lang/nl. json "Нидерландский"): переведено [RemcoE33](https://github. com/RemcoE33 "RemcoE33")
* [Вьетнамский (vi)](. /lang/vi. json "Вьетнамский"): переведено [culy247](https://github. com/culy247 "culy247")
* [Хинди (hi)](. /lang/hi. json "Индия"): переведено [chauhan17nitin](https://github. com/chauhan17nitin "chauhan17nitin")
* [Польский (pl)](. /lang/pl. json "Польша"): переведено [gouguoyin](https://github. com/gouguoyin "gouguoyin")
* [Болгарский (bg)](. /lang/bg. json "Болгария"): переведено [yuksbg](https://github. com/yuksbg "yuksbg")
* [Арабский (ar)](. /lang/ar. json "Арабский"): переведено [zumoshi](https://github. com/zumoshi "zumoshi")
* [Венгерский (hu)](. /lang/hu. json "Венгрия"): переведено [kenlas](https://github. com/kenlas "kenlas")
* [Датский (da)](. /lang/dk. json "Дания"): переведено [Munk91](https://github. com/Munk91 "Munk91")
* [Норвежский (no)](. /lang/nb. json "Норвегия"): переведено [bendikrb](https://github. com/bendikrb "bendikrb")
Следующие методы поддерживаются* `Constellation()`：получить имя созвездия, например `Овен`
* `Season()`：получить имя сезона, например `Весна`
* `DiffForHumans()`：получить разницу в человекочитаемом формате, например `через 1 год`
* `ToMonthString()`：вывести строку формата месяца, например `Январь`
* `ToShortMonthString()`：вывести сокращённую строку формата месяца, например `Янв`
* `ToWeekString()`：вывести строку формата недели, например `Воскресенье`
* `ToShortWeekString()`：вывести сокращённую строку формата недели, например `Вск`
###### Установка локали
```go
lang := carbon.NewLanguage()
lang.SetLocale("ru")
carbon.SetTestNow(carbon.Parse("2020-08-05 13:14:15"))
now := carbon.Now().SetLanguage(lang)
now.Copy().AddHours(1).DiffForHumans() // через 1 час
now.Copy().AddHours(1).ToMonthString() // Август
now.Copy().AddHours(1).ToShortMonthString() // Авг
now.Copy().AddHours(1).ToWeekString() // Среда
now.Copy().AddHours(1).ToShortWeekString() // Срд
now.Copy().AddHours(1).Constellation() // Лев
now.Copy().AddHours(1).Season() // Лето
lang := carbon.NewLanguage()
resources := map[string]string {
"hour": "%dh",
}
lang.SetLocale("ru").SetResources(resources)
carbon.SetTestNow(carbon.Parse("2020-08-05 13:14:15"))
now := carbon.Now().SetLanguage(lang)
now.Copy().AddYears(1).DiffForHumans() // через 1 год
now.Copy().AddHours(1).DiffForHumans() // через 1 час
now.ToMonthString() // Август
now.ToShortMonthString() // Авг
now.ToWeekString() // Вторник
now.ToShortWeekString() // Втр
now.Constellation() // Лев
now.Season() // Лето
lang := carbon.NewLanguage() resources := map[string]string{ "months": "январь|февраль|март|апрель|май|июнь|июль|август|сентябрь|октябрь|ноябрь|декабрь", "short_months": "янв|фев|мар|апр|май|июн|июл|авг|сен|окт|ноя|дек", "weeks": "воскресенье|понедельник|вторник|среда|четверг|пятница|суббота", "short_weeks": "вск|пон|втр|срд|чтв|птн|сбт", "seasons": "весна|лето|осень|зима", "constellations": "овен|телец|близнецы|рак|лев|дева|весы|скорпион|стрелец|козерог|водолей|рыбы", "year": "1 год|%d лет", "month": "1 месяц|%d месяцев", "week": "%d недель", "day": "%d дней", "hour": "%d часов", "minute": "%d минут", "second": "%d секунд", "now": "только что", "ago": "%s назад", "from_now": "через %s", "before": "%s до", "after": "%s после", } lang.SetResources(resources)
now := carbon.Now().SetLanguage(lang)
```now.Copy().AddYears(1).DiffForHumans() // через 1 год
now.Copy().AddHours(1).DiffForHumans() // через 1 час
now.ToMonthString() // август
now.ToShortMonthString() // авг
now.ToWeekString() // вторник
now.ToShortWeekString() // вт
now.Constellation() // лев
now.Season() // лето
```go
c := carbon.Parse("2020-08-05").SetTimezone("xxx")
if c.HasError() {
// Обработка ошибки...
log.Fatal(c.Error)
}
// Вывод
недействительная временная зона "xxx", пожалуйста, посмотрите файл "$GOROOT/lib/time/zoneinfo.zip" для всех действительных временных зон
|:----:|:------------------------------------------------------------------------------------------------------:|:------:|:----------------:|:-------------------:| | d | День месяца, дополненный до 2 цифр | 2 | 01-31 | 02 | | D | День недели, как сокращённая локализованная строка | 3 | Пн-Вс | Пн | | j | День месяца, без дополнения | - | 1-31 | 2 | | K | Английский порядковый суффикс для дня месяца, 2 символа. Например: st, nd, rd или th. Хорошо работает с j | 2 | st/nd/rd/th | th | | l | День недели, как полная локализованная строка | - | Понедельник-Воскресенье | Понедельник | | F | Месяц, как полная локализованная строка | - | Январь-Декабрь | Январь | | m | Месяц, дополненный до 2 цифр | 2 | 01-12 | 01 | | M | Месяц, как сокращённая локализованная строка | 3 | Ян-Дек | Ян | | n | Месяц, без дополнения | - | 1-12 | 1 | | Y | Четырёхзначный год | 4 | 0000-9999 | 2006 | | y | Двухзначный год | 2 | 00-99 | 06 | | a | Нижний регистр утреннего или вечернего знака | 2 | ут/веч | веч | | A | Верхний регистр утреннего или вечернего знака | 2 | УТ/ВЕЧ | ВЕЧ | || g | Час в 12-часовом формате, без дополнительного отступа | - | 1-12 | 3 | | G | Час в 24-часовом формате, без дополнительного отступа | - | 0-23 | 15 | | h | Час в 12-часовом формате, дополненный до 2 символов | 2 | 00-11 | 03 | | H | Час в 24-часовом формате, дополненный до 2 символов | 2 | 00-23 | 15 | | i | Минута, дополненная до 2 символов | 2 | 01-59 | 04 | | s | Секунда, дополненная до 2 символов | 2 | 01-59 | 05 | | O | Разница по отношению к времени Гринвича (GMT) без двоеточия между часами и минутами | - | - | -0700 | | P | Разница по отношению к времени Гринвича (GMT) с двоеточием между часами и минутами | - | - | -07:00 | | Z | Название временной зоны | - | - | MST | | W | Неделя в году, дополненная до 2 символов | 2 | 01-52 | 01 | | N | День недели, дополненный до 2 символов | 2 | 01-07 | 02 | | L | Является ли високосным годом | 1 | 0-1 | 0 | | S | Unix-временная метка с секундами | - | - | 1596604455 | | U | Unix-временная метка с миллисекундной точностью | - | - | 1596604455666 | | V | Unix-временная метка с микросекундной точностью | - | - | 1596604455666666 | | X | Unix-время с наносекундной точностью | - | - | 1596604455666666666 | | u | Миллисекунда | - | 1-999 | 999 | | v | Микросекунда | - | 1-999999 | 999999 | | x | Наносекунда | - | 1-999999999 | 999999999 | | w | День недели | 1 | 0-6 | 1 | | t | Общее количество дней в месяце | 2 | 28-31 | 31 | | z | Часовой пояс | - | - | Asia/Shanghai | | o | Смещение времени | - | - | 28800 | | q | Квартал | 1 | 1-4 | 1 | | c | Век | - | 0-99 | 21 |#### Часто задаваемые вопросы (FAQ)1. Какая разница между версиями v2.5.x и v2.6.x?
В версиях
v2.5.xи ниже используется передача позначению, в версияхv2.6.xи выше — передача поуказателю. Рекомендуется использовать версииv2.6.xи выше.
Windows
Если на системе
Windowsне установлено окружениеgolang, при развертывании будет выдано исключениеGOROOT/lib/time/zoneinfo.zip: такого файла или каталога не существует. Причина в том, что системаWindowsне имеет встроенных файлов часового пояса. Вам нужно будет вручную скачать и указать путь к файлуzoneinfo.zip, напримерgo/lib/time/zoneinfo.zip
os.Setenv("ZONEINFO", "./go/lib/time/zoneinfo.zip")
Docker
Если в контейнере
Dockerне установлено окружениеgolang, при развертывании будет выдано исключениеopen /usr/local/go/lib/time/zoneinfo.zip: такого файла или каталога не существует. Вам нужно будет скопировать файлzoneinfo.zipв контейнер, то есть добавить его вDockerfile
COPY ./zoneinfo.zip /usr/local/go/lib/time/zoneinfo.zip
Благодарим всех, кто внес вклад в проект Carbon:
Carbon — это некоммерческий проект с открытым исходным кодом. Если вы хотите поддержать Carbon, вы можете купить чашку кофе для разработчиков.
Carbon разрабатывался с использованием GoLand под лицензией JetBrains для открытых проектов. Я хотел бы выразить свою благодарность JetBrains здесь.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Комментарии ( 0 )