io.inbot.datemath

Class DateMath

java.lang.Object

io.inbot.datemath.DateMath

public class DateMath
extends Object

Utility class to assist with parsing iso timestamps or expressions that manipulate such timestamps to a java.time.Instant.

Field Summary

Fields

Modifier and Type	Field and Description
static java.time.Instant	AT_0AD 1st of January, 0 AD at 00:00 UTC
static java.time.Instant	AT_EPOCH 1st of January 1970 at 00:00 UTC if you are going to use a min date, this is a safe default unless you want to deal with negative epoch millis/seconds
static java.time.Instant	AT_Y10K 31st of December, 9999 at 00:00 UTC, gives you some wiggle room to adjust to later timezones without getting 5 digits in the year.
static java.time.Instant	AT_Y2K 1st of January, 2000 at 00:00 UTC
static java.time.Instant	AT_Y2K38 The latest time that can be represented in Unix's signed 32-bit integer time format is 03:14:07 UTC on Tuesday, 19 January 2038 (2,147,483,647 seconds after 1 January 1970) https://en.wikipedia.org/wiki/Year_2038_problem

Constructor Summary

Constructors

Constructor and Description
DateMath()

Method Summary

Modifier and Type	Method and Description
static String	formatIsoDate(java.time.Instant date) Use this instead of Instant.toString() to ensure you always end up with the same pattern instead of 'smartly' loosing fractionals depending on what time it is.
static String	formatIsoDate(java.time.LocalDate date)
static String	formatIsoDate(java.time.LocalDateTime time)
static String	formatIsoDate(long timeInMillisSinceEpoch)
static String	formatIsoDate(java.time.OffsetDateTime date)
static String	formatIsoDateNoMs(java.time.Instant date)
static String	formatIsoDateNow()
static String	formatSimpleIsoTimestamp(java.time.Instant instant)
static boolean	isValid(String text)
static java.time.Instant	now()
static java.time.Instant	parse(String text)
static java.time.Instant	parse(String text, String zoneId)
static String	renderMonthYear(java.time.Instant t, java.time.ZoneId zoneId, Locale locale)
static String	renderWeekYear(java.time.Instant t, java.time.ZoneId zoneId, Locale locale)
static java.time.Instant	toInstant(java.time.LocalDate date)
static java.time.Instant	toInstant(java.time.LocalDateTime dateTime)

Methods inherited from class java.lang.Object

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

Field Detail

AT_EPOCH

public static final java.time.Instant AT_EPOCH

1st of January 1970 at 00:00 UTC if you are going to use a min date, this is a safe default unless you want to deal with negative epoch millis/seconds

AT_0AD

public static final java.time.Instant AT_0AD

1st of January, 0 AD at 00:00 UTC

AT_Y2K

public static final java.time.Instant AT_Y2K

1st of January, 2000 at 00:00 UTC

AT_Y2K38

public static final java.time.Instant AT_Y2K38

The latest time that can be represented in Unix's signed 32-bit integer time format is 03:14:07 UTC on Tuesday, 19 January 2038 (2,147,483,647 seconds after 1 January 1970) https://en.wikipedia.org/wiki/Year_2038_problem

AT_Y10K

public static final java.time.Instant AT_Y10K

31st of December, 9999 at 00:00 UTC, gives you some wiggle room to adjust to later timezones without getting 5 digits in the year.

Constructor Detail

DateMath

public DateMath()

Method Detail

now

public static java.time.Instant now()

Returns:

now or the parsed Instant for whatever custom expression is configured

formatIsoDate

public static String formatIsoDate(java.time.OffsetDateTime date)

formatIsoDateNow

public static String formatIsoDateNow()

formatIsoDate

public static String formatIsoDate(java.time.LocalDate date)

formatSimpleIsoTimestamp

public static String formatSimpleIsoTimestamp(java.time.Instant instant)

formatIsoDate

public static String formatIsoDate(java.time.LocalDateTime time)

formatIsoDate

public static String formatIsoDate(java.time.Instant date)

Use this instead of Instant.toString() to ensure you always end up with the same pattern instead of 'smartly' loosing fractionals depending on what time it is.

Parameters:

date - an instant

Returns:

iso instant of the form "1974-10-20T00:00:00.000Z" with 3 fractionals, always.

formatIsoDateNoMs

public static String formatIsoDateNoMs(java.time.Instant date)

formatIsoDate

public static String formatIsoDate(long timeInMillisSinceEpoch)

isValid

public static boolean isValid(String text)

parse

public static java.time.Instant parse(String text)

Parameters:

text -

Returns:

Instant; any relative expressions are interpreted to be in the UTC timezone.

parse

public static java.time.Instant parse(String text,
                                      String zoneId)

toInstant

public static java.time.Instant toInstant(java.time.LocalDate date)

toInstant

public static java.time.Instant toInstant(java.time.LocalDateTime dateTime)

renderWeekYear

public static String renderWeekYear(java.time.Instant t,
                                    java.time.ZoneId zoneId,
                                    Locale locale)

renderMonthYear

public static String renderMonthYear(java.time.Instant t,
                                     java.time.ZoneId zoneId,
                                     Locale locale)