org.apache.tika.utils

Class DateUtils

java.lang.Object

org.apache.tika.utils.DateUtils

public class DateUtils
extends java.lang.Object

Date related utility methods and constants

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<java.text.DateFormat>	iso8601InputFormats So we can return Date objects for these, this is the list (in preference order) of the various ISO-8601 variants that we try when processing a date based property.
static java.util.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.
static java.util.TimeZone	UTC The UTC time zone.

Constructor Summary

Constructors

Constructor and Description
DateUtils()

Method Summary

Modifier and Type	Method and Description
private static java.text.DateFormat	createDateFormat(java.lang.String format, java.util.TimeZone timezone)
private static java.lang.String	doFormatDate(java.util.Calendar calendar)
static java.lang.String	formatDate(java.util.Calendar date) Returns a ISO 8601 representation of the given date.
static java.lang.String	formatDate(java.util.Date date) Returns a ISO 8601 representation of the given date.
static java.lang.String	formatDateUnknownTimezone(java.util.Date date) Returns a ISO 8601 representation of the given date, which is in an unknown timezone.
private java.util.List<java.text.DateFormat>	loadDateFormats()
java.util.Date	tryToParse(java.lang.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 Detail

UTC

public static final java.util.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 java.util.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).

iso8601InputFormats

private final java.util.List<java.text.DateFormat> iso8601InputFormats

So we can return Date objects for these, this is the list (in preference order) of the various ISO-8601 variants that we try when processing a date based property.

Constructor Detail

DateUtils

public DateUtils()

Method Detail

createDateFormat

private static java.text.DateFormat createDateFormat(java.lang.String format,
                                                     java.util.TimeZone timezone)

loadDateFormats

private java.util.List<java.text.DateFormat> loadDateFormats()

formatDate

public static java.lang.String formatDate(java.util.Date date)

Returns a ISO 8601 representation of the given date. This method is thread safe and non-blocking.

Parameters:

date - given date

Returns:

ISO 8601 date string, including timezone details

See Also:

TIKA-495

formatDate

public static java.lang.String formatDate(java.util.Calendar date)

Returns a ISO 8601 representation of the given date. This method is thread safe and non-blocking.

Parameters:

date - given date

Returns:

ISO 8601 date string, including timezone details

See Also:

TIKA-495

formatDateUnknownTimezone

public static java.lang.String formatDateUnknownTimezone(java.util.Date date)

Returns a ISO 8601 representation of the given date, which is in an unknown timezone. This method is thread safe and non-blocking.

Parameters:

date - given date

Returns:

ISO 8601 date string, without timezone details

See Also:

TIKA-495

doFormatDate

private static java.lang.String doFormatDate(java.util.Calendar calendar)

tryToParse

public java.util.Date tryToParse(java.lang.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: