mirror of
https://gitee.com/dromara/carbon.git
synced 2024-12-03 12:48:22 +08:00
379 lines
7.6 KiB
Go
Executable File
379 lines
7.6 KiB
Go
Executable File
package carbon
|
|
|
|
import "time"
|
|
|
|
// IsZero whether is zero time
|
|
// 是否是零值
|
|
func (c Carbon) IsZero() bool {
|
|
return c.Time.IsZero()
|
|
}
|
|
|
|
// IsInvalid whether is invalid time
|
|
// 是否是无效的
|
|
func (c Carbon) IsInvalid() bool {
|
|
if c.Error != nil || c.IsZero() {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// IsNow whether is now time
|
|
// 是否是当前时间
|
|
func (c Carbon) IsNow() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToTimestamp() == c.Now().ToTimestamp()
|
|
}
|
|
|
|
// IsFuture whether is future time
|
|
// 是否是未来时间
|
|
func (c Carbon) IsFuture() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToTimestamp() > c.Now().ToTimestamp()
|
|
}
|
|
|
|
// IsPast whether is past time
|
|
// 是否是过去时间
|
|
func (c Carbon) IsPast() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToTimestamp() < c.Now().ToTimestamp()
|
|
}
|
|
|
|
// IsLeapYear whether is a leap year
|
|
// 是否是闰年
|
|
func (c Carbon) IsLeapYear() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
year := c.Time.In(c.Loc).Year()
|
|
if year%400 == 0 || (year%4 == 0 && year%100 != 0) {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// IsLongYear whether is a long year, see https://en.wikipedia.org/wiki/ISO_8601#Week_dates
|
|
// 是否是长年
|
|
func (c Carbon) IsLongYear() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
_, w := time.Date(c.Year(), time.December, 31, 0, 0, 0, 0, c.Loc).ISOWeek()
|
|
return w == weeksPerLongYear
|
|
}
|
|
|
|
// IsJanuary whether is January
|
|
// 是否是一月
|
|
func (c Carbon) IsJanuary() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.January
|
|
}
|
|
|
|
// IsFebruary whether is February
|
|
// 是否是二月
|
|
func (c Carbon) IsFebruary() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.February
|
|
}
|
|
|
|
// IsMarch whether is March
|
|
// 是否是三月
|
|
func (c Carbon) IsMarch() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.March
|
|
}
|
|
|
|
// IsApril whether is April
|
|
// 是否是四月
|
|
func (c Carbon) IsApril() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.April
|
|
}
|
|
|
|
// IsMay whether is May
|
|
// 是否是五月
|
|
func (c Carbon) IsMay() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.May
|
|
}
|
|
|
|
// IsJune whether is June
|
|
// 是否是六月
|
|
func (c Carbon) IsJune() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.June
|
|
}
|
|
|
|
// IsJuly whether is July
|
|
// 是否是七月
|
|
func (c Carbon) IsJuly() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.July
|
|
}
|
|
|
|
// IsAugust whether is August
|
|
// 是否是八月
|
|
func (c Carbon) IsAugust() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.August
|
|
}
|
|
|
|
// IsSeptember whether is September
|
|
// 是否是九月
|
|
func (c Carbon) IsSeptember() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.September
|
|
}
|
|
|
|
// IsOctober whether is October
|
|
// 是否是十月
|
|
func (c Carbon) IsOctober() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.October
|
|
}
|
|
|
|
// IsNovember whether is November
|
|
// 是否是十一月
|
|
func (c Carbon) IsNovember() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.November
|
|
}
|
|
|
|
// IsDecember whether is December
|
|
// 是否是十二月
|
|
func (c Carbon) IsDecember() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Month() == time.December
|
|
}
|
|
|
|
// IsMonday whether is Monday
|
|
// 是否是周一
|
|
func (c Carbon) IsMonday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Monday
|
|
}
|
|
|
|
// IsTuesday whether is Tuesday
|
|
// 是否是周二
|
|
func (c Carbon) IsTuesday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Tuesday
|
|
}
|
|
|
|
// IsWednesday whether is Wednesday
|
|
// 是否是周三
|
|
func (c Carbon) IsWednesday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Wednesday
|
|
}
|
|
|
|
// IsThursday whether is Thursday
|
|
// 是否是周四
|
|
func (c Carbon) IsThursday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Thursday
|
|
}
|
|
|
|
// IsFriday whether is Friday
|
|
// 是否是周五
|
|
func (c Carbon) IsFriday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Friday
|
|
}
|
|
|
|
// IsSaturday whether is Saturday
|
|
// 是否是周六
|
|
func (c Carbon) IsSaturday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Saturday
|
|
}
|
|
|
|
// IsSunday whether is Sunday
|
|
// 是否是周日
|
|
func (c Carbon) IsSunday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.Time.In(c.Loc).Weekday() == time.Sunday
|
|
}
|
|
|
|
// IsWeekday whether is weekday
|
|
// 是否是工作日
|
|
func (c Carbon) IsWeekday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return !c.IsSaturday() && !c.IsSunday()
|
|
}
|
|
|
|
// IsWeekend whether is weekend
|
|
// 是否是周末
|
|
func (c Carbon) IsWeekend() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.IsSaturday() || c.IsSunday()
|
|
}
|
|
|
|
// IsYesterday whether is yesterday
|
|
// 是否是昨天
|
|
func (c Carbon) IsYesterday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToDateString() == Now().SubDay().ToDateString()
|
|
}
|
|
|
|
// IsToday whether is today
|
|
// 是否是今天
|
|
func (c Carbon) IsToday() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToDateString() == c.Now().ToDateString()
|
|
}
|
|
|
|
// IsTomorrow whether is tomorrow
|
|
// 是否是明天
|
|
func (c Carbon) IsTomorrow() bool {
|
|
if c.IsInvalid() {
|
|
return false
|
|
}
|
|
return c.ToDateString() == Now().AddDay().ToDateString()
|
|
}
|
|
|
|
// Compare comparison by a operator
|
|
// 时间比较
|
|
func (c Carbon) Compare(operator string, t Carbon) bool {
|
|
switch operator {
|
|
case "=":
|
|
return c.Eq(t)
|
|
case "<>":
|
|
return !c.Eq(t)
|
|
case "!=":
|
|
return !c.Eq(t)
|
|
case ">":
|
|
return c.Gt(t)
|
|
case ">=":
|
|
return c.Gte(t)
|
|
case "<":
|
|
return c.Lt(t)
|
|
case "<=":
|
|
return c.Lte(t)
|
|
}
|
|
return false
|
|
}
|
|
|
|
// Gt whether greater than
|
|
// 是否大于
|
|
func (c Carbon) Gt(t Carbon) bool {
|
|
return c.Time.After(t.Time)
|
|
}
|
|
|
|
// Lt whether less than
|
|
// 是否小于
|
|
func (c Carbon) Lt(t Carbon) bool {
|
|
return c.Time.Before(t.Time)
|
|
}
|
|
|
|
// Eq whether equal
|
|
// 是否等于
|
|
func (c Carbon) Eq(t Carbon) bool {
|
|
return c.Time.Equal(t.Time)
|
|
}
|
|
|
|
// Ne whether not equal
|
|
// 是否不等于
|
|
func (c Carbon) Ne(t Carbon) bool {
|
|
return !c.Eq(t)
|
|
}
|
|
|
|
// Gte whether greater than or equal
|
|
// 是否大于等于
|
|
func (c Carbon) Gte(t Carbon) bool {
|
|
return c.Gt(t) || c.Eq(t)
|
|
}
|
|
|
|
// Lte whether less than or equal
|
|
// 是否小于等于
|
|
func (c Carbon) Lte(t Carbon) bool {
|
|
return c.Lt(t) || c.Eq(t)
|
|
}
|
|
|
|
// Between whether between two Carbon instances, excluded the start and end Carbon instance
|
|
// 是否在两个时间之间(不包括这两个时间)
|
|
func (c Carbon) Between(start Carbon, end Carbon) bool {
|
|
if c.Gt(start) && c.Lt(end) {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// BetweenIncludedStart whether between two Carbon instances, included the start Carbon instance
|
|
// 是否在两个时间之间(包括开始时间)
|
|
func (c Carbon) BetweenIncludedStart(start Carbon, end Carbon) bool {
|
|
if c.Gte(start) && c.Lt(end) {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// BetweenIncludedEnd whether between two Carbon instances, included the end Carbon instance
|
|
// 是否在两个时间之间(包括结束时间)
|
|
func (c Carbon) BetweenIncludedEnd(start Carbon, end Carbon) bool {
|
|
if c.Gt(start) && c.Lte(end) {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// BetweenIncludedBoth whether between two Carbon instances, included the start and end Carbon instance
|
|
// 是否在两个时间之间(包括这两个时间)
|
|
func (c Carbon) BetweenIncludedBoth(start Carbon, end Carbon) bool {
|
|
if c.Gte(start) && c.Lte(end) {
|
|
return true
|
|
}
|
|
return false
|
|
}
|