How to use

DateUtils$Duration

in

com.atlassian.core.util

public String shortFormat(final Long duration, final Locale locale)
{
  final BigDecimal secondsPerHour = BigDecimal.valueOf(DateUtils.Duration.HOUR.getSeconds());
  final long secondsPerDay = hoursPerDay.multiply(secondsPerHour).longValueExact();
  final long secondsPerWeek = daysPerWeek.multiply(hoursPerDay).multiply(secondsPerHour).longValueExact();
  return DateUtils.getDurationStringSeconds(duration, secondsPerDay, secondsPerWeek);
}

months = difference / Duration.MONTH.getMilliseconds();
if (months > 0) {
  difference = difference % Duration.MONTH.getMilliseconds();
  if (months > 1) {
    sb.append(months).append(" ").append(getText(resourceBundle, "core.dateutils.months")).append(", ");
  days = difference / Duration.DAY.getMilliseconds();
  if (days > 0) {
    difference = difference % Duration.DAY.getMilliseconds();
    if (days > 1) {
      sb.append(days).append(" ").append(getText(resourceBundle, "core.dateutils.days")).append(", ");
  hours = difference / Duration.HOUR.getMilliseconds();
  if (hours > 0) {
    difference = difference % Duration.HOUR.getMilliseconds();
    if (hours > 1) {
      sb.append(hours).append(" ").append(getText(resourceBundle, "core.dateutils.hours")).append(", ");
  minutes = difference / Duration.MINUTE.getMilliseconds();
  if (minutes > 0) {
    difference = difference % Duration.MINUTE.getMilliseconds();
    if (minutes > 1) {
      sb.append(minutes).append(" ").append(getText(resourceBundle, "core.dateutils.minutes")).append(", ");
  seconds = difference / Duration.SECOND.getMilliseconds();
  if (seconds > 0) {
    if (seconds > 1) {

private static String validateDurationUnit(final String durationString, final Duration duration)
    throws InvalidDurationException {
  if (durationString.length() > 1) {
    String singular = duration.name().toLowerCase();
    String plural = duration.name().toLowerCase() + "s";
    if (durationString.contains(plural)) {
      return durationString.substring(durationString.indexOf(plural));
    } else if (durationString.contains(singular)) {
      return durationString.substring(durationString.indexOf(singular));
    } else {
      throw new InvalidDurationException("Not a valid durationString string");
    }
  }
  return durationString.substring(1);
}

public DateUtils.Duration getDefaultUnit()
{
  DateUtils.Duration defaultUnit;
  try
  {
    defaultUnit = DateUtils.Duration.valueOf(properties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_DEFAULT_UNIT));
  }
  catch (IllegalArgumentException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  catch (NullPointerException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  return defaultUnit;
}

/**
 * Converts a number of seconds into a pretty formatted data string.  The resolution is in minutes.  So if the number of seconds is greater than a minute, it will
 * only be shown down top minute resolution.  If the number of seconds is less than a minute it will be shown in seconds.
 * <p/>
 * So for example <code>76</code> becomes <code>'1 minute'</code>, while <code>42</code> becomes <code>'42 seconds'</code>
 *
 * @param numSecs        the number of seconds in the duration
 * @param resourceBundle a resouce bundle for i18n
 * @return a string in readable pretty duration format, using minute resolution
 */
public static String getDurationPretty(long numSecs, ResourceBundle resourceBundle)
{
  return getDurationPrettySeconds(numSecs, Duration.DAY.getSeconds(), Duration.WEEK.getSeconds(), resourceBundle, false);
}

/**
 * Converts a number of seconds into a pretty formatted data string.  The resolution is in seconds.
 * <p/>
 * So for example <code>76</code> becomes <code>'1 minute, 16 seconds'</code>, while <code>42</code> becomes <code>'42 seconds'</code>
 *
 * @param numSecs        the number of seconds in the duration
 * @param hoursPerDay    the hours in a day
 * @param daysPerWeek    the number of days in a week
 * @param resourceBundle a resouce bundle for i18n
 * @return a string in readable pretty duration format, using second resolution
 */
public static String getDurationPrettySecondsResolution(long numSecs, int hoursPerDay, int daysPerWeek, ResourceBundle resourceBundle)
{
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationPrettySeconds(numSecs, secondsInDay, secondsPerWeek, resourceBundle, true);
}

/**
 * Get a duration string representing the given number of seconds. The string will use the largest unit possible.
 * (i.e. 1w 3d)
 *
 * @param l           the number of seconds
 * @param hoursPerDay hours in a working day
 * @param daysPerWeek days in a working week
 * @return the duration string
 */
public static String getDurationString(long l, int hoursPerDay, int daysPerWeek) {
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationStringSeconds(l, secondsInDay, secondsPerWeek);
}

/**
 * This function retrieves a duration in seconds that depends on number of hours in a day and
 * days in a week
 *
 * @param durationStr to convert to a duration
 * @param hoursPerDay Number of hourse i day
 * @param daysPerWeek Days Per Week
 * @param defaultUnit the unit used when one is not specified on a measure in the durationStr
 * @return the duration in seconds
 * @throws InvalidDurationException if its badly formatted duration
 */
public static long getDuration(String durationStr, int hoursPerDay, int daysPerWeek, final Duration defaultUnit) throws InvalidDurationException {
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationSeconds(durationStr, secondsInDay, secondsPerWeek, defaultUnit);
}

/**
 * Converts a number of seconds into a pretty formatted data string.  The resolution is in minutes.  So if the number of seconds is greater than a minute, it will
 * only be shown down top minute resolution.  If the number of seconds is less than a minute it will be shown in seconds.
 * <p/>
 * So for example <code>76</code> becomes <code>'1 minute'</code>, while <code>42</code> becomes <code>'42 seconds'</code>
 *
 * @param numSecs        the number of seconds in the duration
 * @param hoursPerDay    the hours in a day
 * @param daysPerWeek    the number of days in a week
 * @param resourceBundle a resouce bundle for i18n
 * @return a string in readable pretty duration format, using minute resolution
 */
public static String getDurationPretty(long numSecs, int hoursPerDay, int daysPerWeek, ResourceBundle resourceBundle) {
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationPrettySeconds(numSecs, secondsInDay, secondsPerWeek, resourceBundle, false);
}

/**
 * This function retrieves a duration in seconds that depends on number of hours in a day and
 * days in a week
 *
 * @param durationStr to convert to a duration
 * @param hoursPerDay Number of hourse i day
 * @param daysPerWeek Days Per Week
 * @param defaultUnit the unit used when one is not specified on a measure in the durationStr
 * @return the duration in seconds
 * @throws InvalidDurationException if its badly formatted duration
 */
public static long getDuration(String durationStr, int hoursPerDay, int daysPerWeek, final Duration defaultUnit) throws InvalidDurationException
{
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationSeconds(durationStr, secondsInDay, secondsPerWeek, defaultUnit);
}

/**
 * Converts a number of seconds into a pretty formatted data string.  The resolution is in minutes.  So if the number of seconds is greater than a minute, it will
 * only be shown down top minute resolution.  If the number of seconds is less than a minute it will be shown in seconds.
 * <p/>
 * So for example <code>76</code> becomes <code>'1 minute'</code>, while <code>42</code> becomes <code>'42 seconds'</code>
 *
 * @param numSecs        the number of seconds in the duration
 * @param hoursPerDay    the hours in a day
 * @param daysPerWeek    the number of days in a week
 * @param resourceBundle a resouce bundle for i18n
 * @return a string in readable pretty duration format, using minute resolution
 */
public static String getDurationPretty(long numSecs, int hoursPerDay, int daysPerWeek, ResourceBundle resourceBundle)
{
  long secondsInDay = hoursPerDay * Duration.HOUR.getSeconds();
  long secondsPerWeek = daysPerWeek * secondsInDay;
  return getDurationPrettySeconds(numSecs, secondsInDay, secondsPerWeek, resourceBundle, false);
}

/**
 * Given a duration string, get the number of seconds it represents (all case insensitive):
 * <ul>
 * <li>w = weeks
 * <li>d = days
 * <li>h = hours
 * <li>m = minutes
 * </ul>
 * ie 2h = 7200, 60m = 3600, 3d = 259200, 30m
 *
 * @param durationStr the duration string
 * @param defaultUnit the unit used when another is not specified in the durationStr
 * @return the duration in seconds
 * @throws InvalidDurationException if the duration is invalid
 */
public static long getDuration(final String durationStr, final Duration defaultUnit) throws InvalidDurationException {
  return getDurationSeconds(durationStr, Duration.DAY.getSeconds(), Duration.WEEK.getSeconds(), defaultUnit);
}

public long getMilliseconds() {
  return 1000L * getSeconds();
}

public String getDefaultTimeUnit()
{
  final Map<String, String> map = MapBuilder.<String, String>newBuilder()
      .add(DateUtils.Duration.MINUTE.name(), getText("core.dateutils.minute"))
      .add(DateUtils.Duration.HOUR.name(), getText("core.dateutils.hour"))
      .add(DateUtils.Duration.DAY.name(), getText("core.dateutils.day"))
      .add(DateUtils.Duration.WEEK.name(), getText("core.dateutils.week")).toMap();
  DateUtils.Duration defaultUnit;
  try
  {
    defaultUnit = DateUtils.Duration.valueOf(applicationProperties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_DEFAULT_UNIT));
  }
  catch (IllegalArgumentException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  catch (NullPointerException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  return map.get(defaultUnit.toString());
}

/**
 * Converts a number of seconds into a pretty formatted data string.  The resolution is in seconds.
 * <p/>
 * So for example <code>76</code> becomes <code>'1 minute, 16 seconds'</code>, while <code>42</code> becomes <code>'42 seconds'</code>
 *
 * @param numSecs        the number of seconds in the duration
 * @param resourceBundle a resouce bundle for i18n
 * @return a string in readable pretty duration format, using second resolution
 */
public static String getDurationPrettySecondsResolution(long numSecs, ResourceBundle resourceBundle)
{
  return getDurationPrettySeconds(numSecs, Duration.DAY.getSeconds(), Duration.WEEK.getSeconds(), resourceBundle, true);
}

/**
 * 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)
 *
 * @param duration string in JIRA's duration format (i.e. "20h")
 * @param locale Locale to use when interpreting the duration string
 * @return number of seconds in the duration string
 * @throws InvalidDurationException when the duration cannot be parsed
 */
public Long parseDuration(final String duration, Locale locale) throws InvalidDurationException
{
  //Retrieve the number of hours per day and number of days per week
  final BigDecimal hoursPerDay = timeTrackingConfiguration.getHoursPerDay();
  final BigDecimal daysPerWeek = timeTrackingConfiguration.getDaysPerWeek();
  final BigDecimal secondsPerHour = BigDecimal.valueOf(DateUtils.Duration.HOUR.getSeconds());
  final long secondsPerDay = hoursPerDay.multiply(secondsPerHour).longValueExact();
  final long secondsPerWeek = daysPerWeek.multiply(hoursPerDay).multiply(secondsPerHour).longValueExact();
  return DurationUtils.getDurationSeconds(duration, secondsPerDay, secondsPerWeek, timeTrackingConfiguration.getDefaultUnit(), locale, TOKEN_MAP);
}

private static String getDurationPrettySeconds(long numSecs, long secondsPerDay, long secondsPerWeek, ResourceBundle resourceBundle, boolean secondsDuration)
{
  return getDurationPrettySeconds(numSecs, Duration.YEAR.getSeconds(), secondsPerDay, secondsPerWeek, resourceBundle, secondsDuration);
}

/**
 * Given a duration string, get the number of seconds it represents (all case insensitive):
 * <ul>
 * <li>w = weeks
 * <li>d = days
 * <li>h = hours
 * <li>m = minutes
 * </ul>
 * ie 2h = 7200, 60m = 3600, 3d = 259200, 30m
 *
 * @param durationStr the duration string
 * @param defaultUnit the unit used when another is not specified in the durationStr
 * @return the duration in seconds
 * @throws InvalidDurationException if the duration is invalid
 */
public static long getDuration(final String durationStr, final Duration defaultUnit) throws InvalidDurationException
{
  return getDurationSeconds(durationStr, Duration.DAY.getSeconds(), Duration.WEEK.getSeconds(), defaultUnit);
}

public void setDefaultUnit(final String unit)
{
  try
  {
    defaultUnit = DateUtils.Duration.valueOf(unit.toUpperCase());
  }
  catch (IllegalArgumentException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  catch (NullPointerException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
}

public TimeTrackingAdmin(final ApplicationProperties applicationProperties, final FieldManager fieldManager, final JiraDurationUtils jiraDurationUtils, final JiraAuthenticationContext authenticationContext, final PluginAccessor pluginAccessor, final ReindexMessageManager reindexMessageManager, final FeatureManager featureManager)
{
  this.applicationProperties = applicationProperties;
  this.fieldManager = fieldManager;
  this.jiraDurationUtils = jiraDurationUtils;
  this.authenticationContext = authenticationContext;
  this.pluginAccessor = pluginAccessor;
  this.reindexMessageManager = notNull("reindexMessageManager", reindexMessageManager);
  this.featureManager = featureManager;
  hoursPerDay = applicationProperties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_HOURS_PER_DAY);
  daysPerWeek = applicationProperties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_DAYS_PER_WEEK);
  timeTrackingFormat = applicationProperties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_FORMAT);
  try
  {
    defaultUnit = DateUtils.Duration.valueOf(applicationProperties.getDefaultBackedString(APKeys.JIRA_TIMETRACKING_DEFAULT_UNIT));
  }
  catch (IllegalArgumentException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
  catch (NullPointerException e)
  {
    defaultUnit = DateUtils.Duration.MINUTE;
  }
}