Package net.dv8tion.jda.api.utils

Class TimeUtil

java.lang.Object

net.dv8tion.jda.api.utils.TimeUtil

public class TimeUtil
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static long	DISCORD_EPOCH
static long	TIMESTAMP_OFFSET

Constructor Summary

Constructors

Constructor	Description
TimeUtil()

Method Summary

Modifier and Type	Method	Description
static String	getDateTimeString(OffsetDateTime time)	Returns a prettier String-representation of a OffsetDateTime object
static 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.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DISCORD_EPOCH

public static final long DISCORD_EPOCH

See Also:

Constant Field Values

TIMESTAMP_OFFSET

public static final long TIMESTAMP_OFFSET

See Also:

Constant Field Values

Constructor Detail

TimeUtil

public TimeUtil()

Method Detail

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