# Format

URL: https://caijiao.org/dayjs/display/format
Source: docs/dayjs/display/format.md
Description: 使用 dayjs 的 format 方法，可以根据传入的占位符返回格式化后的日期。支持多种格式化占位符，如 YYYY 表示四位数年份，MM 表示两位数月份，DD 表示两位数日期等。例如，dayjs("2019-01-25").format("DD/MM/YYYY") 会返回 "25/01/2019"。可以通过将字符放在方括号中（例如，[MM]）来保持原样返回。

根据传入的占位符返回格式化后的日期。

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

```javascript
dayjs().format();
// 默认返回的是 ISO8601 格式字符串 '2020-04-02T08:02:17-05:00'

dayjs("2019-01-25").format("[YYYYescape] YYYY-MM-DDTHH:mm:ssZ[Z]");
// 'YYYYescape 2019-01-25T00:00:00-02:00Z'

dayjs("2019-01-25").format("DD/MM/YYYY"); // '25/01/2019'
```

支持的格式化占位符列表

<table>
<thead>
<tr><th>占位符</th><th>输出</th><th>详情</th></tr>
</thead>
<tbody>
<tr><td><code>YY</code></td><td>18</td><td>两位数的年份</td></tr>
<tr><td><code>YYYY</code></td><td>2018</td><td>四位数的年份</td></tr>
<tr><td><code>M</code></td><td>1-12</td><td>月份，从 1 开始</td></tr>
<tr><td><code>MM</code></td><td>01-12</td><td>月份，两位数</td></tr>
<tr><td><code>MMM</code></td><td>Jan-Dec</td><td>缩写的月份名称</td></tr>
<tr><td><code>MMMM</code></td><td>January-December</td><td>完整的月份名称</td></tr>
<tr><td><code>D</code></td><td>1-31</td><td>月份里的一天</td></tr>
<tr><td><code>DD</code></td><td>01-31</td><td>月份里的一天，两位数</td></tr>
<tr><td><code>d</code></td><td>0-6</td><td>一周中的一天，星期天是 0</td></tr>
<tr><td><code>dd</code></td><td>Su-Sa</td><td>最简写的星期几</td></tr>
<tr><td><code>ddd</code></td><td>Sun-Sat</td><td>简写的星期几</td></tr>
<tr><td><code>dddd</code></td><td>Sunday-Saturday</td><td>星期几</td></tr>
<tr><td><code>H</code></td><td>0-23</td><td>小时</td></tr>
<tr><td><code>HH</code></td><td>00-23</td><td>小时，两位数</td></tr>
<tr><td><code>h</code></td><td>1-12</td><td>小时, 12 小时制</td></tr>
<tr><td><code>hh</code></td><td>01-12</td><td>小时, 12 小时制, 两位数</td></tr>
<tr><td><code>m</code></td><td>0-59</td><td>分钟</td></tr>
<tr><td><code>mm</code></td><td>00-59</td><td>分钟，两位数</td></tr>
<tr><td><code>s</code></td><td>0-59</td><td>秒</td></tr>
<tr><td><code>ss</code></td><td>00-59</td><td>秒 两位数</td></tr>
<tr><td><code>SSS</code></td><td>000-999</td><td>毫秒 三位数</td></tr>
<tr><td><code>Z</code></td><td>+05:00</td><td>UTC 的偏移量，±HH:mm</td></tr>
<tr><td><code>ZZ</code></td><td>+0500</td><td>UTC 的偏移量，±HHmm</td></tr>
<tr><td><code>A</code></td><td>AM PM</td><td></td></tr>
<tr><td><code>a</code></td><td>am pm</td><td></td></tr>
<tr><td>...</td><td>...</td><td>其他格式 (
    依赖
    <a href="../plugin/advanced-format">
      <code>AdvancedFormat</code>
    </a>
    插件
    )</td></tr>
</tbody>
</table>