net.time4j.format

Interface RelativeTimeProvider

All Superinterfaces:

UnitPatternProvider

public interface RelativeTimeProvider
extends UnitPatternProvider

This SPI-interface enables the access to localized unit patterns and is instantiated via a ServiceLoader-mechanism.

If there is no external RelativeTimeProvider then Time4J will use an internal implementation which just offers unit patterns either in english or in scientific notation.

Note: This interface enhances the standard UnitPatternProvider by new methods for short/abbreviated relative times and extra words for "yesterday-today-tomorrow".

Specification: Implementations must have a public no-arg constructor.

Since:

3.6/4.4

See Also:

ServiceLoader

Method Summary

Modifier and Type	Method and Description
java.lang.String	getShortDayPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of days in the past or future.
java.lang.String	getShortHourPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of hours in the past or future.
java.lang.String	getShortMinutePattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of minutes in the past or future.
java.lang.String	getShortMonthPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of months in the past or future.
java.lang.String	getShortSecondPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of seconds in the past or future.
java.lang.String	getShortWeekPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of weeks in the past or future.
java.lang.String	getShortYearPattern(java.util.Locale lang, boolean future, PluralCategory category) Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of years in the past or future.
java.lang.String	getTodayWord(java.util.Locale lang) Yields the localized word for "today".
java.lang.String	getTomorrowWord(java.util.Locale lang) Yields the localized word for "tomorrow".
java.lang.String	getYesterdayWord(java.util.Locale lang) Yields the localized word for "yesterday".

Methods inherited from interface net.time4j.format.UnitPatternProvider

getDayPattern, getDayPattern, getHourPattern, getHourPattern, getListPattern, getMicroPattern, getMilliPattern, getMinutePattern, getMinutePattern, getMonthPattern, getMonthPattern, getNanoPattern, getNowWord, getSecondPattern, getSecondPattern, getWeekPattern, getWeekPattern, getYearPattern, getYearPattern

Method Detail

getShortYearPattern

java.lang.String getShortYearPattern(java.util.Locale lang,
                                     boolean future,
                                     PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of years in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short years in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortMonthPattern

java.lang.String getShortMonthPattern(java.util.Locale lang,
                                      boolean future,
                                      PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of months in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short months in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortWeekPattern

java.lang.String getShortWeekPattern(java.util.Locale lang,
                                     boolean future,
                                     PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of weeks in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short weeks in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortDayPattern

java.lang.String getShortDayPattern(java.util.Locale lang,
                                    boolean future,
                                    PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of days in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short days in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortHourPattern

java.lang.String getShortHourPattern(java.util.Locale lang,
                                     boolean future,
                                     PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of hours in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short hours in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortMinutePattern

java.lang.String getShortMinutePattern(java.util.Locale lang,
                                       boolean future,
                                       PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of minutes in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short minutes in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getShortSecondPattern

java.lang.String getShortSecondPattern(java.util.Locale lang,
                                       boolean future,
                                       PluralCategory category)

Yields the localized unit pattern with short unit name and a placeholder "{0}" for the count of seconds in the past or future.

Parameters:

lang - language setting

future - use future or past form

category - plural category

Returns:

unit pattern for short seconds in the past or future

Throws:

java.util.MissingResourceException - if no pattern was found

Since:

3.6/4.4

getYesterdayWord

java.lang.String getYesterdayWord(java.util.Locale lang)

Yields the localized word for "yesterday".

Parameters:

lang - language setting

Returns:

String

Throws:

java.util.MissingResourceException - if not found

Since:

3.6/4.4

getTodayWord

java.lang.String getTodayWord(java.util.Locale lang)

Yields the localized word for "today".

Parameters:

lang - language setting

Returns:

String

Throws:

java.util.MissingResourceException - if not found

Since:

3.6/4.4

getTomorrowWord

java.lang.String getTomorrowWord(java.util.Locale lang)

Yields the localized word for "tomorrow".

Parameters:

lang - language setting

Returns:

String

Throws:

java.util.MissingResourceException - if not found

Since:

3.6/4.4