README
¶
date - dates as Julian Days with methods to make them easy to work with - Golang
Install:
go get github.com/muir/date
Date
Go has a very nice time package. Using times for dates is a bit awkward for a number of reasons.
Using YYYY-MM-DD strings as dates is easy to work read, but hard to manipulate.
Using Julian Days is efficient and date math is super easy, but they're not human readable.
This package makes Julian Days human readable by providing a .String()
method and by implementing encoding.TextMarshaler and encoding.TextUnmarshaler
so that dates look great when used as map keys and as values.
Database convience is provided by implementations of sql.Valuer and sql.Scanner
Development status
This is brand new code. It has tests, but it isn't used anywhere yet.
Documentation
¶
Index ¶
- Constants
- type Date
- func (d Date) AddDate(years int, months int, days int) Date
- func (d Date) Format(format string) string
- func (d Date) IsZero() bool
- func (d Date) JD() int
- func (d Date) MarshalText() ([]byte, error)
- func (d *Date) Scan(src interface{}) error
- func (d Date) String() string
- func (d1 Date) Sub(d2 Date) int
- func (d Date) Time() time.Time
- func (d *Date) UnmarshalText(text []byte) error
- func (d Date) Value() (driver.Value, error)
Constants ¶
const Zero = Date(0)
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Date ¶
type Date int
Date represents a date using a Julian Day that has been wrapped with methods to make it easy to use and easy to work with. Potentially the structure of Date could change in the future for performance reasons. The internal structure is guaranteed to remain compatible for use as a map key and remain comparable for < = >.
func FromString ¶
FromString parses dates in the format YYYY-MM-DD The empty string becomes the zero date.
func MustFromString ¶
func (Date) MarshalText ¶
MarshalText implements encoding.TextMarshaler so that dates look good in JSON map keys and other places.
func (*Date) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler
Source Files