timejuice

Documentation

Index

• Constants
• func GetFirstDayOfMonth(t time.Time) time.Time
• func GetFirstMondayOfYear(year int) time.Time
• func GetFirstPeriodStartDate(year int) time.Time
• func GetLastDayOfLastPeriod(year int) time.Time
• func GetMondayOfGivenPeriod(t time.Time) time.Time
• func GetPeriodNumber(t time.Time) int
• func GetSundayOfGivenPeriod(t time.Time) time.Time
• func GetTimeOfWeekday(t time.Time, targetWeekday time.Weekday) time.Time
• func IsUTCDate(d time.Time) bool
• func NowWithPrecision(precision time.Duration) time.Time
• func SwapTimezone(date time.Time, timezone string, toUTC bool) (time.Time, error)

Constants

const (
	SecondsInDay = 86400
)

Functions

func GetFirstDayOfMonth

func GetFirstDayOfMonth(t time.Time) time.Time

GetFirstDayOfMonth retrieves the first day of the month for the given date.

func GetFirstMondayOfYear

func GetFirstMondayOfYear(year int) time.Time

GetFirstMondayOfYear retrieves the first Monday of the given year.

func GetFirstPeriodStartDate

func GetFirstPeriodStartDate(year int) time.Time

GetFirstPeriodStartDate retrieves the date of the first day of the first period of a year.

Result will always be a Sunday.

func GetLastDayOfLastPeriod

func GetLastDayOfLastPeriod(year int) time.Time

GetLastDayOfLastPeriod retrieves the last day of the last period of year.

Result will always be a Saturday.

func GetMondayOfGivenPeriod

func GetMondayOfGivenPeriod(t time.Time) time.Time

GetMondayOfGivenPeriod retrieves the Monday of the week the given time.Time object is in.

func GetPeriodNumber

func GetPeriodNumber(t time.Time) int

GetPeriodNumber retrieves the period week number for the given date, from 1 trough 53.

func GetSundayOfGivenPeriod

func GetSundayOfGivenPeriod(t time.Time) time.Time

GetSundayOfGivenPeriod retrieves the Sunday of the week the given time.Time object is in.

func GetTimeOfWeekday

func GetTimeOfWeekday(t time.Time, targetWeekday time.Weekday) time.Time

GetTimeOfWeekday retrieves the time.Time value of the given weekday within the given time.Time object.

func IsUTCDate

func IsUTCDate(d time.Time) bool

IsUTCDate checks if the given date is in UTC format.

func NowWithPrecision

func NowWithPrecision(precision time.Duration) time.Time

NewWithPrecision returns a new now time.Time (UTC) with the given precision.

func SwapTimezone

func SwapTimezone(date time.Time, timezone string, toUTC bool) (time.Time, error)

SwapTimezone takes a date (which can be in any timezone) and returns the date in the specified timezone.

The original timezone is overridden by the new timezone.

This method does not perform any timezone conversion. It simply changes the timezone of the date.

If toUTC is true, the returned date is converted to UTC.