README
¶
date.Date
Represents dates with values from January 1, 0001 Anno Domini (Common Era) through December 31, 9999 A.D (C.E) in Gregorian calendar. date.Date represents number of days since January 1, 001.
Installation
date.Date is compatible with modern Go releases in module mode, with Go installed:
go get github.com/tomaspavlic/date
date.Date vs time.Time
time.Time consists of wall and ext encode the wall time seconds, wall time nanoseconds, and optional monotonic clock reading in nanoseconds. time.Time also contains time.Location. The overall size of the struct is 24 bytes. Working in date.Date is reduced to just be just single int64 therefore 1/3 of time.Time size.
Usage
import "github.com/tomaspavlic/date"
// Create date.Date by just year, month and day
someDate := date.Create(2000, 1, 1)
// `date.Date` has similar functions as build-in `time.Time`
numberOfDays := date.Since(someDate)
fmt.Println("Number of days since 2000-01-01:", numberOfDays)
License
This library is distributed under the MIT license found in the LICENSE file.
Documentation
¶
Index ¶
- func Since(d Date) int64
- type Date
- func (d Date) AddDate(years int, months int, days int) Date
- func (d Date) AddDays(value int) Date
- func (d Date) After(u Date) bool
- func (d Date) Before(u Date) bool
- func (d Date) Day() int
- func (d Date) Equal(u Date) bool
- func (d Date) Month() time.Month
- func (d Date) String() string
- func (d Date) Sub(u Date) int
- func (d Date) ToTime(hour, min, sec, nsec int, loc *time.Location) time.Time
- func (d Date) Weekday() time.Weekday
- func (d Date) Year() int
- func (d Date) YearDay() int
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Date ¶
type Date int64
Represents dates with values from January 1, 0001 Anno Domini (Common Era) through December 31, 9999 A.D (C.E) in Gregorian calendar.
func Parse ¶
Parse parses a formatted string and returns the date value it represents. See the documentation for the constant called Layout to see how to represent the format. The second argument must be parseable using the format string (layout) provided as the first argument.
func (Date) AddDate ¶
AddDate returns the date corresponding to adding the given number of years, months, and days to t. For example, AddDate(-1, 2, 3) applied to January 1, 2011 returns March 4, 2010.
AddDate normalizes its result in the same way that Date does, so, for example, adding one month to October 31 yields December 1, the normalized form for November 31.
Source Files