Skip to main content
Version: v0.2.2

Date/Time Helpers

Methods

SubtractYears

Description: Subtracts a specified number of years from a given time.

Parameters:

  • t (time.Time): The original time from which to subtract years.
  • years (int): The number of years to subtract.

Returns: (time.Time): The resulting time after subtracting the specified number of years.


SubtractDays

Description: Subtracts a specified number of days from a given time.

Parameters:

  • t (time.Time): The original time from which days are subtracted.
  • days (int): The number of days to subtract.

Returns: (time.Time): The resulting time after subtracting the specified number of days.


SubtractHours

Description: Subtracts a specified number of hours from a given time.

Parameters:

  • t (time.Time): The original time from which hours are subtracted.
  • hours (int): The number of hours to subtract.

Returns: (time.Time): The resulting time after subtracting the specified number of hours.


SubtractMinutes

Description: Subtracts a specified number of minutes from a given time.

Parameters:

  • t (time.Time): The original time from which minutes are subtracted.
  • minutes (int): The number of minutes to subtract.

Returns: (time.Time): The resulting time after subtracting the specified number of minutes.


SubtractSeconds

Description: Subtracts a specified number of seconds from a given time.

Parameters:

  • t (time.Time): The original time from which seconds are subtracted.
  • seconds (int): The number of seconds to subtract.

Returns: (time.Time): The resulting time after subtracting the specified number of seconds.


AddYears

Description: Adds a specified number of years to a given time.

Parameters:

  • t (time.Time): The original time to which years are added.
  • years (int): The number of years to add.

Returns: (time.Time): The resulting time after adding the specified number of years.


AddDays

Description: Adds a specified number of days to a given time.

Parameters:

  • t (time.Time): The original time to which days are added.
  • days (int): The number of days to add.

Returns: (time.Time): The resulting time after adding the specified number of days.


AddHours

Description: Adds a specified number of hours to a given time.

Parameters:

  • t (time.Time): The original time to which hours are added.
  • hours (int): The number of hours to add.

Returns: (time.Time): The resulting time after adding the specified number of hours.


AddMinutes

Description: Adds a specified number of minutes to a given time.

Parameters:

  • t (time.Time): The original time to which minutes are added.
  • minutes (int): The number of minutes to add.

Returns: (time.Time): The resulting time after adding the specified number of minutes.


AddSeconds

Description: Adds a specified number of seconds to a given time.

Parameters:

  • t (time.Time): The original time to which seconds are added.
  • seconds (int): The number of seconds to add.

Returns: (time.Time): The resulting time after adding the specified number of seconds.


TimeSince

Description: Calculates the time duration that has elapsed since the given time and returns it in a human-readable format.

Parameters:

  • t (time.Time): The original time for which the duration is calculated.

Returns: (string): A human-readable representation of the elapsed time, such as "now", "x seconds ago", "x minutes ago", etc.


currentTime

Description: Returns the current time in UTC format.

Returns: (time.Time): The current time in UTC.


formattedCurrentTime

Description: Returns the current time formatted according to the specified format.

Parameters:

  • format (string): The desired format string for the time representation.

Returns: (string): The current time formatted as specified.


TimeUTC

Description: Returns the current time in UTC format.

Returns: (time.Time): The current UTC time.


TimeDate

Description: Returns the current time formatted as "2006-01-02 15:04:05".

Returns: (string): The current time as a formatted string.


TimeWithMilliseconds

Description: Returns the current time with milliseconds, formatted as "15:04:05.000".

Returns: (string): The current time as a formatted string including milliseconds.


Time

Description: Returns the current time formatted as "15:04:05".

Returns: (string): The current time as a formatted string.


Date

Description: Returns the current date formatted as "2006.01.02".

Returns: (string): The current date as a formatted string.


Year

Description: Returns the current year formatted as "2006".

Returns: (string): The current year as a formatted string.


Day

Description: Returns the current day of the week formatted as "Monday".

Returns: (string): The current day of the week as a formatted string.


TimeDateDay

Description: Returns the formatted current time using the format "2006-01-02 15:04:05 Monday".

Returns: (string): The current time and day as a formatted string.


ParseDateTime

Description: Parses the given date string and returns the corresponding time.Time value. Returns a zero value if the string is not in a valid format.

Parameters:

  • dateStr (string): The date string to be parsed.

Returns: (time.Time): The time value corresponding to the parsed date string, or a zero time value if the format is invalid.


GetDifference

Description: Calculates the time difference between two given times in various units (seconds, minutes, hours, days, years).

Parameters:

  • time1 (time.Time): The start time.
  • time2 (time.Time): The end time.

Returns: (TimeDiff): A struct containing the time differences in various units.