doc.go

// Copyright 2015 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Package date provides functionality for working with dates.
// It implements 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).
//
// Subpackages provide:
//
// * `clock.Clock` which expresses a wall-clock style hours-minutes-seconds with millisecond precision.
//
// * `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.
//
// # 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.
//
// # References
//
// https://golang.org/src/time/time.go
//
// https://en.wikipedia.org/wiki/Gregorian_calendar
//
// https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar
//
// https://en.wikipedia.org/wiki/Astronomical_year_numbering
//
// https://en.wikipedia.org/wiki/ISO_8601
//
// https://tools.ietf.org/html/rfc822
//
// https://tools.ietf.org/html/rfc850
//
// https://tools.ietf.org/html/rfc1123
//
// https://tools.ietf.org/html/rfc3339
package date