carbon

package
v1.15.7 Latest Latest
Warning

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

 Go to latest Published: Apr 13, 2025 License: MIT Imports: 2 Imported by: 44

Documentation

Index

Constants

View Source 
const (
	Local = carbon.Local // 本地时间
	UTC   = carbon.UTC   // 世界协调时间
	GMT   = carbon.GMT   // 格林尼治标准时间
	EET   = carbon.EET   // 欧洲东部标准时间
	WET   = carbon.WET   // 欧洲西部标准时间
	CET   = carbon.CET   // 欧洲中部标准时间
	EST   = carbon.EST   // 美国东部标准时间
	MST   = carbon.MST   // 美国山地标准时间

	Cuba      = carbon.Cuba      // 古巴
	Egypt     = carbon.Egypt     // 埃及
	Eire      = carbon.Eire      // 爱尔兰
	Greenwich = carbon.Greenwich // 格林尼治
	Iceland   = carbon.Iceland   // 冰岛
	Iran      = carbon.Iran      // 伊朗
	Israel    = carbon.Israel    // 以色列
	Jamaica   = carbon.Jamaica   // 牙买加
	Japan     = carbon.Japan     // 日本
	Libya     = carbon.Libya     // 利比亚
	Poland    = carbon.Poland    // 波兰
	Portugal  = carbon.Portugal  // 葡萄牙
	PRC       = carbon.PRC       // 中国
	Singapore = carbon.Singapore // 新加坡
	Turkey    = carbon.Turkey    // 土耳其

	Shanghai   = carbon.Shanghai   // 上海
	Chongqing  = carbon.Chongqing  // 重庆
	Harbin     = carbon.Harbin     // 哈尔滨
	Urumqi     = carbon.Urumqi     // 乌鲁木齐
	HongKong   = carbon.HongKong   // 香港
	Macao      = carbon.Macao      // 澳门
	Taipei     = carbon.Taipei     // 台北
	Tokyo      = carbon.Tokyo      // 东京
	Saigon     = carbon.Saigon     // 西贡
	Seoul      = carbon.Seoul      // 首尔
	Bangkok    = carbon.Bangkok    // 曼谷
	Dubai      = carbon.Dubai      // 迪拜
	NewYork    = carbon.NewYork    // 纽约
	LosAngeles = carbon.LosAngeles // 洛杉矶
	Chicago    = carbon.Chicago    // 芝加哥
	Moscow     = carbon.Moscow     // 莫斯科
	London     = carbon.London     // 伦敦
	Berlin     = carbon.Berlin     // 柏林
	Paris      = carbon.Paris      // 巴黎
	Rome       = carbon.Rome       // 罗马
	Sydney     = carbon.Sydney     // 悉尼
	Melbourne  = carbon.Melbourne  // 墨尔本
	Darwin     = carbon.Darwin     // 达尔文
)

timezone constants 时区常量

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

month constants 月份常量

View Source 
const (
	Aries       = "Aries"       // 白羊座
	Taurus      = "Taurus"      // 金牛座
	Gemini      = "Gemini"      // 双子座
	Cancer      = "Cancer"      // 巨蟹座
	Leo         = "Leo"         // 狮子座
	Virgo       = "Virgo"       // 处女座
	Libra       = "Libra"       // 天秤座
	Scorpio     = "Scorpio"     // 天蝎座
	Sagittarius = "Sagittarius" // 射手座
	Capricorn   = "Capricorn"   // 摩羯座
	Aquarius    = "Aquarius"    // 水瓶座
	Pisces      = "Pisces"      // 双鱼座
)

constellation constants 星座常量

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

week constants 星期常量

View Source 
const (
	Spring = "Spring" // 春季
	Summer = "Summer" // 夏季
	Autumn = "Autumn" // 秋季
	Winter = "Winter" // 冬季
)

season constants 季节常量

View Source 
const (
	YearsPerMillennium = 1000   // 每千年1000年
	YearsPerCentury    = 100    // 每世纪100年
	YearsPerDecade     = 10     // 每十年10年
	QuartersPerYear    = 4      // 每年4个季度
	MonthsPerYear      = 12     // 每年12月
	MonthsPerQuarter   = 3      // 每季度3月
	WeeksPerNormalYear = 52     // 每常规年52周
	WeeksPerLongYear   = 53     // 每长年53周
	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秒
)

number constants 数字常量

View Source 
const (
	ANSICLayout              = stdtime.ANSIC
	UnixDateLayout           = stdtime.UnixDate
	RubyDateLayout           = stdtime.RubyDate
	RFC822Layout             = stdtime.RFC822
	RFC822ZLayout            = stdtime.RFC822Z
	RFC850Layout             = stdtime.RFC850
	RFC1123Layout            = stdtime.RFC1123
	RFC1123ZLayout           = stdtime.RFC1123Z
	RssLayout                = stdtime.RFC1123Z
	KitchenLayout            = stdtime.Kitchen
	RFC2822Layout            = stdtime.RFC1123Z
	CookieLayout             = carbon.CookieLayout
	RFC3339Layout            = carbon.RFC3339Layout
	RFC3339MilliLayout       = carbon.RFC3339MilliLayout
	RFC3339MicroLayout       = carbon.RFC3339MicroLayout
	RFC3339NanoLayout        = carbon.RFC3339NanoLayout
	ISO8601Layout            = carbon.ISO8601Layout
	ISO8601MilliLayout       = carbon.ISO8601MilliLayout
	ISO8601MicroLayout       = carbon.ISO8601MicroLayout
	ISO8601NanoLayout        = carbon.ISO8601NanoLayout
	RFC1036Layout            = carbon.RFC1036Layout
	RFC7231Layout            = carbon.RFC7231Layout
	DayDateTimeLayout        = carbon.DayDateTimeLayout
	DateTimeLayout           = carbon.DateTimeLayout
	DateTimeMilliLayout      = carbon.DateTimeMilliLayout
	DateTimeMicroLayout      = carbon.DateTimeMicroLayout
	DateTimeNanoLayout       = carbon.DateTimeNanoLayout
	ShortDateTimeLayout      = carbon.ShortDateTimeLayout
	ShortDateTimeMilliLayout = carbon.ShortDateTimeMilliLayout
	ShortDateTimeMicroLayout = carbon.ShortDateTimeMicroLayout
	ShortDateTimeNanoLayout  = carbon.ShortDateTimeNanoLayout
	DateLayout               = carbon.DateLayout
	DateMilliLayout          = carbon.DateMilliLayout
	DateMicroLayout          = carbon.DateMicroLayout
	DateNanoLayout           = carbon.DateNanoLayout
	ShortDateLayout          = carbon.ShortDateLayout
	ShortDateMilliLayout     = carbon.ShortDateMilliLayout
	ShortDateMicroLayout     = carbon.ShortDateMicroLayout
	ShortDateNanoLayout      = carbon.ShortDateNanoLayout
	TimeLayout               = carbon.TimeLayout
	TimeMilliLayout          = carbon.TimeMilliLayout
	TimeMicroLayout          = carbon.TimeMicroLayout
	TimeNanoLayout           = carbon.TimeNanoLayout
	ShortTimeLayout          = carbon.ShortTimeLayout
	ShortTimeMilliLayout     = carbon.ShortTimeMilliLayout
	ShortTimeMicroLayout     = carbon.ShortTimeMicroLayout
	ShortTimeNanoLayout      = carbon.ShortTimeNanoLayout
)

layout constants 布局模板常量

View Source 
const (
	AtomFormat     = carbon.AtomFormat
	ANSICFormat    = carbon.ANSICFormat
	CookieFormat   = carbon.CookieFormat
	KitchenFormat  = carbon.KitchenFormat
	RssFormat      = carbon.RssFormat
	RubyDateFormat = carbon.RubyDateFormat
	UnixDateFormat = carbon.UnixDateFormat

	RFC1036Format      = carbon.RFC1036Format
	RFC1123Format      = carbon.RFC1123Format
	RFC1123ZFormat     = carbon.RFC1123ZFormat
	RFC2822Format      = carbon.RFC2822Format
	RFC3339Format      = carbon.RFC3339Format
	RFC3339MilliFormat = carbon.RFC3339MilliFormat
	RFC3339MicroFormat = carbon.RFC3339MicroFormat
	RFC3339NanoFormat  = carbon.RFC3339NanoFormat
	RFC7231Format      = carbon.RFC7231Format
	RFC822Format       = carbon.RFC822Format
	RFC822ZFormat      = carbon.RFC822ZFormat
	RFC850Format       = carbon.RFC850Format

	ISO8601Format      = carbon.ISO8601Format
	ISO8601MilliFormat = carbon.ISO8601MilliFormat
	ISO8601MicroFormat = carbon.ISO8601MicroFormat
	ISO8601NanoFormat  = carbon.ISO8601NanoFormat

	ISO8601ZuluFormat      = carbon.ISO8601ZuluFormat
	ISO8601ZuluMilliFormat = carbon.ISO8601ZuluMilliFormat
	ISO8601ZuluMicroFormat = carbon.ISO8601ZuluMicroFormat
	ISO8601ZuluNanoFormat  = carbon.ISO8601ZuluNanoFormat

	FormattedDateFormat    = carbon.FormattedDateFormat
	FormattedDayDateFormat = carbon.FormattedDayDateFormat

	DayDateTimeFormat        = carbon.DayDateTimeFormat
	DateTimeFormat           = carbon.DateTimeFormat
	DateTimeMilliFormat      = carbon.DateTimeMilliFormat
	DateTimeMicroFormat      = carbon.DateTimeMicroFormat
	DateTimeNanoFormat       = carbon.DateTimeNanoFormat
	ShortDateTimeFormat      = carbon.ShortDateTimeFormat
	ShortDateTimeMilliFormat = carbon.ShortDateTimeMilliFormat
	ShortDateTimeMicroFormat = carbon.ShortDateTimeMicroFormat
	ShortDateTimeNanoFormat  = carbon.ShortDateTimeNanoFormat

	DateFormat           = carbon.DateFormat
	DateMilliFormat      = carbon.DateMilliFormat
	DateMicroFormat      = carbon.DateMicroFormat
	DateNanoFormat       = carbon.DateNanoFormat
	ShortDateFormat      = carbon.ShortDateFormat
	ShortDateMilliFormat = carbon.ShortDateMilliFormat
	ShortDateMicroFormat = carbon.ShortDateMicroFormat
	ShortDateNanoFormat  = carbon.ShortDateNanoFormat

	TimeFormat           = carbon.TimeFormat
	TimeMilliFormat      = carbon.TimeMilliFormat
	TimeMicroFormat      = carbon.TimeMicroFormat
	TimeNanoFormat       = carbon.TimeNanoFormat
	ShortTimeFormat      = carbon.ShortTimeFormat
	ShortTimeMilliFormat = carbon.ShortTimeMilliFormat
	ShortTimeMicroFormat = carbon.ShortTimeMicroFormat
	ShortTimeNanoFormat  = carbon.ShortTimeNanoFormat

	TimestampFormat      = carbon.TimestampFormat
	TimestampMilliFormat = carbon.TimestampMilliFormat
	TimestampMicroFormat = carbon.TimestampMicroFormat
	TimestampNanoFormat  = carbon.TimestampNanoFormat
)

format constants 格式模板常量

Variables

This section is empty.

Functions

func CleanTestNow added in v1.15.7 

func CleanTestNow()

CleanTestNow cleans the test time.

func IsTestNow 

func IsTestNow() bool

IsTestNow determines if the test now time is set.

func SetLocale added in v1.15.7 

func SetLocale(locale string)

SetLocale sets language locale.

func SetTestNow 

func SetTestNow(testTime Carbon)

SetTestNow sets the test time, remember to clean after use.

func SetTimezone 

func SetTimezone(timezone string)

SetTimezone sets timezone.

func UnsetTestNow 

func UnsetTestNow()

UnsetTestNow unsets the test time. Deprecated: it will be deprecated in the future, please use 'CleanTestNow' instead

Types

type Carbon 

type Carbon = carbon.Carbon

func FromDate 

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

FromDate returns a Carbon object of given date.

func FromDateMicro 

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

FromDateMicro returns a Carbon object of given microsecond date.

func FromDateMilli 

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

FromDateMilli returns a Carbon object of given millisecond date.

func FromDateNano 

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

FromDateNano returns a Carbon object of given nanosecond date.

func FromDateTime 

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

FromDateTime returns a Carbon object of given date and time.

func FromDateTimeMicro 

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

FromDateTimeMicro returns a Carbon object of given date and microsecond time.

func FromDateTimeMilli 

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

FromDateTimeMilli returns a Carbon object of given date and millisecond time.

func FromDateTimeNano 

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

FromDateTimeNano returns a Carbon object of given date and nanosecond time.

func FromStdTime 

func FromStdTime(time stdtime.Time, timezone ...string) Carbon

FromStdTime returns a Carbon object of given time.Time object.

func FromTime 

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

FromTime returns a Carbon object of given time.

func FromTimeMicro 

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

FromTimeMicro returns a Carbon object of given microsecond time.

func FromTimeMilli 

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

FromTimeMilli returns a Carbon object of given millisecond time.

func FromTimeNano 

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

FromTimeNano returns a Carbon object of given nanosecond time.

func FromTimestamp 

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

FromTimestamp returns a Carbon object of given timestamp.

func FromTimestampMicro 

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

FromTimestampMicro returns a Carbon object of given microsecond timestamp.

func FromTimestampMilli 

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

FromTimestampMilli returns a Carbon object of given millisecond timestamp.

func FromTimestampNano 

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

FromTimestampNano returns a Carbon object of given nanosecond timestamp.

func Now 

func Now(timezone ...string) Carbon

Now returns a Carbon object of now.

func Parse 

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

Parse returns a Carbon object of given value.

func ParseByFormat 

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

ParseByFormat returns a Carbon object by a confirmed format.

func ParseByLayout 

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

ParseByLayout returns a Carbon object by a confirmed layout.

func ParseWithFormats added in v1.15.7 

func ParseWithFormats(value string, formats []string, timezone ...string) Carbon

ParseWithFormats returns a Carbon object with multiple fuzzy formats.

func ParseWithLayouts added in v1.15.7 

func ParseWithLayouts(value string, layouts []string, timezone ...string) Carbon

ParseWithLayouts returns a Carbon object with multiple fuzzy layouts.

type Date 

type Date = carbon.Date

func NewDate 

func NewDate(carbon Carbon) Date

type DateMicro 

type DateMicro = carbon.DateMicro

func NewDateMicro 

func NewDateMicro(carbon Carbon) DateMicro

type DateMilli 

type DateMilli = carbon.DateMilli

func NewDateMilli 

func NewDateMilli(carbon Carbon) DateMilli

type DateNano 

type DateNano = carbon.DateNano

func NewDateNano 

func NewDateNano(carbon Carbon) DateNano

type DateTime 

type DateTime = carbon.DateTime

func NewDateTime 

func NewDateTime(carbon Carbon) DateTime

type DateTimeMicro 

type DateTimeMicro = carbon.DateTimeMicro

func NewDateTimeMicro 

func NewDateTimeMicro(carbon Carbon) DateTimeMicro

type DateTimeMilli 

type DateTimeMilli = carbon.DateTimeMilli

func NewDateTimeMilli 

func NewDateTimeMilli(carbon Carbon) DateTimeMilli

type DateTimeNano 

type DateTimeNano = carbon.DateTimeNano

func NewDateTimeNano 

func NewDateTimeNano(carbon Carbon) DateTimeNano

type Time added in v1.15.7 

type Time = carbon.Time

func NewTime added in v1.15.7 

func NewTime(carbon Carbon) Time

type TimeMicro added in v1.15.7 

type TimeMicro = carbon.TimeMicro

func NewTimeMicro added in v1.15.7 

func NewTimeMicro(carbon Carbon) TimeMicro

type TimeMilli added in v1.15.7 

type TimeMilli = carbon.TimeMilli

func NewTimeMilli added in v1.15.7 

func NewTimeMilli(carbon Carbon) TimeMilli

type TimeNano added in v1.15.7 

type TimeNano = carbon.TimeNano

func NewTimeNano added in v1.15.7 

func NewTimeNano(carbon Carbon) TimeNano

type Timestamp 

type Timestamp = carbon.Timestamp

func NewTimestamp 

func NewTimestamp(carbon Carbon) Timestamp

type TimestampMicro 

type TimestampMicro = carbon.TimestampMicro

func NewTimestampMicro 

func NewTimestampMicro(carbon Carbon) TimestampMicro

type TimestampMilli 

type TimestampMilli = carbon.TimestampMilli

func NewTimestampMilli 

func NewTimestampMilli(carbon Carbon) TimestampMilli

type TimestampNano 

type TimestampNano = carbon.TimestampNano

func NewTimestampNano 

func NewTimestampNano(carbon Carbon) TimestampNano

Source Files

View all Source files

Jump to

Keyboard shortcuts

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