nice-duration 0.7.0

Nice formatting of timedelta instances

nice_duration

This is a Python module that introduces a way of formatting a timedelta instance like so: 3h12m. It can also format an int representing a number of seconds in the same way.

The separator parameter, which defaults to the empty string, determines what the individual components are concatenated with. Setting separator to a single space changes the above example to 3h 12m.

Components with value 0 are left out. That can be changed by setting

• keep_leading_zeroes
• keep_trailing_zeroes
• keep_infix_zeroes

For example, by setting keep_trailing_zeroes to True, the example duration_string is changed to 3h12m0s.

For convenience, setting keep_zeroes to True will set all three keep_*_zeroes to True.

** Examples

>>> from datetime import timedelta
>>> from nice_duration import duration_string
>>> delta = timedelta(hours=3, minutes=20)
>>> duration_string(delta)
'3h20m'

>>> duration_string(200) # When an int is given, it is interpreted as a number of seconds
'3h20m'

Setting separator:

>>> duration_string(delta, separator=" ")
'3h 20m'

Setting keep_zeroes:

>>> duration_string(delta, keep_zeroes=True)
'0w0d3h20m0s'

Setting keep_trailing_zeroes:

>>> duration_string(delta, keep_trailing_zeroes=True)
'3h20m0s'

Setting keep_leading_zeroes:

>>> duration_string(delta, keep_leading_zeroes=True)
'0w0d3h20m'

Setting keep_infix_zeroes:

>>> duration_string(timedelta(hours=3, seconds=11), keep_infix_zeroes=True)
'3h0m11s'

Return value when timedelta is 0:

>>> duration_string(timedelta())
'0s'