158

Does anyone know of a Java library that can pretty print a number in milliseconds in the same way that C# does?

E.g., 123456 ms as a long would be printed as 4d1h3m5s.

6
  • 1
    FYI, the format you seem to be describing is a Duration defined in the sensible standard, ISO 8601: PnYnMnDTnHnMnS where P means "Period" and marks the beginning, T separates the date portion from time portion, and in between are optional occurrances of a number with a single-letter abbreviation. For example, PT4H30M = four and a half hours. Commented Mar 23, 2014 at 8:54
  • 1
    If all else fails it's a very simple matter to do it yourself. Just use successive applications of % and / to split the number into parts. Almost easier than some of the proposed answers.
    – Hot Licks
    Commented Sep 10, 2014 at 11:51
  • @HotLicks Leave it to library methods for much cleaner and clearer code than using / and %.
    – Anonymous
    Commented Jun 26, 2018 at 5:48
  • Yes, in the intervening 8 years since I asked this question (!) I've moved over to joda time which suits my use case very well
    – phatmanace
    Commented Jun 26, 2018 at 16:38
  • 3
    @phatmanace The Joda-Time project is now in maintenance-mode, and advises migration to the java.time classes built into Java 8 and later. Commented Aug 9, 2018 at 13:42

13 Answers 13

146

I've built a simple solution, using Java 8's Duration.toString() and a bit of regex:

public static String humanReadableFormat(Duration duration) {
    return duration.toString()
            .substring(2)
            .replaceAll("(\\d[HMS])(?!$)", "$1 ")
            .toLowerCase();
}

The result will look like:

- 5h
- 7h 15m
- 6h 50m 15s
- 2h 5s
- 0.1s

If you don't want spaces between, just remove replaceAll.

10
  • 13
    You should never rely on the output of toStrong() because this may change in further versions. Commented May 10, 2017 at 16:46
  • 23
    @Weltraumschaf it's not likely to change, since it's specified in the javadoc Commented Jul 19, 2017 at 16:13
  • 17
    @Weltraumschaf Unlikely to change as the output of Duration::toString is formatted according to the well-defined and well-worn ISO 8601 standard. Commented Jul 19, 2017 at 18:34
  • 3
    If you don't want fractions, add .replaceAll("\\.\\d+", "") before the call to toLowerCase().
    – zb226
    Commented Mar 13, 2020 at 14:55
  • 8
    @Weltraumschaf Your point in generally correct and I wouldn't myself rely on the toString() output of most classes. But in this very specific case, the method definition states that its output follows the ISO-8601 standard, as you can see in the method's Javadoc. So it's not an implementation detail like in most classes, therefore not something I would expect a language as mature as Java to change like that,
    – lucasls
    Commented Apr 15, 2020 at 16:08
94

Joda Time has a pretty good way to do this using a PeriodFormatterBuilder.

Quick Win: PeriodFormat.getDefault().print(duration.toPeriod());

e.g.

//import org.joda.time.format.PeriodFormatter;
//import org.joda.time.format.PeriodFormatterBuilder;
//import org.joda.time.Duration;

Duration duration = new Duration(123456); // in milliseconds
PeriodFormatter formatter = new PeriodFormatterBuilder()
     .appendDays()
     .appendSuffix("d")
     .appendHours()
     .appendSuffix("h")
     .appendMinutes()
     .appendSuffix("m")
     .appendSeconds()
     .appendSuffix("s")
     .toFormatter();
String formatted = formatter.print(duration.toPeriod());
System.out.println(formatted);
4
  • 3
    It appears from an answer below that an instance of Period can be created directly, without first creating a Duration instance and then converting it to Period. E.g. Period period = new Period(millis); String formatted = formatter.print(period); Commented Aug 12, 2013 at 23:15
  • 7
    Beware of this "duration.toPeriod()" conversion. If the duration is quite big, the day portion onwards would remain as 0. The hours portion will keep growing. You will get 25h10m23s but never get the "d". The reason is there is no fully correct way to convert hours to days in Joda's strict ways. Most of the cases, if you are comparing two instants and wanting to print it, you can do new Period(t1, t2) instead of new Duration(t1, t2).toPeriod().
    – Boon
    Commented Apr 9, 2015 at 6:43
  • @Boon do you know how to convert duration to period with respect to days? I use duration from which I can substitute second in my on my timer. Event setting PeriodType.daysTime() or .standard() didn't help
    – Piotr
    Commented Aug 19, 2016 at 12:57
  • 4
    @murt If you really want to, and can accept the standard definition of a day, then you can "formatter.print(duration.toPeriod().normalizedStandard())" in the code above. Have fun!
    – Boon
    Commented Aug 20, 2016 at 16:22
37

Apache commons-lang provides the DurationFormatUtils class to get this done as well. It has several formatting methods like formatDurationHMS and formatDurationISO, but if you just want a nice output, use:

DurationFormatUtils.formatDurationWords(123456, true, true);

Result

2 minutes 3 seconds
0
23

Java 9+

Duration d1 = Duration.ofDays(0);
        d1 = d1.plusHours(47);
        d1 = d1.plusMinutes(124);
        d1 = d1.plusSeconds(124);
System.out.println(String.format("%s d %sh %sm %ss", 
                d1.toDaysPart(), 
                d1.toHoursPart(), 
                d1.toMinutesPart(), 
                d1.toSecondsPart()));

2 d 1h 6m 4s

1
  • How are you getting "toHoursPart" and above? Commented Apr 27, 2020 at 1:52
20

org.threeten.extra.AmountFormats.wordBased

The ThreeTen-Extra project, which is maintained by Stephen Colebourne, the author of JSR 310, java.time, and Joda-Time, has an AmountFormats class which works with the standard Java 8 date time classes. It's fairly verbose though, with no option for more compact output.

Duration d = Duration.ofMinutes(1).plusSeconds(9).plusMillis(86);
System.out.println(AmountFormats.wordBased(d, Locale.getDefault()));

1 minute, 9 seconds and 86 milliseconds

3
  • 5
    Wow, nice to know, I’ve not seen that feature. Has one major flaw though: Missing the Oxford comma. Commented Apr 19, 2019 at 3:43
  • 5
    @BasilBourque The Oxford comma is typical for US, but interestingly not for UK. My lib Time4J (which has a far better internationalization) supports this distinction in the class net.time4j.PrettyTime and also allows control over compact output if desired. Commented Apr 19, 2019 at 5:38
  • 1
    FYI, you can add an Oxford comma in ThreeTen-Extra by providing your own locale for the wordbased ResourceBundle, and overriding the WordBased.spaceandspace key. You could do this by putting a file named org/threeten/extra/wordbased_ox.properties on your ClassPath with contents WordBased.spaceandspace=, and . Then, if you use Locale.forLanguageTag("ox") the Oxford comma will be added automatically. Source is here: github.com/ThreeTen/threeten-extra/blob/master/src/main/… Commented Mar 29, 2022 at 10:22
12

Another Java 9+ solution:

private String formatDuration(Duration duration) {
    List<String> parts = new ArrayList<>();
    long days = duration.toDaysPart();
    if (days > 0) {
        parts.add(plural(days, "day"));
    }
    int hours = duration.toHoursPart();
    if (hours > 0 || !parts.isEmpty()) {
        parts.add(plural(hours, "hour"));
    }
    int minutes = duration.toMinutesPart();
    if (minutes > 0 || !parts.isEmpty()) {
        parts.add(plural(minutes, "minute"));
    }
    int seconds = duration.toSecondsPart();
    parts.add(plural(seconds, "second"));
    return String.join(", ", parts);
}

private String plural(long num, String unit) {
    return num + " " + unit + (num == 1 ? "" : "s");
}

E.g.,

6 days, 21 hours, 2 minutes, 14 seconds
3
11

A Java 8 version based on user678573's answer:

private static String humanReadableFormat(Duration duration) {
    return String.format("%s days and %sh %sm %ss", duration.toDays(),
            duration.toHours() - TimeUnit.DAYS.toHours(duration.toDays()),
            duration.toMinutes() - TimeUnit.HOURS.toMinutes(duration.toHours()),
            duration.getSeconds() - TimeUnit.MINUTES.toSeconds(duration.toMinutes()));
}

... since there is no PeriodFormatter in Java 8 and no methods like getHours, getMinutes, ...

I'd be happy to see a better version for Java 8.

4
  • throws java.util.IllegalFormatConversionException: f != java.lang.Long Commented Aug 8, 2018 at 20:00
  • with Duration d1 = Duration.ofDays(0); d1 = d1.plusHours(47); d1 = d1.plusMinutes(124); d1 = d1.plusSeconds(124); System.out.println(String.format("%s days and %sh %sm %1.0fs", d1.toDays(), d1.toHours() - TimeUnit.DAYS.toHours(d1.toDays()), d1.toMinutes() - TimeUnit.HOURS.toMinutes(d1.toHours()), d1.toSeconds() - TimeUnit.MINUTES.toSeconds(d1.toMinutes()))); Commented Aug 8, 2018 at 20:03
  • @erickdeoliveiraleal Thanks for pointing that out. I think I was originally writing the code for groovy, so it might have worked in that language. I corrected it for java now.
    – Torsten
    Commented Aug 9, 2018 at 13:07
  • what about yeah month day? 2 years 11 months 28 days
    – user924
    Commented Nov 28, 2023 at 14:09
10

JodaTime has a Period class that can represent such quantities, and can be rendered (via IsoPeriodFormat) in ISO8601 format, e.g. PT4D1H3M5S, e.g.

Period period = new Period(millis);
String formatted = ISOPeriodFormat.standard().print(period);

If that format isn't the one you want, then PeriodFormatterBuilder lets you assemble arbitrary layouts, including your C#-style 4d1h3m5s.

1
  • 3
    Just as a note, new Period(millis).toString() uses the ISOPeriodFormat.standard() by default. Commented May 28, 2014 at 17:32
10

Here's how you can do it using pure JDK code:

import javax.xml.datatype.DatatypeFactory;
import javax.xml.datatype.Duration;

long diffTime = 215081000L;
Duration duration = DatatypeFactory.newInstance().newDuration(diffTime);

System.out.printf("%02d:%02d:%02d", duration.getDays() * 24 + duration.getHours(), duration.getMinutes(), duration.getSeconds()); 
10

An alternative to the builder-approach of Joda-Time would be a pattern-based solution. This is offered by my library Time4J. Example using the class Duration.Formatter (added some spaces for more readability - removing the spaces will yield the wished C#-style):

IsoUnit unit = ClockUnit.MILLIS;
Duration<IsoUnit> dur = // normalized duration with multiple components
  Duration.of(123456, unit).with(Duration.STD_PERIOD);
Duration.Formatter<IsoUnit> f = // create formatter/parser with optional millis
  Duration.Formatter.ofPattern("D'd' h'h' m'm' s[.fff]'s'");

System.out.println(f.format(dur)); // output: 0d 0h 2m 3.456s

This formatter can also print durations of java.time-API (however, the normalization features of that type are less powerful):

System.out.println(f.format(java.time.Duration.ofMillis(123456))); // output: 0d 0h 2m 3.456s

The expectation of the OP that "123456 ms as a long would be printed as 4d1h3m5s" is calculated in an obviously wrong way. I assume sloppiness as reason. The same duration formatter defined above can also be used as parser. The following code shows that "4d1h3m5s" rather corresponds to 349385000 = 1000 * (4 * 86400 + 1 * 3600 + 3 * 60 + 5):

System.out.println(
  f.parse("4d 1h 3m 5s")
   .toClockPeriodWithDaysAs24Hours()
   .with(unit.only())
   .getPartialAmount(unit)); // 349385000

Another way is using the class net.time4j.PrettyTime (which is also good for localized output and printing relative times like "yesterday", "next Sunday", "4 days ago" etc.):

String s = PrettyTime.of(Locale.ENGLISH).print(dur, TextWidth.NARROW);
System.out.println(s); // output: 2m 3s 456ms

s = PrettyTime.of(Locale.ENGLISH).print(dur, TextWidth.WIDE);
System.out.println(s); // output: 2 minutes, 3 seconds, and 456 milliseconds

s = PrettyTime.of(Locale.UK).print(dur, TextWidth.WIDE);
System.out.println(s); // output: 2 minutes, 3 seconds and 456 milliseconds

The text width controls if abbreviations are used or not. The list format can be controlled, too, by choosing the appropriate locale. For example, standard English uses the Oxform comma, while UK does not. The latest version v5.5 of Time4J supports more than 90 languages and uses translations based on the CLDR-repository (an industry standard).

2
  • 2
    this PrettyTime is way better than the one in the other answer! too bad I didn't find this first.
    – ycomp
    Commented Jan 6, 2018 at 11:05
  • I don't know why there are now two downvotes for this well working solution so I have decided to extend the answer by giving more examples also about parsing (the opposite of formatting) and to highlight the wrong expectation of the OP. Commented Feb 12, 2020 at 23:07
7

With Java 8 you can also use the toString() method of java.time.Duration to format it without external libraries using ISO 8601 seconds based representation such as PT8H6M12.345S.

3
  • 4
    Note that this does not print days Commented Jan 28, 2016 at 15:58
  • 90
    Not sure this format meets my definition of pretty print. :-) Commented Dec 2, 2016 at 19:21
  • @james.garriss To make it a little prettier, see the Answer by erickdeoliveiraleal. Commented Aug 8, 2018 at 22:02
2

I realize this might not fit your use case exactly, but PrettyTime might be useful here.

PrettyTime p = new PrettyTime();
System.out.println(p.format(new Date()));
//prints: “right now”

System.out.println(p.format(new Date(1000*60*10)));
//prints: “10 minutes from now”
2
  • 4
    Is it possible to have just "10 minutes" ?
    – Johnny
    Commented Nov 24, 2016 at 13:18
  • 3
    Not an answer - the question was about the Duration type, not Date.
    – Jolta
    Commented Apr 25, 2023 at 7:18
0

naive kotlin version (avoiding to*Part functions, to work with Android)

fun prettyFormatSecondsToDuration(seconds: Long): String {
    val duration = java.time.Duration.ofSeconds(seconds)
    return buildString {
        val hours = duration.toHours()
        if (hours > 0) append("${hours}h ")

        val minutes = duration.minusHours(hours).toMinutes()
        if (minutes > 0) append("${minutes}m ")

        val partSeconds = duration.minusHours(hours).minusMinutes(minutes).seconds
        if (partSeconds > 0) append("${partSeconds}s ")
    }.trimEnd()
}
1
  • Thanks. I believe the toXxxPart methods are available on Android through desugaring.
    – Anonymous
    Commented Mar 14 at 14:39

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.