dateutils

Documentation

Index

• func AddBusinessDays(t time.Time, days int) time.Time
• func AfterOrEqual(milestone time.Time, date time.Time) bool
• func Age(birthdate time.Time) int
• func AgeAt(birthdate, at time.Time) int
• func BeforeOrEqual(milestone time.Time, date time.Time) bool
• func Ceil(t time.Time) time.Time
• func DaysBetween(start, end time.Time) int
• func DaysInMonth(t time.Time) int
• func EndOfDay(t time.Time) time.Time
• func EndOfWeek(t time.Time) time.Time
• func Floor(t time.Time) time.Time
• func GetFirstDayOfMonth() time.Time
• func GetFirstDayOfMonthFor(date time.Time) time.Time
• func GetLastDayOfMonth() time.Time
• func GetLastDayOfMonthFor(date time.Time) time.Time
• func IsSameDay(a, b time.Time) bool
• func IsSameMonth(a, b time.Time) bool
• func IsWeekday(t time.Time) bool
• func IsWeekend(t time.Time) bool
• func MustParseDate(date string) time.Time
• func MustParseDateWithLayout(date string, layout string) time.Time
• func Overlap(start1 time.Time, end1 time.Time, start2 time.Time, end2 time.Time) bool
• func ParseDate(date string, fallback time.Time) time.Time
• func ParseDateWithLayout(date string, layout string, fallback time.Time) time.Time
• func StartOfDay(t time.Time) time.Time
• func StartOfWeek(t time.Time) time.Time

Functions

func AddBusinessDays

func AddBusinessDays(t time.Time, days int) time.Time

AddBusinessDays adds the specified number of business days to the given time. Business days are Monday through Friday, skipping weekends. Negative values subtract business days.

func AfterOrEqual

func AfterOrEqual(milestone time.Time, date time.Time) bool

AfterOrEqual returns true if date is after or equal to milestone.

Deprecated: Use the standard library comparison helpers directly:

!date.Before(milestone)

func Age

func Age(birthdate time.Time) int

Age calculates the age in years from the given birthdate to now.

func AgeAt

func AgeAt(birthdate, at time.Time) int

AgeAt calculates the age in years from the given birthdate to the specified date.

func BeforeOrEqual

func BeforeOrEqual(milestone time.Time, date time.Time) bool

BeforeOrEqual returns true if date is before or equal to milestone.

Deprecated: Use the standard library comparison helpers directly:

!date.After(milestone)

func Ceil

func Ceil(t time.Time) time.Time

Ceil - takes a datetime and return a datetime from the same day at 23:59:59 (UTC).

func DaysBetween

func DaysBetween(start, end time.Time) int

DaysBetween returns the number of days between two dates. The result is negative if end is before start.

func DaysInMonth

func DaysInMonth(t time.Time) int

DaysInMonth returns the number of days in the month of the given time.

func EndOfDay

func EndOfDay(t time.Time) time.Time

EndOfDay returns the end of the day (23:59:59.999999999) for the given time in its timezone.

func EndOfWeek

func EndOfWeek(t time.Time) time.Time

EndOfWeek returns the end of the week (Saturday at 23:59:59.999999999) for the given time.

func Floor

func Floor(t time.Time) time.Time

Floor - takes a datetime and return a datetime from the same day at 00:00:00 (UTC).

func GetFirstDayOfMonth

func GetFirstDayOfMonth() time.Time

GetFirstDayOfMonth returns the first day of the current month at 00:00:00 in the local timezone.

func GetFirstDayOfMonthFor

func GetFirstDayOfMonthFor(date time.Time) time.Time

GetFirstDayOfMonthFor returns the first day of the month for the given date at 00:00:00 in the date's timezone.

func GetLastDayOfMonth

func GetLastDayOfMonth() time.Time

GetLastDayOfMonth returns the last day of the current month at 23:59:59 in the local timezone.

func GetLastDayOfMonthFor

func GetLastDayOfMonthFor(date time.Time) time.Time

GetLastDayOfMonthFor returns the last day of the month for the given date at 23:59:59 in the date's timezone.

func IsSameDay

func IsSameDay(a, b time.Time) bool

IsSameDay returns true if both times are on the same day (same year, month, and day).

func IsSameMonth

func IsSameMonth(a, b time.Time) bool

IsSameMonth returns true if both times are in the same month (same year and month).

func IsWeekday

func IsWeekday(t time.Time) bool

IsWeekday returns true if the given time is on a weekday (Monday through Friday).

func IsWeekend

func IsWeekend(t time.Time) bool

IsWeekend returns true if the given time is on a weekend (Saturday or Sunday).

func MustParseDate

func MustParseDate(date string) time.Time

MustParseDate parses a date string in RFC3339 format. Panics if parsing fails.

func MustParseDateWithLayout

func MustParseDateWithLayout(date string, layout string) time.Time

MustParseDateWithLayout parses a date string using the specified layout. Panics if parsing fails.

func Overlap

func Overlap(start1 time.Time, end1 time.Time, start2 time.Time, end2 time.Time) bool

Overlap - returns true if two date intervals overlap.

func ParseDate

func ParseDate(date string, fallback time.Time) time.Time

ParseDate parses a date string in RFC3339 format. If parsing fails, returns the fallback value.

func ParseDateWithLayout

func ParseDateWithLayout(date string, layout string, fallback time.Time) time.Time

ParseDateWithLayout parses a date string using the specified layout. If parsing fails, returns the fallback value.

func StartOfDay

func StartOfDay(t time.Time) time.Time

StartOfDay returns the start of the day (00:00:00) for the given time in its timezone.

func StartOfWeek

func StartOfWeek(t time.Time) time.Time

StartOfWeek returns the start of the week (Sunday at 00:00:00) for the given time.