---
url: "https://vueda.dev/v3/reference/api/js/utils/duration/functions/convertDurationToString.md"
title: "convertDurationToString"
---

# convertDurationToString

## Overview

Serializes a duration plain object into DRF's duration string (`[D ]HH:MM:SS`), the format a Django
`DurationField` reads. Missing units count as zero, and larger units absorb overflow, so
`{ minutes: 90 }` serializes as `01:30:00`. The day count appears only when it is nonzero. A
negative total carries its sign on the day count while the clock part stays positive, as Django
writes it: minus one hour is `-1 23:00:00`. Sub-second precision is dropped.

## Signature

`convertDurationToString(durationObject)`

### Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| <span id="param-durationObject">durationObject</span> | `object` | yes | The duration to serialize. |

#### durationObject Properties

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <span id="param-durationObject-days">days</span> | `number` | no |  |  |
| <span id="param-durationObject-hours">hours</span> | `number` | no |  |  |
| <span id="param-durationObject-minutes">minutes</span> | `number` | no |  |  |
| <span id="param-durationObject-seconds">seconds</span> | `number` | no |  |  |

### Returns

`string`

The formatted duration string.

## Source

`client/lib/utils/duration.js:37`