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

Method Summary

All Methods Static Methods Concrete Methods
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(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 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 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, 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, 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
- Method Detail
  - 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(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)
```
    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 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,
                                               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,
                                       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.

Class DateUtils

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ISO_OFFSET_DATE_TIME_PATTERN

Method Detail

asInstant

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asLocalDate

asLocalDate

asLocalDate

asLocalDate

asLocalDate

asDate

asDate

asDate

asCalendar

asCalendar

formatDuration

formatDuration

getISODateTimeFormatter

dateToString

epochMilliToString

zonedDateTimeToString

zonedDateTimeToString

localDateToString

parse

parseZonedDateTime

parseZonedDateTime

parseLocalDate

parseLocalDate