---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/tools/datetime_math/variables/durationFormatTool.md
description: Convert total seconds into a human-readable duration string.
---

# Variable: durationFormatTool

```ts
const durationFormatTool: Tool<SpooledArtifact>;
```

Defined in: [batteries/tools/datetime\_math/index.ts:163](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/tools/datetime_math/index.ts#L163)

Convert total seconds into a human-readable duration string.

## Remarks

Examples: `3725` → `1 hour, 2 minutes and 5 seconds`. Negative inputs are prefixed with `-`.
Zero seconds returns the literal `0 seconds`.