Package com.atlassian.jira.web.util

Class OutlookDate

java.lang.Object

com.atlassian.jira.web.util.OutlookDate

@Deprecated
public class OutlookDate
extends Object

Deprecated.

Use DateTimeFormatter instead. Since v7.1

Formats and parses dates in a variety of formats, including relative dates such as "Today" and "Last Wednesday".

Warning

As of JIRA 4.4, some of the methods in this class have been retrofitted to be time zone-aware. This means that if you call one of these methods, this class will attempt to determine the time zone of the user that is currently logged in, and will display times in that user's time zone if possible. If the user's time zone can not be determined, or if there is no logged in user, the methods will use the JIRA default user time zone. This is different to the previous behaviour, which was to use the JVM default timezone as returned by TimeZone.getDefault() when displaying dates. Please review each method's JavaDoc to determine whether you are affected by this change in behaviour.

See Also:

• DateTimeFormatterFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	OutlookDate.SmartFormatterModes	Deprecated. Use DateTimeFormatter instead.

Field Summary

Fields

Modifier and Type	Field	Description
static final long	DAY	Deprecated.
static final long	HOUR	Deprecated.
static final long	MINUTE	Deprecated.
static final int	OTHER	Deprecated.
static final long	SECOND	Deprecated.
static final int	THIS_WEEK	Deprecated.
static final int	TODAY	Deprecated.
static final int	YESTERDAY	Deprecated.

Constructor Summary

Constructors

Constructor	Description
OutlookDate(Locale locale)	Deprecated. Use OutlookDate(java.util.Locale, com.atlassian.jira.config.properties.ApplicationProperties, com.atlassian.jira.util.I18nHelper.BeanFactory, com.atlassian.jira.datetime.DateTimeFormatterFactory) or better still OutlookDateManager.
OutlookDate(Locale locale, ApplicationProperties applicationProperties)	Deprecated. Use OutlookDate(java.util.Locale, com.atlassian.jira.config.properties.ApplicationProperties, com.atlassian.jira.util.I18nHelper.BeanFactory, com.atlassian.jira.datetime.DateTimeFormatterFactory) or better still OutlookDateManager.
OutlookDate(Locale locale, ApplicationProperties applicationProperties, I18nHelper.BeanFactory i18nHelperFactory, DateTimeFormatterFactory dateTimeFormatterFactory)	Deprecated.

Method Summary

Modifier and Type	Method	Description
int	daysAgo(Date date)	Deprecated. Use Days.daysBetween(org.joda.time.ReadablePartial, org.joda.time.ReadablePartial) instead.
int	daysAgo(Date theDate, Date theReferenceDate)	Deprecated. Use Days.daysBetween(org.joda.time.ReadablePartial, org.joda.time.ReadablePartial) instead.
String	format(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatDatePicker(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatDateTimePicker(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatDay(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatDMY(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatDMYHMS(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatIso8601(Date date)	Deprecated.
String	formatIso8601Date(Date date)	Deprecated.
String	formatRss(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatRssRfc822(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatSmart(Date date, OutlookDate.SmartFormatterModes mode)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	formatTime(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
String	getCompleteDateTimeFormat()	Deprecated. Use DateTimeFormatter.getFormatHint() instead.
String	getDatePickerFormatSample(Date date)	Deprecated. Use DateTimeFormatter.format(java.util.Date) instead.
boolean	isDatePickerDate(String value)	Deprecated. Use DateTimeFormatter.parse(String) instead.
Date	parseCompleteDateTime(String value)	Deprecated. Use DateTimeFormatter.parse(String) instead.
Date	parseDatePicker(String value)	Deprecated. Use DateTimeFormatter.parse(String) instead.
Date	parseDateTimePicker(String value)	Deprecated. Use DateTimeFormatter.parse(String) instead.
static Date	parseRss(String rssDate)	Deprecated. Use DateTimeFormatter.parse(String) instead.

Methods inherited from class java.lang.Object

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

Field Details

SECOND

@Deprecated
public static final long SECOND

Deprecated.

See Also:

• Constant Field Values

MINUTE

@Deprecated
public static final long MINUTE

Deprecated.

See Also:

• Constant Field Values

HOUR

@Deprecated
public static final long HOUR

Deprecated.

See Also:

• Constant Field Values

DAY

@Deprecated
public static final long DAY

Deprecated.

See Also:

• Constant Field Values

TODAY

@Deprecated
public static final int TODAY

Deprecated.

See Also:

• Constant Field Values

YESTERDAY

@Deprecated
public static final int YESTERDAY

Deprecated.

See Also:

• Constant Field Values

THIS_WEEK

@Deprecated
public static final int THIS_WEEK

Deprecated.

See Also:

• Constant Field Values

OTHER

@Deprecated
public static final int OTHER

Deprecated.

See Also:

• Constant Field Values

Constructor Details

OutlookDate

@Deprecated
public OutlookDate(Locale locale,
 ApplicationProperties applicationProperties,
 I18nHelper.BeanFactory i18nHelperFactory,
 DateTimeFormatterFactory dateTimeFormatterFactory)

Deprecated.

OutlookDate

@Deprecated
public OutlookDate(Locale locale)

Deprecated.

Use OutlookDate(java.util.Locale, com.atlassian.jira.config.properties.ApplicationProperties, com.atlassian.jira.util.I18nHelper.BeanFactory, com.atlassian.jira.datetime.DateTimeFormatterFactory) or better still OutlookDateManager. Since v4.3

An old constructor which is left here only for backward compatibility.

Parameters:

locale -

OutlookDate

@Deprecated
public OutlookDate(Locale locale,
 ApplicationProperties applicationProperties)

Deprecated.

Use OutlookDate(java.util.Locale, com.atlassian.jira.config.properties.ApplicationProperties, com.atlassian.jira.util.I18nHelper.BeanFactory, com.atlassian.jira.datetime.DateTimeFormatterFactory) or better still OutlookDateManager. Since v4.3

An old constructor which is left here only for backward compatibility.

Parameters:

locale -

applicationProperties -

Method Details

formatIso8601

@Deprecated
public String formatIso8601(Date date)

Deprecated.

Formats the given date into ISO8601 format. This format contains date and time information and it is used by data marked with hCalendar microformat. If you need to use date information only use formatIso8601Date(java.util.Date) method instead.

Parameters:

date - date to format

Returns:

formatted date string

formatIso8601Date

@Deprecated
public String formatIso8601Date(Date date)

Deprecated.

Formats the given date into ISO8601 format. This format contains date information only and it is used by data marked with hCalendar microformat. If you need to use date and time information use formatIso8601(java.util.Date) method instead.

Parameters:

date - date to format

Returns:

formatted date string

formatDMY

@Deprecated
public String formatDMY(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.DATE.

Parameters:

date - a Date

Returns:

a String containing the formatted date

formatDMYHMS

@Deprecated
public String formatDMYHMS(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v5.0.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.COMPLETE.

Parameters:

date - a Date

Returns:

a String containing the formatted date

formatTime

@Deprecated
public String formatTime(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v5.0.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.TIME.

Parameters:

date - a Date

Returns:

a String containing the formatted date

formatDay

@Deprecated
public String formatDay(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

formatDatePicker

@Deprecated
public String formatDatePicker(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.DATE_PICKER.

formatDateTimePicker

@Deprecated
public String formatDateTimePicker(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.DATE_TIME_PICKER.

formatRss

@Deprecated
public String formatRss(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v5.0.

Format a date for RSS feeds. Uses MailDateFormat to format the given date. Returns an empty string if null is passed in.

Parameters:

date - date to format

Returns:

formatted date or empty string

formatRssRfc822

@Deprecated
public String formatRssRfc822(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

Formats a date using the correct RFC822 format as indicated in the RSS v2 specification and not using the MailDateFormat which is technically incorrect. MailDateFormat will however parse this format.

See http://cyber.law.harvard.edu/rss/rss.html

See http://asg.web.cmu.edu/rfc/rfc822.html#sec-5.1

Correct : Wed, 22 Aug 2007 10:00:10 +1000

Incorrect : Wed, 22 Aug 2007 10:00:10 +1000 (GMT+10:00)

Parameters:

date - the date to format into a string

Returns:

a date string in RFC822 format

Since:

v3.10.3

See Also:

• format(java.util.Date)

parseRss

@Deprecated
public static Date parseRss(String rssDate)
                     throws ParseException

Deprecated.

Use DateTimeFormatter.parse(String) instead. Since v5.0.

Parse a date from RSS feeds. Uses MailDateFormat to parse the date.

Parameters:

rssDate - RSS date

Returns:

new Date created from the given string

Throws:

ParseException - if string parsing fails

See Also:

• format(java.util.Date)

format

@Deprecated
public String format(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

Returns the given date formatted as a String in the current user's time zone if possible, in the format specified by DateTimeStyle.RELATIVE.

Parameters:

date - the date to format

Returns:

the date printed (i18n)

formatSmart

@Deprecated
public String formatSmart(Date date,
 OutlookDate.SmartFormatterModes mode)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v5.0.

Format the date "smartly", by using the day of the week if the date falls within a week in either direction of the current date. If the date is in the past, we will use terminology such as "last Wednesday" to differentiate it from "Wednesday" (which is in the future).

Parameters:

date - the date to format

mode - whether or not to include the time in the printed date

Returns:

the date printed (i18n)

daysAgo

@Deprecated
public int daysAgo(Date date)

Deprecated.

Use Days.daysBetween(org.joda.time.ReadablePartial, org.joda.time.ReadablePartial) instead. Since v4.4.

daysAgo

@Deprecated
public int daysAgo(Date theDate,
 Date theReferenceDate)

Deprecated.

Use Days.daysBetween(org.joda.time.ReadablePartial, org.joda.time.ReadablePartial) instead. Since v4.4.

The method determines whether the date (theDate) lies between the reference date and the previous midnight (TODAY), between the reference date and the midnight before previous (YESTERDAY), or between the reference date and 7 midnights ago (THIS_WEEK). If the passed in date does not fall in any of the mentioned ranges, the method returns OTHER.

Parameters:

theDate - the date we are asking about

theReferenceDate - the reference date (usually today's date)

Returns:

TODAY, YESTERDAY, THIS_WEEK or OTHER

parseCompleteDateTime

@Deprecated
public Date parseCompleteDateTime(String value)
                           throws ParseException

Deprecated.

Use DateTimeFormatter.parse(String) instead. Since v4.4.

Parses the given text in COMPLETE format, using the current user's time zone and locale if possible. If there is no currently logged in user, or if the currently logged in user has not configured a time zone and/or locale the JIRA default time zone and/or locale is used.

Throws:

ParseException

parseDatePicker

@Deprecated
public Date parseDatePicker(String value)
                     throws ParseException

Deprecated.

Use DateTimeFormatter.parse(String) instead. Since v4.4.

Parses the given text in DATE_PICKER or DATE_TIME_PICKER format, using the current user's time zone and locale if possible. If there is no currently logged in user, or if the currently logged in user has not configured a time zone and/or locale the JIRA default time zone and/or locale is used.

Throws:

ParseException

parseDateTimePicker

@Deprecated
public Date parseDateTimePicker(String value)
                         throws ParseException

Deprecated.

Use DateTimeFormatter.parse(String) instead. Since v4.4.

Parses the given text in DATE_TIME_PICKER format, using the current user's time zone and locale if possible. If there is no currently logged in user, or if the currently logged in user has not configured a time zone and/or locale the JIRA default time zone and/or locale is used.

Throws:

ParseException

getDatePickerFormatSample

@Deprecated
public String getDatePickerFormatSample(Date date)

Deprecated.

Use DateTimeFormatter.format(java.util.Date) instead. Since v4.4.

isDatePickerDate

@Deprecated
public boolean isDatePickerDate(String value)

Deprecated.

Use DateTimeFormatter.parse(String) instead. Since v5.0.

Parameters:

value -

Returns:

getCompleteDateTimeFormat

@Deprecated
public String getCompleteDateTimeFormat()

Deprecated.

Use DateTimeFormatter.getFormatHint() instead. Since v4.4.