github.com/jjeffery/civil

Civil date and time

Package civil provides types for representing civil dates, and times.

Sometimes it is useful to be able to represent a date or time without reference to an instance in time within a timezone.

For example, when recording a person's date of birth all that is needed is a date. There is no requirement to specify an instant in time within a timezone.

There are also circumstances where an event will be scheduled for a date and time in the local timezone, whatever that may be. And example of this might be a schedule for taking medication.

Like the standard library time package, the civil package uses the proleptic Gregorian calendar for all calculations. The civil package makes use of the time package for all of its date-time calculations. Because some of this code is based on the standard time package, it has the identical license to the Go project.

For usage examples, refer to the GoDoc documentation.