date

Documentation

Index

• Constants
• Variables
• type Date
  • func From(t time.Time) Date
  • func New(year int, month time.Month, day int) Date
  • func Parse(s string) (Date, bool)
  • func Today() Date
  • func (d Date) Add(duration time.Duration) Date
  • func (d Date) AddDate(years int, months int, days int) Date
  • func (d Date) AddDays(days int) Date
  • func (d Date) After(other Date) bool
  • func (d Date) Before(other Date) bool
  • func (d Date) Day() int
  • func (d Date) Equal(other Date) bool
  • func (d Date) Format(layout string) string
  • func (d Date) IsZero() bool
  • func (d Date) MarshalBSONValue() (bsontype.Type, []byte, error)
  • func (d Date) MarshalJSON() ([]byte, error)
  • func (d Date) Min(other Date) Date
  • func (d Date) Month() time.Month
  • func (d Date) NonZeroMin(other Date) Date
  • func (d Date) Time() time.Time
  • func (d *Date) UnmarshalBSONValue(t bsontype.Type, data []byte) error
  • func (d *Date) UnmarshalJSON(b []byte) error
  • func (d Date) Weekday() time.Weekday
  • func (d Date) Year() int

Constants

const RFC3339Date = `2006-01-02`

const RFC3339DateJSON = `"` + RFC3339Date + `"`

Variables

var ErrInvalidDate = errors.New("invalid date")

Types

type Date

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

Date represents a date without time. It is a wrapper around time.Time.

func From

func From(t time.Time) Date

From returns a new date from the given time. The time is truncated to the day.

func New

func New(year int, month time.Month, day int) Date

New returns a new date with the given year, month and day.

func Parse

func Parse(s string) (Date, bool)

Parse parses a date in RFC3339 format (yyyy-mm-dd).

func Today

func Today() Date

Today returns the current date in UTC. It is a convenience function for From(time.Now()). It is equivalent to the current day at 00:00 time.

func (Date) Add

func (d Date) Add(duration time.Duration) Date

Add returns the date with the given duration added. Only the date part is used, the time part is ignored.

func (Date) AddDate

func (d Date) AddDate(years int, months int, days int) Date

AddDate returns the date with the given number of years, months and days added. To subtract, use negative values.

func (Date) AddDays

func (d Date) AddDays(days int) Date

AddDays returns the date with the given number of days added. To subtract, use negative values.

func (Date) After

func (d Date) After(other Date) bool

After reports whether the date is after the other.

func (Date) Before

func (d Date) Before(other Date) bool

Before reports whether the date is before the other.

func (Date) Day

func (d Date) Day() int

Day returns the day of the date.

func (Date) Equal

func (d Date) Equal(other Date) bool

Equal reports whether the date is equal to the other.

func (Date) Format

func (d Date) Format(layout string) string

Format returns a textual representation of the date in the provided format.

func (Date) IsZero

func (d Date) IsZero() bool

IsZero returns true if the date is the zero value. January 1, year 1, UTC

func (Date) MarshalBSONValue

func (d Date) MarshalBSONValue() (bsontype.Type, []byte, error)

func (Date) MarshalJSON

func (d Date) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface. Converts to "yyyy-MMM-dd" format.

func (Date) Min

func (d Date) Min(other Date) Date

func (Date) Month

func (d Date) Month() time.Month

Month returns the month of the date.

func (Date) NonZeroMin

func (d Date) NonZeroMin(other Date) Date

func (Date) Time

func (d Date) Time() time.Time

Time returns the time.Time representation of the date.

func (*Date) UnmarshalBSONValue

func (d *Date) UnmarshalBSONValue(t bsontype.Type, data []byte) error

func (*Date) UnmarshalJSON

func (d *Date) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the json.Unmarshaler interface. Converts from "yyyy-MMM-dd" format.

func (Date) Weekday

func (d Date) Weekday() time.Weekday

Weekday returns the day of the week specified by the date. Sunday is day 0.

func (Date) Year

func (d Date) Year() int

Year returns the year of the date.