https://github.com/furdarius/date
A package to help you work with dates in Go.
https://github.com/furdarius/date
calendar date datetime go golang
Last synced: 4 days ago
JSON representation
A package to help you work with dates in Go.
- Host: GitHub
- URL: https://github.com/furdarius/date
- Owner: furdarius
- License: mit
- Created: 2018-08-23T08:05:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-12-03T11:41:31.000Z (about 7 years ago)
- Last Synced: 2024-12-06T19:46:41.189Z (about 1 year ago)
- Topics: calendar, date, datetime, go, golang
- Language: Go
- Homepage: https://godoc.org/github.com/furdarius/date
- Size: 15.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://godoc.org/github.com/furdarius/date)
[](https://travis-ci.org/furdarius/date)
[](https://goreportcard.com/report/github.com/furdarius/date)
# Date it easy
Small, user-friendly library to help you work with dates and dates ranges in Go. A time-zone-independent representation of time used that follows the rules of the proleptic Gregorian calendar with exactly 24-hour days, 60-minute hours, and 60-second minutes.
[Date](https://godoc.org/github.com/furdarius/date#Date) supports [SQL scan](https://godoc.org/github.com/furdarius/date#Date.Scan) and JSON [marshalling](https://godoc.org/github.com/furdarius/date#Date.MarshalText)/[unmarshalling](https://godoc.org/github.com/furdarius/date#Date.UnmarshalText) out of the box.
[Date](https://godoc.org/github.com/furdarius/date#Date) can be [parsed](https://godoc.org/github.com/furdarius/date#Parse) from string `start, err := date.Parse("2018-10-15")` or created manually `d := date.Date{2018, 10, 1}`.
Two [Dates](https://godoc.org/github.com/furdarius/date#Date) define [Range](https://godoc.org/github.com/furdarius/date#Range) `date.Range{date.Date{2018, 10, 1}, date.Date{2018, 10, 5}}`.
[RangeSet](https://godoc.org/github.com/furdarius/date#RangeSet) can be used to work with Ranges:
```go
ranges = date.RangeSet(ranges).
Filter(func(dr date.Range) bool {
return !dr.Empty()
}).
TrimEnd().
Sub(date.Range{date.Date{2018, 10, 1}, date.Date{2018, 10, 5}}).
ShiftEnd(5).
List()
```
## Install
```
go get github.com/furdarius/date
```
### Adding as dependency by "go dep"
```
$ dep ensure -add github.com/furdarius/date
```
## Usage
```go
start, _ := date.Parse("2018-10-15")
end, _ := date.Parse("2018-10-20")
interval1 := date.Range{start, end}
interval2 := date.Range{start, end.AddDays(-1)}
base := []date.Range{
date.Range{date.Date{2018, 10, 1}, date.Date{2018, 10, 5}},
date.Range{date.Date{2018, 10, 8}, date.Date{2018, 10, 22}},
}
ranges := date.RangeSet(base).Sub(interval).Impose(interval2).ExtendEnd().List()
```
## Contributing
Pull requests are very much welcomed. Make sure a test or example is included that covers your change and
your commits represent coherent changes that include a reason for the change.
Use `gometalinter` to check code with linters:
```
gometalinter -t --vendor
```