Class DateUtils


  • public class DateUtils
    extends Object
    Date related utility methods and constants
    • Field Detail

      • UTC

        public static final TimeZone UTC
        The UTC time zone. Not sure if TimeZone.getTimeZone(String) understands "UTC" in all environments, but it'll fall back to GMT in such cases, which is in practice equivalent to UTC.
      • MIDDAY

        public static final TimeZone MIDDAY
        Custom time zone used to interpret date values without a time component in a way that most likely falls within the same day regardless of in which time zone it is later interpreted. For example, the "2012-02-17" date would map to "2012-02-17T12:00:00Z" (instead of the default "2012-02-17T00:00:00Z"), which would still map to "2012-02-17" if interpreted in say Pacific time (while the default mapping would result in "2012-02-16" for UTC-8).
    • Constructor Detail

      • DateUtils

        public DateUtils()
    • Method Detail

      • formatDate

        public static String formatDate​(Date date)
        Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit. This method is thread safe and non-blocking.
        Parameters:
        date - given date
        Returns:
        ISO 8601 date string in UTC, truncated to the seconds unit
        See Also:
        TIKA-495
      • formatDate

        public static String formatDate​(Calendar date)
        Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit. This method is thread safe and non-blocking.
        Parameters:
        date - given Calendar
        Returns:
        ISO 8601 date string in UTC, truncated to the seconds unit
        See Also:
        TIKA-495
      • formatDateUnknownTimezone

        public static String formatDateUnknownTimezone​(Date date)
        Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit. This method is thread safe and non-blocking.
        Parameters:
        date - given date
        Returns:
        ISO 8601 date string in UTC, truncated to the seconds unit
        See Also:
        TIKA-495
      • tryToParse

        public Date tryToParse​(String dateString)
        Tries to parse the date string; returns null if no parse was possible.

        This is not thread safe! Wrap in synchronized or create new DateUtils for each class.

        Parameters:
        dateString -
        Returns: