How to convert Period or Duration to proper string

[Exenifix]

I want some kind of Duration with 6 minutes and 58 seconds to look like this when casted to str

"0:06:58"

Is there a builtin function for formatting Durations or I gotta do it by myself

[agammann]

For that representation, convert the duration to a standard datetime.timedelta with as_timedelta():

import pendulum

duration = pendulum.duration(minutes=6, seconds=58)
print(str(duration.as_timedelta()))
# 0:06:58

I checked this with Pendulum 3.2.0. str(duration) gives 6 minutes 58 seconds, while str(duration.as_timedelta()) gives the exact representation in your question. The implementation exposes the conversion and uses in_words() for the duration's own string representation.

This follows standard timedelta formatting: a 27-hour duration displays 1 day, 3:00:00, and fractional seconds are included when present. If you want total hours such as 27:00:00, that would need a custom format.