Using Calends in Golang

Calends exposes a very small handful of things for use outside the library itself. One is the Calends class, documented here, which should be the only interface users of the library ever need to touch.

Another thing Calends exposes is the calendars.TAI64NARUXTime class, used to store and manipulate the instants of time which make up a Calends instance. The rest are interfaces for extending the library’s functionality. These are covered in the Custom Calendars in Golang section.

참고

Calends objects are immutable - all methods return a new Calends object where they might otherwise alter the current one. This is true even of the Calends.Set* methods. This has the side effect of using more memory to perform manipulations than updating values on an existing object would. It makes many operations safer, though, than mutable objects would allow.

Calends

The main entry point to Calends and its functionality. Calends objects should only be created with the Create function, and never directly (especially given its values are all unexported ones).

Create

func Create(value interface, calendar string, format string) (Calends, error)
매개변수

  • value (interface{}) – The value to parse the date(s)/time(s) from.

  • calendar (string) – The calendar system to parse the date(s)/time(s) with.

  • format (string) – The format the date(s)/time(s) is/are expected to use.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Creates a new Calends object, using calendar to select a calendar system, and format to parse the contents of value into the Calends object’s internal instants. The type of value can vary based on the calendar system itself, but generally speaking can always be a string.

In any case, the value can always be a map[string]interface{}, where the keys are any two of start, end, and duration. If all three are provided, duration is ignored in favor of calculating it directly. If only one of the listed keys is provided, value is passed to the calendar system itself unchanged.

The calendar system then converts value to a calendars.TAI64NARUXTime instant, which the Calends object sets to the appropriate internal value.

Read

func (Calends) Date(calendar string, format string) (string, error)
매개변수

  • calendar (string) – The calendar system to format the date/time with.

  • format (string) – The format the date/time is expected to be in.

반환

The start date of the Calends object

반환 형식

string

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Retrieves the start date of the Calends object as a string. The value is generated by the calendar system given in calendar, according to the format string in format.

func (Calends) EndDate(calendar string, format string) (string, error)
매개변수

  • calendar (string) – The calendar system to format the date/time with.

  • format (string) – The format the date/time is expected to be in.

반환

The end date of the Calends object

반환 형식

string

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Retrieves the end date of the Calends object as a string. The value is generated by the calendar system given in calendar, according to the format string in format.

func (Calends) Duration() → Float
반환

The duration of the Calends object

반환 형식

math/big.(*Float)

Retrieves the duration of the Calends object as an arbitrary-precision floating point number. This value will be 0 if the Calends object is an instant.

Update

func (Calends) SetDate(stamp interface, calendar string, format string) (Calends, error)
매개변수

  • value (interface{}) – The value to parse the date/time from.

  • calendar (string) – The calendar system to parse the date/time with.

  • format (string) – The format the date/time is expected to use.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Sets the start date of a Calends object, based on the Calends object’s current value. The inputs are the same as for Create, above, except the string → value map option isn’t available, since you’re already specifically setting the start value explicitly.

func (Calends) SetEndDate(stamp interface, calendar string, format string) (Calends, error)
매개변수

  • value (interface{}) – The value to parse the date/time from.

  • calendar (string) – The calendar system to parse the date/time with.

  • format (string) – The format the date/time is expected to use.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Sets the end date of a Calends object, based on the Calends object’s current value. The inputs are the same as for Create, above, except the string → value map option isn’t available, since you’re already specifically setting the end value explicitly.

func (Calends) SetDuration(duration interface, calendar string) (Calends, error)
매개변수

  • duration (interface{}) – The value to parse the new duration from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Sets the duration of a Calends object, by adjusting its end point, and using the current start point as an anchor. The duration value is interpreted by the calendar system given in calendar, so is subject to any of its rules.

func (Calends) SetDurationFromEnd(duration interface, calendar string) (Calends, error)
매개변수

  • duration (interface{}) – The value to parse the new duration from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Sets the duration of a Calends object, by adjusting its start point, and using the current end point as an anchor. The duration value is interpreted by the calendar system given in calendar, so is subject to any of its rules.

Manipulate

func (Calends) Add(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Increases the end date of the Calends object’s current value by offset, as interpreted by the calendar system given in calendar.

func (Calends) AddFromEnd(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Increases the start date of the Calends object’s current value by offset, as interpreted by the calendar system given in calendar.

func (Calends) Subtract(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Works the same as Add, except it decreases the start date, rather than increasing it.

func (Calends) SubtractFromEnd(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Works the same as AddFromEnd, except it decreases the end date, rather than increasing it.

func (Calends) Next(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Returns a Calends object of offset duration (as interpreted by the calendar system given in calendar), which abuts the Calends object’s current value. If offset is empty, calendar is ignored, and the current object’s duration is used instead.

func (Calends) Previous(offset interface, calendar string) (Calends, error)
매개변수

  • offset (interface{}) – The value to parse the offset from.

  • calendar (string) – The calendar system to parse the date/time with.

반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Returns a Calends object of offset duration (as interpreted by the calendar system given in calendar), which abuts the Calends object’s current value. If offset is empty, calendar is ignored, and the current object’s duration is used instead.

Combine

func (Calends) Merge(c2 Calends) (Calends, error)
매개변수
반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Returns a Calends object spanning from the earliest start date to the latest end date between the current Calends object and c2.

func (Calends) Intersect(c2 Calends) (Calends, error)
매개변수
반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Returns a Calends object spanning the overlap between the current Calends object and c2. If the current object and c2 don’t overlap, returns an error.

func (Calends) Gap(c2 Calends) (Calends, error)
매개변수
반환

A new Calends object

반환 형식

Calends

반환

error when an error occurs; nil otherwise

반환 형식

error or nil

Returns a Calends object spanning the gap between the current Calends object and c2. If the current object and c2 overlap (and there is, therefore, no gap to return), returns an error.

Compare

func (Calends) Difference(c2 Calends, mode string) → Float
매개변수

  • c2 (Calends) – The Calends object to compare.

  • mode (string) – The comparison mode.

반환

The difference, as an arbitrary-precision floating point number

반환 형식

math/big.Float

Returns the difference of the current Calends object minus c2, using mode to select which values to use in the calculation. Valid modes include:

  • start - use the start date of both the current object and c2

  • duration - use the duration of both the current object and c2

  • end - use the end date of both the current object and c2

  • start-end - use the start of the current object, and the end of c2

  • end-start - use the end of the current object, and the start of c2

func (Calends) Compare(c2 Calends, mode string) → int
매개변수

  • c2 (Calends) – The Calends object to compare.

  • mode (string) – The comparison mode.

반환

A standard comparison result

반환 형식

int

Returns -1 if the current Calends object is less than c2, 0 if they are equal, and 1 if the current object is greater than c2, using mode to select which values to use in the comparison. Valid modes are the same as for (Calends) Difference, above.

func (Calends) Contains(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the current Calends object contains all of c2.

func (Calends) Overlaps(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the current Calends object overlaps with c2.

func (Calends) Abuts(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the current Calends object abuts c2 (that is, whether one begins at the same instant the other ends).

func (Calends) IsSame(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the current Calends object covers the same span of time as c2.

func (Calends) IsShorter(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the duration of the current Calends object and c2.

func (Calends) IsSameDuration(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the duration of the current Calends object and c2.

func (Calends) IsLonger(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the duration of the current Calends object and c2.

func (Calends) IsBefore(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the entirety of the current Calends object with the start date of c2.

func (Calends) StartsBefore(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the start date of the current Calends object with the start date of c2.

func (Calends) EndsBefore(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the end date of the current Calends object with the start date of c2.

func (Calends) IsDuring(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the entirety of the current Calends object lies between the start and end dates of c2.

func (Calends) StartsDuring(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the start date of the current Calends object lies between the start and end dates of c2.

func (Calends) EndsDuring(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Checks whether the end date of the current Calends object lies between the start and end dates of c2.

func (Calends) IsAfter(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the entirety of the current Calends object with the end date of c2.

func (Calends) StartsAfter(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the start date of the current Calends object with the end date of c2.

func (Calends) EndsAfter(c2 Calends) → bool
매개변수
반환

The result of the comparison

반환 형식

bool

Compares the end date of the current Calends object with the end date of c2.

Export

func (Calends) String() → string
반환

The string representation of the current value.

반환 형식

string

Implements the fmt.Stringer interface.

func (Calends) MarshalText() ([]byte, error)
반환

A byte slice containing the marshalled text.

반환 형식

[]byte

반환

Any error that occurs.

반환 형식

error

Implements the encoding.TextMarshaler interface.

func (*Calends) UnmarshalText(in []byte) → error
매개변수

  • in ([]byte) – A byte slice containing the marshalled text.

반환

Any error that occurs.

반환 형식

error

Implements the encoding.TextUnmarshaler interface.

func (Calends) MarshalJSON() ([]byte, error)
반환

A byte slice containing the marshalled JSON.

반환 형식

[]byte

반환

Any error that occurs.

반환 형식

error

Implements the encoding/json.Marshaler interface.

func (*Calends) UnmarshalJSON(in []byte) → error
매개변수

  • in ([]byte) – A byte slice containing the marshalled JSON.

반환

Any error that occurs.

반환 형식

error

Implements the encoding/json.Unmarshaler interface.