Skip to main content
Version: Next

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.