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

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

Class DateUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ISO_OFFSET_DATE_TIME_PATTERN

__ISO_OFFSET_DATE_TIME

Constructor Detail

DateUtils

Method Detail

_createFormatter

asInstant

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asZonedDateTime

asLocalDate

asLocalDate

asLocalDate

asDate

asDate

asDate

asCalendar

asCalendar

formatDuration

formatDuration

formatNumber

getISODateTimeFormatter

dateToString

epochMilliToString

zonedDateTimeToString

zonedDateTimeToString

localDateToString

parse

parseZonedDateTime

parseLocalDate