Package net.dv8tion.jda.api.utils
Class TimeUtil
java.lang.Object
net.dv8tion.jda.api.utils.TimeUtil
-
Field Summary
Modifier and TypeFieldDescriptionstatic final long
static final long
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic String
Returns a prettier String-representation of a OffsetDateTime objectstatic long
getDiscordTimestamp
(long millisTimestamp) Converts the provided epoch millisecond timestamp to a Discord Snowflake.static OffsetDateTime
getTimeCreated
(long entityId) Gets the creation-time of a JDA-entity by doing the reverse snowflake algorithm on its id.static OffsetDateTime
getTimeCreated
(ISnowflake entity) Gets the creation-time of a JDA-entity by doing the reverse snowflake algorithm on its id.
-
Field Details
-
DISCORD_EPOCH
public static final long DISCORD_EPOCH- See Also:
-
TIMESTAMP_OFFSET
public static final long TIMESTAMP_OFFSET- See Also:
-
-
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 forMessageHistory
creation.- Parameters:
millisTimestamp
- The epoch millis to convert- Returns:
- Shifted epoch millis for Discord
-
getTimeCreated
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
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 isnull
-
getDateTimeString
Returns a prettier String-representation of a OffsetDateTime object- Parameters:
time
- The OffsetDateTime object to format- Returns:
- The String of the formatted OffsetDateTime
-