dates

Documentation

Index

• func As(t time.Time, location *time.Location) time.Time
• func EndOfDay(t time.Time) time.Time
• func EndOfMonth(t time.Time) time.Time
• func EndOfYear(t time.Time) time.Time
• func TimeToTime(t time.Time, duration string, location *time.Location) (time.Time, error)
• func ToTime(duration string, location *time.Location) (time.Time, error)

Functions

func As

func As(t time.Time, location *time.Location) time.Time

As returns the T as if it was read in the location originally. It is similar to time.In except this function treats the input as zone less. Input of 6pm will become 6pm in the new location.

func EndOfDay

func EndOfDay(t time.Time) time.Time

func EndOfMonth

func EndOfMonth(t time.Time) time.Time

func EndOfYear

func EndOfYear(t time.Time) time.Time

func TimeToTime

func TimeToTime(t time.Time, duration string, location *time.Location) (time.Time, error)

TimeToTime parses an offset duration string. The calculation is based on an optional anchor (default is the passed in time) plus an offset duration. Valid Anchors:

EOD will calculate the end of day
EOM will calculate the end of month
EOY will calculate end of year

A duration string is a number and unit suffix, such as "300m", "1.5h" or "2h45m". Valid time units are "m", "h". If location is provided, calculations are set to the corresponding time zone. Examples:

"EOD+72h" = end of day in 3 days
"3h" = 3 hours
"EOY" = end of year
"30m" = 30 minutes
"" = now

func ToTime

func ToTime(duration string, location *time.Location) (time.Time, error)

ToTime parses an offset duration string. The calculation is based on an optional anchor (default is NOW) plus an offset duration.

shortcut for TimeToTime(time.Now()).