io.sentry.core

Class DateUtils

java.lang.Object

io.sentry.core.DateUtils

@ApiStatus.Internal
public final class DateUtils
extends java.lang.Object

Utilities to deal with dates

Method Summary

Modifier and Type	Method and Description
static @NotNull java.util.Date	getCurrentDateTime() Get the current date and time as ISO UTC
static @Nullable java.util.Date	getCurrentDateTimeOrNull() Get the current date and time as ISO UTC or null if not available
static @NotNull java.util.Date	getDateTime(@NotNull java.util.Date date) Converts the given Date and time to UTC timezone
static @NotNull java.util.Date	getDateTime(@NotNull java.lang.String timestamp) Get Java Date from UTC timestamp format
static @NotNull java.util.Date	getDateTimeWithMillisPrecision(@NotNull java.lang.String timestamp) Get Java Date from millis timestamp format
static @NotNull java.lang.String	getTimestamp(@NotNull java.util.Date date) Get date formatted as expected by Sentry.
static @NotNull java.lang.String	getTimestampIsoFormat(@NotNull java.util.Date date) Get date formatted as expected by Sentry.

Methods inherited from class java.lang.Object

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

Method Detail

getTimestampIsoFormat

@NotNull
public static @NotNull java.lang.String getTimestampIsoFormat(@NotNull
                                                                       @NotNull java.util.Date date)

Get date formatted as expected by Sentry.

Parameters:

date - the current date with local timezone

Returns:

the ISO formatted UTC date with millis precision.

getCurrentDateTime

@NotNull
public static @NotNull java.util.Date getCurrentDateTime()
                                                           throws java.lang.IllegalArgumentException

Get the current date and time as ISO UTC

Returns:

the ISO UTC date and time

Throws:

java.lang.IllegalArgumentException

getCurrentDateTimeOrNull

@Nullable
public static @Nullable java.util.Date getCurrentDateTimeOrNull()
                                                                   throws java.lang.IllegalArgumentException

Get the current date and time as ISO UTC or null if not available

Returns:

the ISO UTC date and time or null

Throws:

java.lang.IllegalArgumentException

getDateTime

@NotNull
public static @NotNull java.util.Date getDateTime(@NotNull
                                                           @NotNull java.lang.String timestamp)
                                                    throws java.lang.IllegalArgumentException

Get Java Date from UTC timestamp format

Parameters:

timestamp - UTC format eg 2000-12-31T23:59:58Z or 2000-12-31T23:59:58.123Z

Returns:

the Date

Throws:

java.lang.IllegalArgumentException

getDateTimeWithMillisPrecision

@NotNull
public static @NotNull java.util.Date getDateTimeWithMillisPrecision(@NotNull
                                                                              @NotNull java.lang.String timestamp)
                                                                       throws java.lang.IllegalArgumentException

Get Java Date from millis timestamp format

Parameters:

timestamp - millis format eg 1581410911.988 (1581410911 seconds and 988 millis)

Returns:

the Date UTC timezone

Throws:

java.lang.IllegalArgumentException

getTimestamp

@NotNull
public static @NotNull java.lang.String getTimestamp(@NotNull
                                                              @NotNull java.util.Date date)

Get date formatted as expected by Sentry.

Parameters:

date - already UTC format

Returns:

the ISO formatted date with millis precision.

getDateTime

@NotNull
public static @NotNull java.util.Date getDateTime(@NotNull
                                                           @NotNull java.util.Date date)
                                                    throws java.lang.IllegalArgumentException

Converts the given Date and time to UTC timezone

Parameters:

date - the Date with local timezone

Returns:

the Date UTC timezone

Throws:

java.lang.IllegalArgumentException