1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
|
# date
[](https://pkg.go.dev/github.com/rickb777/date)
[](https://travis-ci.org/rickb777/date/builds)
[](https://coveralls.io/github/rickb777/date?branch=master)
[](https://goreportcard.com/report/github.com/rickb777/date)
[](https://github.com/rickb777/date/issues)
Package `date` provides functionality for working with dates.
This package introduces a light-weight `Date` type that is storage-efficient
and convenient for calendrical calculations and date parsing and formatting
(including years outside the [0,9999] interval).
It also provides
* `clock.Clock` which expresses a wall-clock style hours-minutes-seconds with millisecond precision.
* `period.Period` which expresses a period corresponding to the ISO-8601 form (e.g. "PT30S").
* `timespan.DateRange` which expresses a period between two dates.
* `timespan.TimeSpan` which expresses a duration of time between two instants.
* `view.VDate` which wraps `Date` for use in templates etc.
See [package documentation](https://godoc.org/github.com/rickb777/date) for
full documentation and examples.
## Installation
go get -u github.com/rickb777/date
or
dep ensure -add github.com/rickb777/date
## Status
This library has been in reliable production use for some time. Versioning follows the well-known semantic version pattern.
## Credits
This package follows very closely the design of package
[`time`](http://golang.org/pkg/time/) in the standard library;
many of the `Date` methods are implemented using the corresponding methods
of the `time.Time` type and much of the documentation is copied directly
from that package.
The original [Good Work](https://github.com/fxtlabs/date) on which this was
based was done by Filippo Tampieri at Fxtlabs.
|