Package net.dv8tion.jda.api.utils

Class TimeUtil

java.lang.Object
net.dv8tion.jda.api.utils.TimeUtil
public class TimeUtil extends Object
Utility for various time related features of the API.

  • Field Details

  • Constructor Details

    • TimeUtil

      public TimeUtil()

  • Method Details

    • getDiscordTimestamp

      public static long getDiscordTimestamp(long millisTimestamp)
      Converts the provided epoch millisecond timestamp to a Discord Snowflake.
      This can be used as a marker/pivot for MessageHistory creation.
      Parameters:
      millisTimestamp - The epoch millis to convert
      Returns:
      Shifted epoch millis for Discord

    • getTimeCreated

      @Nonnull public static OffsetDateTime getTimeCreated(long entityId)
      Gets the creation-time of a JDA-entity by doing the reverse snowflake algorithm on its id. This returns the creation-time of the actual entity on Discords side, not inside JDA.
      Parameters:
      entityId - The id of the JDA entity where the creation-time should be determined for
      Returns:
      The creation time of the JDA entity as OffsetDateTime

    • getTimeCreated

      @Nonnull public static OffsetDateTime getTimeCreated(@Nonnull ISnowflake entity)
      Gets the creation-time of a JDA-entity by doing the reverse snowflake algorithm on its id. This returns the creation-time of the actual entity on Discords side, not inside JDA.
      Parameters:
      entity - The JDA entity where the creation-time should be determined for
      Returns:
      The creation time of the JDA entity as OffsetDateTime
      Throws:
      IllegalArgumentException - If the provided entity is null

    • getDateTimeString

      @Nonnull public static String getDateTimeString(@Nonnull OffsetDateTime time)
      Returns a prettier String-representation of a OffsetDateTime object
      Parameters:
      time - The OffsetDateTime object to format
      Returns:
      The String of the formatted OffsetDateTime