Class DateUtils

java.lang.Object
org.apache.tika.utils.DateUtils

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

    Fields
    Modifier and Type
    Field
    Description
    static final TimeZone
    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.
    static final TimeZone
    The UTC time zone.
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    static String
    Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit.
    static String
    Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit.
    static String
    Returns a ISO 8601 representation of the given date in UTC, truncated to the seconds unit.
    tryToParse(String dateString)
    Tries to parse the date string; returns null if no parse was possible.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • 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 Details

    • DateUtils

      public DateUtils()
  • Method Details

    • 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:
    • 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:
    • 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:
    • 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: