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
static final String	ISO_OFFSET_DATE_TIME_PATTERN	The ISO date-time pattern that formats or parses a date-time with an offset

Method Summary

Modifier and Type	Method	Description
static Calendar	asCalendar(LocalDate localDate)	Converts this LocalDate object to a Calendar.
static Calendar	asCalendar(ZonedDateTime zonedDateTime)	Converts this ZonedDateTime object to a Calendar, setting the time zone to UTC.
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(ZonedDateTime zonedDateTime)	Converts this ZonedDateTime object to a Date.
static Instant	asInstant(Date date)	Converts this Date object to an Instant.
static LocalDate	asLocalDate(long epochMilli)	Converts this epoch time to a LocalDate.
static LocalDate	asLocalDate(long epochMilli, ZoneId zone)	Converts this epoch time to a LocalDate.
static LocalDate	asLocalDate(Instant instant)	Converts an Instant to a LocalDate
static LocalDate	asLocalDate(Instant instant, ZoneId zone)	Converts an Instant to a LocalDate
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 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(Instant instant)	Converts an Instant to a ZonedDateTime
static ZonedDateTime	asZonedDateTime(Instant instant, ZoneId zone)	Converts an Instant to a ZonedDateTime
static ZonedDateTime	asZonedDateTime(LocalDate localDate, ZoneId zone)	Converts a LocalDate to a ZonedDateTime
static ZonedDateTime	asZonedDateTime(Calendar calendar)	Converts this Calendar object to a ZonedDateTime.
static ZonedDateTime	asZonedDateTime(Date date)	Converts this Date object to a ZonedDateTime, at UTC.
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, at UTC time zone.
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
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 boolean	isAtMidnight(String zonedDateTimeAsString, String zoneId)	Determines if a date is at midnight (00:00) for the given time-zone
static String	localDateToString(LocalDate localDate)	Converts a LocalDate object to String using the ISO date formatter
static String	localDateToString(LocalDate localDate, String pattern)	Converts a LocalDate object to String using the given pattern for formatting
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 local date formatter.
static LocalDate	parseLocalDate(String localDateAsString, String pattern)	Parses a String into a LocalDate, using ISO local date formatter.
static LocalDate	parseLocalDate(String localDateAsString, Optional<DateTimeFormatter> formatter)	Parses a String into a LocalDate, using the given formatter.
static ZonedDateTime	parseZonedDateTime(String zonedDateTimeAsString)	Parses a String into a ZonedDateTime, using ISO date time formatter.
static ZonedDateTime	parseZonedDateTime(String zonedDateTimeAsString, String pattern)	Parses a String into a ZonedDateTime, using ISO date time formatter.
static ZonedDateTime	parseZonedDateTime(String zonedDateTimeAsString, Optional<DateTimeFormatter> formatter)	Parses a String into a ZonedDateTime, using the given formatter.
static String	zonedDateTimeToString(ZonedDateTime zonedDateTime)	Converts a ZonedDateTime object to String using the ISO date formatter
static String	zonedDateTimeToString(ZonedDateTime zonedDateTime, ZoneId zoneId)	Converts a ZonedDateTime object to String in the given zone, so as to format the instant in another zone, using the ISO date time formatter with pattern 'uuuu-MM-dd'T'HH:mm:ss.SSSXXX'.
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 Details

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

Method Details

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)

Converts this Date object to a ZonedDateTime, at UTC.

Parameters:

date - The date object

Returns:

the ZonedDateTime formed from this Date

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, UTC 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

asZonedDateTime

public static ZonedDateTime asZonedDateTime(LocalDate localDate,
 ZoneId zone)

Converts a LocalDate to a ZonedDateTime

Parameters:

localDate - the local date

zone - The time zone. If null, UTC is used

Returns:

the ZonedDateTime formed from this local date

asZonedDateTime

public static ZonedDateTime asZonedDateTime(Instant instant)

Converts an Instant to a ZonedDateTime

Parameters:

instant - the instant

Returns:

the ZonedDateTime formed from this local date

asZonedDateTime

public static ZonedDateTime asZonedDateTime(Instant instant,
 ZoneId zone)

Converts an Instant to a ZonedDateTime

Parameters:

instant - the instant

zone - The time zone. If null, UTC is used

Returns:

the ZonedDateTime formed from this local date

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.
Warning: this conversion looses the Calendar's time components.

Parameters:

calendar - the calendar

Returns:

the LocalDate object

asLocalDate

public static LocalDate asLocalDate(long epochMilli)

Converts this epoch time to a LocalDate.

Parameters:

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

Returns:

the LocalDate formed from this epoch time

asLocalDate

public static LocalDate asLocalDate(long epochMilli,
 ZoneId zone)

Converts this epoch time to a LocalDate.

Parameters:

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

zone - The time zone. If null, UTC is used

Returns:

the LocalDate formed from this epoch time

asLocalDate

public static LocalDate asLocalDate(Instant instant)

Converts an Instant to a LocalDate

Parameters:

instant - the instant

Returns:

the LocalDate formed from this local date

asLocalDate

public static LocalDate asLocalDate(Instant instant,
 ZoneId zone)

Converts an Instant to a LocalDate

Parameters:

instant - the instant

zone - The time zone. If null, UTC is used

Returns:

the LocalDate formed from this local 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. If null, UTC is used

Returns:

the Date part of this LocalDate

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 ZonedDateTime

asCalendar

public static Calendar asCalendar(ZonedDateTime zonedDateTime)

Converts this ZonedDateTime object to a Calendar, setting the time zone to UTC.

Parameters:

zonedDateTime - the zoned date time.

Returns:

the converted 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

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, at UTC time zone.

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,
 ZoneId zoneId)

Converts a ZonedDateTime object to String in the given zone, so as to format the instant in another zone, using the ISO date time formatter with pattern 'uuuu-MM-dd'T'HH:mm:ss.SSSXXX'. For instance:

• 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

Returns:

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

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

localDateToString

public static String localDateToString(LocalDate localDate,
 String pattern)
                                throws IllegalArgumentException

Converts a LocalDate object to String using the given pattern for formatting

Parameters:

localDate - the local date

pattern - the pattern for formatting

Returns:

the local date as a String

Throws:

IllegalArgumentException - if the pattern is invalid

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 time formatter.

Parameters:

zonedDateTimeAsString - the zoned date time as string

Returns:

the ZonedDateTime object or null if the input is null.

parseZonedDateTime

public static ZonedDateTime parseZonedDateTime(String zonedDateTimeAsString,
 String pattern)
                                        throws IllegalArgumentException

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

Parameters:

zonedDateTimeAsString - the zoned date time as string

pattern - the pattern to use to parse the given date

Returns:

the ZonedDateTime object or null if the input is null.

Throws:

IllegalArgumentException - if the pattern is invalid

parseZonedDateTime

public static ZonedDateTime parseZonedDateTime(String zonedDateTimeAsString,
 Optional<DateTimeFormatter> formatter)

Parses a String into a ZonedDateTime, using the given formatter. If no formatter, the ISO date time formatter is used

Parameters:

zonedDateTimeAsString - the zoned date time as string

formatter - the date time formatter

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 local date formatter.

Parameters:

localDateAsString - the local date as string

Returns:

the LocalDate object or null if the input is null.

parseLocalDate

public static LocalDate parseLocalDate(String localDateAsString,
 String pattern)
                                throws IllegalArgumentException

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

Parameters:

localDateAsString - the local date as string

pattern - the pattern to use to parse the given date

Returns:

the LocalDate object or null if the input is null.

Throws:

IllegalArgumentException - if the pattern is invalid

parseLocalDate

public static LocalDate parseLocalDate(String localDateAsString,
 Optional<DateTimeFormatter> formatter)

Parses a String into a LocalDate, using the given formatter. If no formatter, the ISO local date formatter is used

Parameters:

localDateAsString - the local date as string

formatter - the date time formatter

Returns:

the LocalDate object or null if the input is null.

isAtMidnight

public static boolean isAtMidnight(String zonedDateTimeAsString,
 String zoneId)

Determines if a date is at midnight (00:00) for the given time-zone

Parameters:

zonedDateTimeAsString - the zoned date time as string

zoneId - the time-zone id. If empty the system default time-zone will be used.

Returns:

true if the date is at midnight