# Format

URL: https://caijiao.org/dayjs/durations/format
Source: docs/dayjs/durations/format.md
Description: 使用'dayjs.duration().format()'可以根据传入的占位符返回格式化后的时长。支持的占位符有'Y'（年）、'M'（月）、'D'（日）、'H'（小时）、'm'（分钟）、's'（秒）、'SSS'（毫秒）等。

根据传入的占位符返回格式化后的时长。

将字符放在方括号中，即可原样返回而不被格式化替换 (例如， `[MM]`)。

```javascript
dayjs
  .duration({
    seconds: 1,
    minutes: 2,
    hours: 3,
    days: 4,
    months: 6,
    years: 7,
  })
  .format("YYYY-MM-DDTHH:mm:ss"); // 0007-06-04T03:02:01
```

## 支持的格式化占位符列表

| Format | 输出    | 详情            |
| ------ | ------- | --------------- |
| `Y`    | 18      | 年              |
| `YY`   | 18      | 年，两位数      |
| `YYYY` | 2018    | 年，四位数      |
| `M`    | 1-12    | 月份，从 1 开始 |
| `MM`   | 01-12   | 月份，两位数    |
| `D`    | 1-31    | 日              |
| `DD`   | 01-31   | 日，两位数      |
| `H`    | 0-23    | 小时            |
| `HH`   | 00-23   | 小时，两位数    |
| `m`    | 0-59    | 分钟            |
| `mm`   | 00-59   | 分钟，两位数    |
| `s`    | 0-59    | 秒              |
| `ss`   | 00-59   | 秒 两位数       |
| `SSS`  | 000-999 | 毫秒 三位数     |