com.atlassian.jira.util

Class JiraDurationUtils

java.lang.Object

com.atlassian.jira.util.JiraDurationUtils

public class JiraDurationUtils
extends Object

Util class responsible for printing durations in various formats.

Note that this class uses the Duration formatting as configured for time-tracking and is therefore quite specific. For more generic duration formatting see DateUtils

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JiraDurationUtils.DaysDurationFormatter This formatter formats time duration to days only.
static interface	JiraDurationUtils.DurationFormatter This interface defines methods for formatting time duration
static class	JiraDurationUtils.HoursDurationFormatter This formatter formats time duration to hours only.
static class	JiraDurationUtils.PrettyDurationFormatter This formatter formats time duration to "pretty" format, such as 3 weeks, 2 days, 1 hour, 15 minutes.

Field Summary

Fields

Modifier and Type	Field and Description
protected DurationFormatterProvider	durationFormatterProvider duration formatter currently in use
static String	FORMAT_DAYS days formatter application property value
static String	FORMAT_HOURS hours formatter application property value
static String	FORMAT_PRETTY pretty formatter aplication property value

Constructor Summary

Constructors

Constructor and Description
JiraDurationUtils(ApplicationProperties applicationProperties, JiraAuthenticationContext authenticationContext, TimeTrackingConfiguration timeTrackingConfiguration, com.atlassian.event.api.EventPublisher eventPublisher, I18nHelper.BeanFactory i18nFactory) Deprecated. Use JiraDurationUtils(TimeTrackingConfiguration, DurationFormatterProvider, EventPublisher) instead. Since v6.2.
JiraDurationUtils(ApplicationProperties applicationProperties, JiraAuthenticationContext authenticationContext, TimeTrackingConfiguration timeTrackingConfiguration, com.atlassian.event.api.EventPublisher eventPublisher, I18nHelper.BeanFactory i18nFactory, com.atlassian.cache.CacheManager cacheManager) Deprecated. Use JiraDurationUtils(TimeTrackingConfiguration, DurationFormatterProvider, EventPublisher) instead. Since v7.2.
JiraDurationUtils(TimeTrackingConfiguration timeTrackingConfiguration, DurationFormatterProvider durationFormatterProvider, com.atlassian.event.api.EventPublisher eventPublisher)

Method Summary

Modifier and Type	Method and Description
String	getFormattedDuration(Long duration) Formats time duration with default (system) locale
String	getFormattedDuration(Long duration, Locale locale) Formats time duration with given locale
String	getI18nKey() Returns i18n resource key for the current formatter
String	getShortFormattedDuration(Long duration) Formats time duration in the most compact way possible.
String	getShortFormattedDuration(Long duration, Locale locale) Formats time duration in the most compact way possible.
void	onClearCache(ClearCacheEvent event) Deprecated. Use DurationFormatChanged instead. Since v7.2.
Long	parseDuration(String duration) Deprecated. since v4.4. Use parseDuration(String location, Locale locale) instead.
Long	parseDuration(String duration, Locale locale) Turn a duration string into the number of seconds that it represents, taking into account JIRA's configuration (i.e.
void	start() Deprecated. Not used anymore. Since v7.2.
void	updateFormatters(ApplicationProperties applicationProperties, JiraAuthenticationContext authenticationContext) Deprecated. Use DurationFormatChanged instead. Since 7.2.

Methods inherited from class java.lang.Object

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

Field Detail

FORMAT_PRETTY

public static final String FORMAT_PRETTY

pretty formatter aplication property value

See Also:

Constant Field Values

FORMAT_HOURS

public static final String FORMAT_HOURS

hours formatter application property value

See Also:

Constant Field Values

FORMAT_DAYS

public static final String FORMAT_DAYS

days formatter application property value

See Also:

Constant Field Values

durationFormatterProvider

protected final DurationFormatterProvider durationFormatterProvider

duration formatter currently in use

Constructor Detail

JiraDurationUtils

@Deprecated
public JiraDurationUtils(ApplicationProperties applicationProperties,
                                     JiraAuthenticationContext authenticationContext,
                                     TimeTrackingConfiguration timeTrackingConfiguration,
                                     com.atlassian.event.api.EventPublisher eventPublisher,
                                     I18nHelper.BeanFactory i18nFactory)

Deprecated. Use JiraDurationUtils(TimeTrackingConfiguration, DurationFormatterProvider, EventPublisher) instead. Since v6.2.

Sets the duration formatter based on the settings in the application properties and authentication context

Parameters:

applicationProperties - application properties

authenticationContext - the context of the logged in user, used to get an I18nHelper appropriate for the user

timeTrackingConfiguration - the current time tracking configuration

eventPublisher - event publisher so the duration utils can be notified when an import occurs.

i18nFactory - the creator of i18nBean classes.

JiraDurationUtils

@Deprecated
public JiraDurationUtils(ApplicationProperties applicationProperties,
                                     JiraAuthenticationContext authenticationContext,
                                     TimeTrackingConfiguration timeTrackingConfiguration,
                                     com.atlassian.event.api.EventPublisher eventPublisher,
                                     I18nHelper.BeanFactory i18nFactory,
                                     com.atlassian.cache.CacheManager cacheManager)

Deprecated. Use JiraDurationUtils(TimeTrackingConfiguration, DurationFormatterProvider, EventPublisher) instead. Since v7.2.

Sets the duration formatter based on the settings in the application properties and authentication context

Parameters:

applicationProperties - application properties

authenticationContext - the context of the logged in user, used to get an I18nHelper appropriate for the user

timeTrackingConfiguration - the current time tracking configuration

eventPublisher - event publisher so the duration utils can be notified when an import occurs.

i18nFactory - the creator of i18nBean classes.

cacheManager - the cache manager

Since:

v6.2

JiraDurationUtils

public JiraDurationUtils(TimeTrackingConfiguration timeTrackingConfiguration,
                         DurationFormatterProvider durationFormatterProvider,
                         com.atlassian.event.api.EventPublisher eventPublisher)

Parameters:

timeTrackingConfiguration - the current time tracking configuration

durationFormatterProvider - the duration formatter factory

Since:

v7.2

Method Detail

start

@Deprecated
public void start()
                       throws Exception

Deprecated. Not used anymore. Since v7.2.

This class does not need to implement Startable anymore, but we need to keep this method around to avoid breaking binary compatibility.

Throws:

Exception

onClearCache

@Deprecated
public void onClearCache(ClearCacheEvent event)

Deprecated. Use DurationFormatChanged instead. Since v7.2.

Not used anymore as this class doesn't cache a JiraDurationUtils.DurationFormatter any more, but it can't be removed yet as it would break API.

updateFormatters

@Deprecated
public void updateFormatters(ApplicationProperties applicationProperties,
                                         JiraAuthenticationContext authenticationContext)

Deprecated. Use DurationFormatChanged instead. Since 7.2.

Sets the duration formatter with a new instance of a particular formatter chosen based on the settings in the application properties and authentication context.

Parameters:

applicationProperties - application properties

authenticationContext - authentication context

getI18nKey

public String getI18nKey()

Returns i18n resource key for the current formatter

Returns:

i18n resource key

getFormattedDuration

public String getFormattedDuration(Long duration)

Formats time duration with default (system) locale

Parameters:

duration - time duration to format

Returns:

formatted time duration

getFormattedDuration

public String getFormattedDuration(Long duration,
                                   Locale locale)

Formats time duration with given locale

Parameters:

duration - time duration to format

locale - user's locale

Returns:

formatted time duration

getShortFormattedDuration

public String getShortFormattedDuration(Long duration)

Formats time duration in the most compact way possible.

Parameters:

duration - time duration to format

Returns:

formatted time duration

getShortFormattedDuration

public String getShortFormattedDuration(Long duration,
                                        Locale locale)

Formats time duration in the most compact way possible.

Parameters:

duration - time in seconds

locale - locale to use. This is used only for translation, not for decimal formatting.

Returns:

formatted time duration

parseDuration

public Long parseDuration(String duration,
                          Locale locale)
                   throws com.atlassian.core.util.InvalidDurationException

Turn a duration string into the number of seconds that it represents, taking into account JIRA's configuration (i.e. how many hours are in a day, how many days are in a week, etc)

Parameters:

duration - string in JIRA's duration format (i.e. "20h")

locale - Locale to use when interpreting the duration string

Returns:

number of seconds in the duration string

Throws:

com.atlassian.core.util.InvalidDurationException - when the duration cannot be parsed

parseDuration

public Long parseDuration(String duration)
                   throws com.atlassian.core.util.InvalidDurationException

Deprecated. since v4.4. Use parseDuration(String location, Locale locale) instead.

Turn a duration string into the number of seconds that it represents, taking into account JIRA's configuration (i.e. how many hours are in a day, how many days are in a week, etc)

This uses the default locale of Locale.UK and is retained for backwards compatibility

Parameters:

duration - string in JIRA's duration format (i.e. "20h")

Returns:

number of seconds in the duration string

Throws:

com.atlassian.core.util.InvalidDurationException - when the duration cannot be parsed