Package org.ametys.core.util

Class DateUtils

java.lang.Object

org.ametys.core.util.DateUtils

public final class DateUtils
extends Object

Helper for converting dates from the old (Date) to the new (java.time) JDK Special thanks to http://stackoverflow.com/questions/21242110/convert-java-util-date-to-java-time-localdate#answer-27378709 which inspired this code See also http://stackoverflow.com/questions/19431234/converting-between-java-time-localdatetime-and-java-util-date

Field Summary

Fields

Modifier and Type	Field	Description
private static DateTimeFormatter	__ISO_OFFSET_DATE_TIME	The ISO date-time formatter that formats or parses a date-time with an offset, such as '2011-12-03T10:15:30.000+01:00'.
static String	ISO_OFFSET_DATE_TIME_PATTERN	The ISO date-time pattern that formats or parses a date-time with an offset

Constructor Summary

Constructors

Modifier	Constructor	Description
private	DateUtils()

Method Summary

Modifier and Type	Method	Description
private static DateTimeFormatter	_createFormatter(String pattern)
static Calendar	asCalendar(LocalDate localDate)	Converts this LocalDate object to a Calendar.
static Calendar	asCalendar(ZonedDateTime zonedDateTime)	Converts this ZonedDateTime object to a Calendar.
static Date	asDate(LocalDate localDate)	Converts this LocalDate object to a Date.
static Date	asDate(LocalDate localDate, ZoneId zone)	Converts this LocalDate object to a Date.
static Date	asDate(LocalDateTime localDateTime)	Converts this LocalDateTime object to a Date.
static Date	asDate(LocalDateTime localDateTime, ZoneId zone)	Converts this LocalDateTime object to a Date.
static Date	asDate(ZonedDateTime zonedDateTime)	Converts this ZonedDateTime object to a Date.
static Instant	asInstant(Date date)	Converts this Date object to an Instant.
static LocalDate	asLocalDate(Calendar calendar)	Converts this Calendar object to a LocalDate.
static LocalDate	asLocalDate(Date date)	Converts this Date object to a LocalDate.
static LocalDate	asLocalDate(Date date, ZoneId zone)	Converts this Date object to a LocalDate.
static LocalDateTime	asLocalDateTime(Date date)	Converts this Date object to a LocalDateTime.
static LocalDateTime	asLocalDateTime(Date date, ZoneId zone)	Converts this Date object to a LocalDateTime.
static ZonedDateTime	asZonedDateTime(long epochMilli)	Converts this epoch time to a ZonedDateTime.
static ZonedDateTime	asZonedDateTime(long epochMilli, ZoneId zone)	Converts this epoch time to a ZonedDateTime.
static ZonedDateTime	asZonedDateTime(Calendar calendar)	Converts this Calendar object to a ZonedDateTime.
static ZonedDateTime	asZonedDateTime(Date date, ZoneId zone)	Converts this Date object to a ZonedDateTime.
static String	dateToString(Date value)	Converts a Date object to String using the ISO date formatter
static String	epochMilliToString(long epochMilli)	Converts this epoch time to a String using the ISO date formatter
static String	formatDuration(long duration)	Format a duration for logs
static String	formatDuration(Duration duration)	Format a duration for logs
private static String	formatNumber(long number, int nbNumbers)
static DateTimeFormatter	getISODateTimeFormatter()	Get the ISO date-time formatter that formats or parses a date-time with an offset, such as '2011-12-03T10:15:30.000+01:00'.
static String	localDateToString(LocalDate localDate)	Converts a LocalDate object to String using the ISO date formatter
static Date	parse(String value)	Parses a String into a Date, using ISO 8601 format.
static LocalDate	parseLocalDate(String localDateAsString)	Parses a String into a LocalDate, using ISO date formatter.
static ZonedDateTime	parseZonedDateTime(String zonedDateTimeAsString)	Parses a String into a ZonedDateTime, using ISO date formatter.
static String	zonedDateTimeToString(ZonedDateTime zonedDateTime)	Converts a ZonedDateTime object to String using the ISO date formatter
static String	zonedDateTimeToString(ZonedDateTime zonedDateTime, ZoneId zoneId, String pattern)	Converts a ZonedDateTime object to String using the given pattern for formatting, in the given zone, so as to format the instant in another zone For instance, if provided pattern is 'uuuu-MM-dd'T'HH:mm:ss.SSSXXX': for UTC zone, the zone date time corresponding to '2011-12-03T11:15:30+01:00' will be formatted as '2011-12-03T10:15:30Z' for +02:00 zone, the zone date time corresponding to '2011-12-03T11:15:30+01:00' will be formatted as '2011-12-03T12:15:30+02:00'

Methods inherited from class java.lang.Object

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

Field Detail

ISO_OFFSET_DATE_TIME_PATTERN

public static final String ISO_OFFSET_DATE_TIME_PATTERN

The ISO date-time pattern that formats or parses a date-time with an offset

See Also:

Constant Field Values

__ISO_OFFSET_DATE_TIME

private static final DateTimeFormatter __ISO_OFFSET_DATE_TIME

The ISO date-time formatter that formats or parses a date-time with an offset, such as '2011-12-03T10:15:30.000+01:00'.

Constructor Detail

DateUtils

private DateUtils()

Method Detail

_createFormatter

private static DateTimeFormatter _createFormatter(String pattern)
                                           throws IllegalArgumentException

Throws:

IllegalArgumentException

asInstant

public static Instant asInstant(Date date)

Converts this Date object to an Instant.

Parameters:

date - The date object

Returns:

an instant representing the same point on the time-line as this Date object

asZonedDateTime

public static ZonedDateTime asZonedDateTime(Date date,
                                            ZoneId zone)

Converts this Date object to a ZonedDateTime.

Parameters:

date - The date object

zone - The zone. If null, the system default zone id is used

Returns:

the ZonedDateTime formed from this Date

asZonedDateTime

public static ZonedDateTime asZonedDateTime(Calendar calendar)

Converts this Calendar object to a ZonedDateTime.

Parameters:

calendar - the calendar

Returns:

the ZonedDateTime formed from this Calendar

asZonedDateTime

public static ZonedDateTime asZonedDateTime(long epochMilli)

Converts this epoch time to a ZonedDateTime.

Parameters:

epochMilli - the number of milliseconds from 1970-01-01T00:00:00Z

Returns:

the ZonedDateTime formed from this epoch time

asZonedDateTime

public static ZonedDateTime asZonedDateTime(long epochMilli,
                                            ZoneId zone)

Converts this epoch time to a ZonedDateTime.

Parameters:

epochMilli - the number of milliseconds from 1970-01-01T00:00:00Z

zone - the time-zone

Returns:

the ZonedDateTime formed from this epoch time

asLocalDate

public static LocalDate asLocalDate(Date date,
                                    ZoneId zone)

Converts this Date object to a LocalDate. This returns a LocalDate with the same year, month and day as this Date.

Parameters:

date - The date object

zone - The zone

Returns:

the LocalDate part of this Date

asLocalDate

public static LocalDate asLocalDate(Date date)

Converts this Date object to a LocalDate. This returns a LocalDate with the same year, month and day as this Date.

Parameters:

date - The date object

Returns:

the LocalDate part of this Date

asLocalDate

public static LocalDate asLocalDate(Calendar calendar)

Converts this Calendar object to a LocalDate.

Parameters:

calendar - the calendar

Returns:

the LocalDate object

asLocalDateTime

public static LocalDateTime asLocalDateTime(Date date,
                                            ZoneId zone)

Converts this Date object to a LocalDateTime. This returns a LocalDateTime with the same year, month, day and time as this Date.

Parameters:

date - The date object

zone - The zone

Returns:

the LocalDateTime part of this Date

asLocalDateTime

public static LocalDateTime asLocalDateTime(Date date)

Converts this Date object to a LocalDateTime. This returns a LocalDateTime with the same year, month, day and time as this Date.

Parameters:

date - The date object

Returns:

the LocalDateTime part of this Date

asDate

public static Date asDate(LocalDate localDate)

Converts this LocalDate object to a Date.

Parameters:

localDate - The local date object

Returns:

the Date part of this LocalDate

asDate

public static Date asDate(LocalDate localDate,
                          ZoneId zone)

Converts this LocalDate object to a Date.

Parameters:

localDate - The local date object

zone - The zone

Returns:

the Date part of this LocalDate

asDate

public static Date asDate(LocalDateTime localDateTime)

Converts this LocalDateTime object to a Date.

Parameters:

localDateTime - The local date time object

Returns:

the Date part of this LocalDateTime

asDate

public static Date asDate(LocalDateTime localDateTime,
                          ZoneId zone)

Converts this LocalDateTime object to a Date.

Parameters:

localDateTime - The local date time object

zone - The zone

Returns:

the Date part of this LocalDateTime

asDate

public static Date asDate(ZonedDateTime zonedDateTime)

Converts this ZonedDateTime object to a Date.

Parameters:

zonedDateTime - The local date time object

Returns:

the Date part of this LocalDateTime

asCalendar

public static Calendar asCalendar(ZonedDateTime zonedDateTime)

Converts this ZonedDateTime object to a Calendar.

Parameters:

zonedDateTime - the zoned date time

Returns:

the Calendar object

asCalendar

public static Calendar asCalendar(LocalDate localDate)

Converts this LocalDate object to a Calendar.

Parameters:

localDate - the local date

Returns:

the Calendar object

formatDuration

public static String formatDuration(Duration duration)

Format a duration for logs

Parameters:

duration - duration to log

Returns:

a string representing the duration

formatDuration

public static String formatDuration(long duration)

Format a duration for logs

Parameters:

duration - miliseconds representing the duration

Returns:

a string representing the duration

formatNumber

private static String formatNumber(long number,
                                   int nbNumbers)

getISODateTimeFormatter

public static DateTimeFormatter getISODateTimeFormatter()

Get the ISO date-time formatter that formats or parses a date-time with an offset, such as '2011-12-03T10:15:30.000+01:00'. This formatter is similar to DateTimeFormatter.ISO_OFFSET_DATE_TIME but force 3-digits milliseconds.

Returns:

ISO date-time formatter

dateToString

public static String dateToString(Date value)

Converts a Date object to String using the ISO date formatter

Parameters:

value - the value to convert

Returns:

the date as a String

epochMilliToString

public static String epochMilliToString(long epochMilli)

Converts this epoch time to a String using the ISO date formatter

Parameters:

epochMilli - the number of milliseconds from 1970-01-01T00:00:00Z

Returns:

the epoch time to a String

zonedDateTimeToString

public static String zonedDateTimeToString(ZonedDateTime zonedDateTime)

Converts a ZonedDateTime object to String using the ISO date formatter

Parameters:

zonedDateTime - the zoned date time

Returns:

the zoned date time as a String

zonedDateTimeToString

public static String zonedDateTimeToString(ZonedDateTime zonedDateTime,
                                           ZoneId zoneId,
                                           String pattern)
                                    throws IllegalArgumentException

Converts a ZonedDateTime object to String using the given pattern for formatting, in the given zone, so as to format the instant in another zone
For instance, if provided pattern is 'uuuu-MM-dd'T'HH:mm:ss.SSSXXX':

• for UTC zone, the zone date time corresponding to '2011-12-03T11:15:30+01:00' will be formatted as '2011-12-03T10:15:30Z'
• for +02:00 zone, the zone date time corresponding to '2011-12-03T11:15:30+01:00' will be formatted as '2011-12-03T12:15:30+02:00'

Parameters:

zonedDateTime - the zoned date time

zoneId - the target zone

pattern - the pattern for formatting

Returns:

the zoned date time as a String, in the given zone

Throws:

IllegalArgumentException - if the pattern is invalid

localDateToString

public static String localDateToString(LocalDate localDate)

Converts a LocalDate object to String using the ISO date formatter

Parameters:

localDate - the local date

Returns:

the local date as a String

parse

public static Date parse(String value)

Parses a String into a Date, using ISO 8601 format.

Parameters:

value - an ISO 8601 formatted String.

Returns:

the corresponding Date, or null if the input is null.

parseZonedDateTime

public static ZonedDateTime parseZonedDateTime(String zonedDateTimeAsString)

Parses a String into a ZonedDateTime, using ISO date formatter.

Parameters:

zonedDateTimeAsString - the zoned date time as string

Returns:

the ZonedDateTime object or null if the input is null.

parseLocalDate

public static LocalDate parseLocalDate(String localDateAsString)

Parses a String into a LocalDate, using ISO date formatter.

Parameters:

localDateAsString - the local date as string

Returns:

the LocalDate object or null if the input is null.