Documentation ¶
Overview ¶
Package date provides time.Time derivatives that conform to the Swagger.io (https://swagger.io/) defined date formats: Date and DateTime. Both types may, in most cases, be used in lieu of time.Time types. And both convert to time.Time through a ToTime method.
Index ¶
- func ParseTime(format string, t string) (d time.Time, err error)
- func UnixEpoch() time.Time
- type Date
- func (d Date) MarshalBinary() ([]byte, error)
- func (d Date) MarshalJSON() (json []byte, err error)
- func (d Date) MarshalText() (text []byte, err error)
- func (d Date) String() string
- func (d Date) ToTime() time.Time
- func (d *Date) UnmarshalBinary(data []byte) error
- func (d *Date) UnmarshalJSON(data []byte) (err error)
- func (d *Date) UnmarshalText(data []byte) (err error)
- type Time
- func (t Time) MarshalBinary() ([]byte, error)
- func (t Time) MarshalJSON() (json []byte, err error)
- func (t Time) MarshalText() (text []byte, err error)
- func (t Time) String() string
- func (t Time) ToTime() time.Time
- func (t *Time) UnmarshalBinary(data []byte) error
- func (t *Time) UnmarshalJSON(data []byte) (err error)
- func (t *Time) UnmarshalText(data []byte) (err error)
- type TimeRFC1123
- func (t TimeRFC1123) MarshalBinary() ([]byte, error)
- func (t TimeRFC1123) MarshalJSON() ([]byte, error)
- func (t TimeRFC1123) MarshalText() ([]byte, error)
- func (t TimeRFC1123) String() string
- func (t TimeRFC1123) ToTime() time.Time
- func (t *TimeRFC1123) UnmarshalBinary(data []byte) error
- func (t *TimeRFC1123) UnmarshalJSON(data []byte) (err error)
- func (t *TimeRFC1123) UnmarshalText(data []byte) (err error)
- type UnixTime
- func (t UnixTime) Duration() time.Duration
- func (t UnixTime) MarshalBinary() ([]byte, error)
- func (t UnixTime) MarshalJSON() ([]byte, error)
- func (t UnixTime) MarshalText() ([]byte, error)
- func (t *UnixTime) UnmarshalBinary(raw []byte) error
- func (t *UnixTime) UnmarshalJSON(text []byte) error
- func (t *UnixTime) UnmarshalText(raw []byte) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Date ¶
Date defines a type similar to time.Time but assumes a layout of RFC3339 full-date (i.e., 2006-01-02).
func (Date) MarshalBinary ¶
MarshalBinary preserves the Date as a byte array conforming to RFC3339 full-date (i.e., 2006-01-02).
func (Date) MarshalJSON ¶
MarshalJSON preserves the Date as a JSON string conforming to RFC3339 full-date (i.e., 2006-01-02).
func (Date) MarshalText ¶
MarshalText preserves the Date as a byte array conforming to RFC3339 full-date (i.e., 2006-01-02).
func (Date) String ¶
String returns the Date formatted as an RFC3339 full-date string (i.e., 2006-01-02).
func (*Date) UnmarshalBinary ¶
UnmarshalBinary reconstitutes a Date saved as a byte array conforming to RFC3339 full-date (i.e., 2006-01-02).
func (*Date) UnmarshalJSON ¶
UnmarshalJSON reconstitutes the Date from a JSON string conforming to RFC3339 full-date (i.e., 2006-01-02).
func (*Date) UnmarshalText ¶
UnmarshalText reconstitutes a Date saved as a byte array conforming to RFC3339 full-date (i.e., 2006-01-02).
type Time ¶
Time defines a type similar to time.Time but assumes a layout of RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (Time) MarshalBinary ¶
MarshalBinary preserves the Time as a byte array conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (Time) MarshalJSON ¶
MarshalJSON preserves the Time as a JSON string conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (Time) MarshalText ¶
MarshalText preserves the Time as a byte array conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (Time) String ¶
String returns the Time formatted as an RFC3339 date-time string (i.e., 2006-01-02T15:04:05Z).
func (*Time) UnmarshalBinary ¶
UnmarshalBinary reconstitutes a Time saved as a byte array conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (*Time) UnmarshalJSON ¶
UnmarshalJSON reconstitutes the Time from a JSON string conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
func (*Time) UnmarshalText ¶
UnmarshalText reconstitutes a Time saved as a byte array conforming to RFC3339 date-time (i.e., 2006-01-02T15:04:05Z).
type TimeRFC1123 ¶
TimeRFC1123 defines a type similar to time.Time but assumes a layout of RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (TimeRFC1123) MarshalBinary ¶
func (t TimeRFC1123) MarshalBinary() ([]byte, error)
MarshalBinary preserves the Time as a byte array conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (TimeRFC1123) MarshalJSON ¶
func (t TimeRFC1123) MarshalJSON() ([]byte, error)
MarshalJSON preserves the Time as a JSON string conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (TimeRFC1123) MarshalText ¶
func (t TimeRFC1123) MarshalText() ([]byte, error)
MarshalText preserves the Time as a byte array conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (TimeRFC1123) String ¶
func (t TimeRFC1123) String() string
String returns the Time formatted as an RFC1123 date-time string (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (TimeRFC1123) ToTime ¶
func (t TimeRFC1123) ToTime() time.Time
ToTime returns a Time as a time.Time
func (*TimeRFC1123) UnmarshalBinary ¶
func (t *TimeRFC1123) UnmarshalBinary(data []byte) error
UnmarshalBinary reconstitutes a Time saved as a byte array conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (*TimeRFC1123) UnmarshalJSON ¶
func (t *TimeRFC1123) UnmarshalJSON(data []byte) (err error)
UnmarshalJSON reconstitutes the Time from a JSON string conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
func (*TimeRFC1123) UnmarshalText ¶
func (t *TimeRFC1123) UnmarshalText(data []byte) (err error)
UnmarshalText reconstitutes a Time saved as a byte array conforming to RFC1123 date-time (i.e., Mon, 02 Jan 2006 15:04:05 MST).
type UnixTime ¶
UnixTime marshals and unmarshals a time that is represented as the number of seconds (ignoring skip-seconds) since the Unix Epoch.
func NewUnixTimeFromDuration ¶
NewUnixTimeFromDuration creates a UnixTime as a duration of time since the UnixEpoch.
func NewUnixTimeFromNanoseconds ¶
NewUnixTimeFromNanoseconds creates a UnixTime as a number of nanoseconds from the UnixEpoch.
func NewUnixTimeFromSeconds ¶
NewUnixTimeFromSeconds creates a UnixTime as a number of seconds from the UnixEpoch.
func (UnixTime) MarshalBinary ¶
MarshalBinary converts a UnixTime into a binary.LittleEndian float64 of nanoseconds since the epoch.
func (UnixTime) MarshalJSON ¶
MarshalJSON preserves the UnixTime as a JSON number conforming to Unix Timestamp requirements. (i.e. the number of seconds since midnight January 1st, 1970 not considering leap seconds.)
func (UnixTime) MarshalText ¶
MarshalText stores the number of seconds since the Unix Epoch as a textual floating point number.
func (*UnixTime) UnmarshalBinary ¶
UnmarshalBinary converts a from a binary.LittleEndian float64 of nanoseconds since the epoch into a UnixTime.
func (*UnixTime) UnmarshalJSON ¶
UnmarshalJSON reconstitures a UnixTime saved as a JSON number of the number of seconds since midnight January 1st, 1970.
func (*UnixTime) UnmarshalText ¶
UnmarshalText populates a UnixTime with a value stored textually as a floating point number of seconds since the Unix Epoch.