org.thales.punch.libraries.utils.api

Class UtilTime

java.lang.Object

org.thales.punch.libraries.utils.api.UtilTime

public class UtilTime
extends Object

Method Summary

Modifier and Type	Method and Description
static ZonedDateTime	earliestOf(Collection<ZonedDateTime> datetimes)
static ZonedDateTime	earliestOf(ZonedDateTime a, ZonedDateTime b)
static long	elapsedDurationSeconds(String timestamp)
static ZonedDateTime	getDate(String date) Extract an iso date.
static String	getShortDate(long ms) Given 1573272121048 you will get "2019-11-09-05h02"
static String	getShortDate(ZonedDateTime zdt) Given a ZonedDateTime returns a suffix like "2019-11-09-05h02"
static ZonedDateTime	latestOf(Collection<ZonedDateTime> datetimes)
static ZonedDateTime	latestOf(ZonedDateTime a, ZonedDateTime b)
static String	now()
static ZonedDateTime	parseDateWithDefaultFormatter(String date) Parse a date with the default ISO date time formatter.
static ZonedDateTime	toZonedDateTime(String timestamp)

Methods inherited from class java.lang.Object

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

Method Detail

earliestOf

public static ZonedDateTime earliestOf(ZonedDateTime a,
                                       ZonedDateTime b)

Parameters:

a - the first date

b - the second date

Returns:

"earliest" of the two dates, ignoring null dates. Return null if both are null.

latestOf

public static ZonedDateTime latestOf(ZonedDateTime a,
                                     ZonedDateTime b)

Parameters:

a - the first date

b - the second date

Returns:

"latest" of the two dates, ignoring null dates. Return null if both are null.

earliestOf

public static ZonedDateTime earliestOf(Collection<ZonedDateTime> datetimes)

Parameters:

datetimes - the dates collection

Returns:

earliest of all dates in collection, ignoring null dates. Return null if all are null

latestOf

public static ZonedDateTime latestOf(Collection<ZonedDateTime> datetimes)

Parameters:

datetimes - the dates collection

Returns:

latest of all dates in collection, ignoring null dates. Return null if all are null

now

public static String now()

Returns:

a correct iso utc string to represent the current time.

elapsedDurationSeconds

public static long elapsedDurationSeconds(String timestamp)

Parameters:

an - iso timestamp

Returns:

the elapsed duration compared to now

getShortDate

public static String getShortDate(long ms)

Given 1573272121048 you will get "2019-11-09-05h02"

Parameters:

ms - a long timestamp

Returns:

a short date string

getShortDate

public static String getShortDate(ZonedDateTime zdt)

Given a ZonedDateTime returns a suffix like "2019-11-09-05h02"

Parameters:

zdt - a ZonedDateTime

Returns:

a suffix

getDate

public static ZonedDateTime getDate(String date)

Extract an iso date. Also accept '-2d', '-3w' short relative notation.

Parameters:

date - date

Returns:

the corresponding ZonedDateTime

toZonedDateTime

public static ZonedDateTime toZonedDateTime(String timestamp)

Parameters:

timestamp - a valid timstamp, formatted in UTC, i.e: 2020-06-16T13:01:10.442Z

Returns:

a ZonedDateTime

parseDateWithDefaultFormatter

public static ZonedDateTime parseDateWithDefaultFormatter(String date)

Parse a date with the default ISO date time formatter.

Parameters:

date - a date

Returns:

a ZonedDateTime