Package org.restlet.engine.util

Class DateUtils

  • public final class DateUtils
extends java.lang.Object
    Date manipulation utilities.
    Author:
    Jerome Louvel

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.util.List<java.lang.String> FORMAT_ASC_TIME
      Obsoleted HTTP date format (ANSI C asctime() format).
      static java.util.List<java.lang.String> FORMAT_ISO_8601
      AWS date format (ISO 8601).
      static java.util.List<java.lang.String> FORMAT_RFC_1036
      Obsoleted HTTP date format (RFC 1036).
      static java.util.List<java.lang.String> FORMAT_RFC_1123
      Preferred HTTP date format (RFC 1123).
      static java.util.List<java.lang.String> FORMAT_RFC_3339
      W3C date format (RFC 3339).
      static java.util.List<java.lang.String> FORMAT_RFC_822
      Common date format (RFC 822).

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean after​(java.util.Date baseDate, java.util.Date afterDate)
      Compares two date with a precision of one second.
      static boolean before​(java.util.Date baseDate, java.util.Date beforeDate)
      Compares two date with a precision of one second.
      static boolean equals​(java.util.Date baseDate, java.util.Date otherDate)
      Compares two date with a precision of one second.
      static java.lang.String format​(java.util.Date date)
      Formats a Date in the default HTTP format (RFC 1123).
      static java.lang.String format​(java.util.Date date, java.lang.String format)
      Formats a Date according to the given format.
      static java.lang.String format​(java.util.Date date, java.util.List<java.lang.String> formats)
      Formats a Date according to the first format in the array.
      static java.util.Date parse​(java.lang.String date)
      Parses a formatted date into a Date object using the default HTTP format (RFC 1123).
      static java.util.Date parse​(java.lang.String date, java.util.List<java.lang.String> formats)
      Parses a formatted date into a Date object.
      static java.util.Date unmodifiable​(java.util.Date date)
      Returns an immutable version of a given date.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • FORMAT_ASC_TIME

        public static final java.util.List<java.lang.String> FORMAT_ASC_TIME
        Obsoleted HTTP date format (ANSI C asctime() format). Pattern: "EEE MMM dd HH:mm:ss yyyy".

      • FORMAT_RFC_1036

        public static final java.util.List<java.lang.String> FORMAT_RFC_1036
        Obsoleted HTTP date format (RFC 1036). Pattern: "EEEE, dd-MMM-yy HH:mm:ss zzz".

      • FORMAT_RFC_1123

        public static final java.util.List<java.lang.String> FORMAT_RFC_1123
        Preferred HTTP date format (RFC 1123). Pattern: "EEE, dd MMM yyyy HH:mm:ss zzz".

      • FORMAT_RFC_3339

        public static final java.util.List<java.lang.String> FORMAT_RFC_3339
        W3C date format (RFC 3339). Pattern: "yyyy-MM-dd'T'HH:mm:ssz".

      • FORMAT_ISO_8601

        public static final java.util.List<java.lang.String> FORMAT_ISO_8601
        AWS date format (ISO 8601). Pattern: "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'".

      • FORMAT_RFC_822

        public static final java.util.List<java.lang.String> FORMAT_RFC_822
        Common date format (RFC 822). Patterns: "EEE, dd MMM yy HH:mm:ss z" or "EEE, dd MMM yy HH:mm z", "dd MMM yy HH:mm:ss z" or "dd MMM yy HH:mm z".

    • Method Detail

      • after

        public static boolean after​(java.util.Date baseDate,
                            java.util.Date afterDate)
        Compares two date with a precision of one second.
        Parameters:
        baseDate - The base date
        afterDate - The date supposed to be after.
        Returns:
        True if the afterDate is indeed after the baseDate.

      • before

        public static boolean before​(java.util.Date baseDate,
                             java.util.Date beforeDate)
        Compares two date with a precision of one second.
        Parameters:
        baseDate - The base date
        beforeDate - The date supposed to be before.
        Returns:
        True if the beforeDate is indeed before the baseDate.

      • equals

        public static boolean equals​(java.util.Date baseDate,
                             java.util.Date otherDate)
        Compares two date with a precision of one second.
        Parameters:
        baseDate - The base date
        otherDate - The other date supposed to be equals.
        Returns:
        True if both dates are equals.

      • format

        public static java.lang.String format​(java.util.Date date)
        Formats a Date in the default HTTP format (RFC 1123).
        Parameters:
        date - The date to format.
        Returns:
        The formatted date.

      • format

        public static java.lang.String format​(java.util.Date date,
                                      java.util.List<java.lang.String> formats)
        Formats a Date according to the first format in the array.
        Parameters:
        date - The date to format.
        formats - The array of date formats to use.
        Returns:
        The formatted date.

      • format

        public static java.lang.String format​(java.util.Date date,
                                      java.lang.String format)
        Formats a Date according to the given format.
        Parameters:
        date - The date to format.
        format - The date format to use.
        Returns:
        The formatted date.

      • parse

        public static java.util.Date parse​(java.lang.String date)
        Parses a formatted date into a Date object using the default HTTP format (RFC 1123).
        Parameters:
        date - The date to parse.
        Returns:
        The parsed date.

      • parse

        public static java.util.Date parse​(java.lang.String date,
                                   java.util.List<java.lang.String> formats)
        Parses a formatted date into a Date object.
        Parameters:
        date - The date to parse.
        formats - The date formats to use sorted by completeness.
        Returns:
        The parsed date.

      • unmodifiable

        public static java.util.Date unmodifiable​(java.util.Date date)
        Returns an immutable version of a given date.
        Parameters:
        date - The modifiable date.
        Returns:
        An immutable version of a given date.