Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

date

package module

Go to main page

Versions in this module

v0

v0.0.5

Oct 7, 2026

Changes in this version

+ func AddBusinessDays(t time.Time, n int, holidays []time.Time) time.Time

+ func AgeDetailed(birthDate, targetDate time.Time) (years, months, days int)

+ func AgeDetailedToNow(birthDate time.Time) (years, months, days int)

+ func BeginningOfWeek(date time.Time) time.Time

+ func BeginningOfYear(date time.Time) time.Time

+ func BusinessDaysBetween(a, b time.Time, holidays []time.Time) int

+ func CalendarWeeks(year int, month time.Month) [][]time.Time

+ func Clamp(t, minT, maxT time.Time) time.Time

+ func ConvertTZ(t time.Time, to string) (time.Time, error)

+ func DayOfYear(t time.Time) int

+ func DaysInMonth(year int, month time.Month) int

+ func DaysSince(t time.Time) int

+ func DaysUntil(t time.Time) int

+ func EasterDate(year int) time.Time

+ func EndOfDay(t time.Time) time.Time

+ func EndOfQuarter(t time.Time) time.Time

+ func EndOfWeek(t time.Time, startDay ...time.Weekday) time.Time

+ func EndOfYear(t time.Time) time.Time

+ func Format(t time.Time, layout string) string

+ func FormatDate(t time.Time) string

+ func FormatDateTime(t time.Time) string

+ func FormatDateTimeMs(t time.Time) string

+ func FormatDuration(d time.Duration, short bool) string

+ func FormatHuman(t time.Time) string

+ func FormatHumanTime(t time.Time) string

+ func FormatRFC3339(t time.Time) string

+ func FormatRFC3339Nano(t time.Time) string

+ func GuessTimezone(abbr string) (string, bool)

+ func HumanizeDuration(d time.Duration) string

+ func IsHoliday(t time.Time, holidays []time.Time) bool

+ func IsSameDay(a, b time.Time) bool

+ func IsSameMonth(a, b time.Time) bool

+ func IsSameWeek(a, b time.Time) bool

+ func IsSameYear(a, b time.Time) bool

+ func IsValidTimezone(zone string) bool

+ func IsWeekday(t time.Time) bool

+ func IsWeekend(t time.Time) bool

+ func LastWeekdayOfMonth(year int, month time.Month, weekday time.Weekday) time.Time

+ func LoadLocation(zone string) (*time.Location, error)

+ func LocalToUTC(t time.Time) time.Time

+ func MonthName(m time.Month) string

+ func MonthsBetween(a, b time.Time) int

+ func NthWeekdayOfMonth(year int, month time.Month, weekday time.Weekday, n int) time.Time

+ func Ordinal(n int) string

+ func ParseDuration(s string) (time.Duration, error)

+ func ParseInTimezone(s, zone string) (time.Time, error)

+ func ParseTimestamp(v int64) time.Time

+ func ParseTimestampString(s string) (time.Time, error)

+ func Quarter(t time.Time) int

+ func RelativeTime(t, ref time.Time) string

+ func RoundDuration(d, unit time.Duration) time.Duration

+ func ShortMonthName(m time.Month) string

+ func ShortWeekdayName(w time.Weekday) string

+ func StartOfDay(t time.Time) time.Time

+ func StartOfMonth(t time.Time) time.Time

+ func StartOfQuarter(t time.Time) time.Time

+ func StartOfWeek(t time.Time, startDay ...time.Weekday) time.Time

+ func StartOfYear(t time.Time) time.Time

+ func TimestampPrecisionOf(v int64) string

+ func TimezoneOffset(zone string, t time.Time) (int, error)

+ func ToUnix(t time.Time) int64

+ func ToUnixMicro(t time.Time) int64

+ func ToUnixMilli(t time.Time) int64

+ func ToUnixNano(t time.Time) int64

+ func TruncateDuration(d, unit time.Duration) time.Duration

+ func UTCToLocal(t time.Time) time.Time

+ func UnixMicroToTime(us int64) time.Time

+ func UnixMilliToTime(ms int64) time.Time

+ func UnixNanoToTime(ns int64) time.Time

+ func UnixToTime(unix int64) time.Time

+ func WeekNumber(t time.Time) int

+ func WeekdayName(w time.Weekday) string

+ func WeeksBetween(a, b time.Time) int

+ type DateDiff struct

+ Days int

+ Hours int

+ Minutes int

+ Months int

+ Seconds int

+ Weeks int

+ Years int

+ func DiffDetailed(from, to time.Time) DateDiff

+ type DateRange struct

+ End time.Time

+ Start time.Time

+ func NewDateRange(start, end time.Time) (DateRange, error)

+ func NewDateRangeFromDuration(start time.Time, d time.Duration) DateRange

+ func (r DateRange) BusinessDays(holidays []time.Time) []time.Time

+ func (r DateRange) Contains(t time.Time) bool

+ func (r DateRange) Days() int

+ func (r DateRange) Duration() time.Duration

+ func (r DateRange) Each(fn func(time.Time) bool)

+ func (r DateRange) EachMonth(fn func(time.Time) bool)

+ func (r DateRange) Extend(d time.Duration) DateRange

+ func (r DateRange) Intersect(other DateRange) (DateRange, bool)

+ func (r DateRange) IsEmpty() bool

+ func (r DateRange) Overlaps(other DateRange) bool

+ func (r DateRange) Shift(d time.Duration) DateRange

+ func (r DateRange) Split(d time.Duration) []DateRange

+ func (r DateRange) Union(other DateRange) DateRange

v0.0.4

Jun 24, 2024

Changes in this version

+ const ExprTypeClock12Hour

+ const ExprTypeClock24Hour

+ const ExprTypeDate

+ const ExprTypeInvalid

+ const ExprTypeNow

+ const ExprTypeRelativeDays

+ const ExprTypeRelativeHours

+ const ExprTypeRelativeMinutes

+ const ExprTypeRelativeMonth

+ const ExprTypeRelativeWeekdays

+ const ExprTypeRelativeWeeks

+ const ExprTypeRelativeYear

+ const ExprTypeTime

+ const Timezone

+ func BeginningOfMonth(date time.Time) time.Time

+ func Calculate(startTime, endTime time.Time) int

+ func CalculateToNow(givenTime time.Time) int

+ func EndOfMonth(date time.Time) time.Time

+ func EnglishToNepali(year int, month int, day int) (*[3]int, error)

+ func GetCurrentEnglishTime() time.Time

+ func GetNepaliLocation() *time.Location

+ func IsLeapYear(givenYear int) bool

+ func NepaliToEnglish(year int, month int, day int) (*[3]int, error)

+ func NextLeapYear(givenYear int) (foundYear int, found bool)

+ func Pretty(pretty bool) func(*gparser) error

+ func PrevLeapYear(givenYear int) (foundYear int, found bool)

+ func Size(size int) func(*gparser) error

+ func TimeElapsed(now time.Time, then time.Time, full bool) string

+ type Direction int

+ const Future

+ const Past

+ type ExprType int

+ func ParseNaturalDate(s string, ref time.Time, options ...Option) (time.Time, ExprType, error)

+ func (t ExprType) IsDateOnly() bool

+ func (t ExprType) IsTimeOnly() bool

+ type NepaliFormatter struct

+ func NewFormatter(nepaliTime *NepaliTime) *NepaliFormatter

+ func (obj *NepaliFormatter) Format(format string) (string, error)

+ type NepaliMonthData struct

+ type NepaliTime struct

+ func Date(year, month, day, hour, min, sec, nsec int) (*NepaliTime, error)

+ func FromEnglishTime(englishTime time.Time) (*NepaliTime, error)

+ func Now() *NepaliTime

+ func ParseNP(datetimeStr string, format string) (*NepaliTime, error)

+ func (obj *NepaliTime) Clock() (hour, min, sec int)

+ func (obj *NepaliTime) Date() (year, month, day int)

+ func (obj *NepaliTime) Day() int

+ func (obj *NepaliTime) Format(format string) (string, error)

+ func (obj *NepaliTime) GetEnglishTime() time.Time

+ func (obj *NepaliTime) Hour() int

+ func (obj *NepaliTime) Minute() int

+ func (obj *NepaliTime) Month() int

+ func (obj *NepaliTime) Nanosecond() int

+ func (obj *NepaliTime) Second() int

+ func (obj *NepaliTime) String() string

+ func (obj *NepaliTime) Weekday() time.Weekday

+ func (obj *NepaliTime) Year() int

+ type Option func(*gparser)

+ func WithDirection(d Direction) Option

v0.0.3

Jun 22, 2024

v0.0.2

Jun 22, 2024

Changes in this version

+ var ErrAmbiguousMMDD = fmt.Errorf("this date has ambiguous mm/dd vs dd/mm type format")

+ var ErrCouldntFindFormat = fmt.Errorf("could not find format for")

+ var ErrFracSecTooLong = fmt.Errorf("fractional seconds too long")

+ var ErrUnexpectedTail = fmt.Errorf("unexpected content after date/time: ")

+ var ErrUnknownTZOffset = fmt.Errorf("TZ offset not recognized")

+ var ErrUnknownTimeZone = fmt.Errorf("timezone not recognized")

+ func MustParse(datestr string, opts ...ParserOption) time.Time

+ func Parse(datestr string, opts ...ParserOption) (time.Time, error)

+ func ParseFormat(datestr string, opts ...ParserOption) (string, error)

+ func ParseIn(datestr string, loc *time.Location, opts ...ParserOption) (time.Time, error)

+ func ParseLocal(datestr string, opts ...ParserOption) (time.Time, error)

+ func ParseStrict(datestr string, opts ...ParserOption) (time.Time, error)

+ type ParserOption func(*parser) error

+ func AllowPartialStringMatch(allowPartialStringMatch bool) ParserOption

+ func PreferMonthFirst(preferMonthFirst bool) ParserOption

+ func RetryAmbiguousDateWithSwap(retryAmbiguousDateWithSwap bool) ParserOption

+ func SimpleErrorMessages(simpleErrorMessages bool) ParserOption