# Difference

URL: https://caijiao.org/dayjs/display/difference
Source: docs/dayjs/display/difference.md
Description: 使用 dayjs 的 Difference 方法可以返回两个日期时间之间的差异，支持毫秒、月等单位，并可选择返回浮点数。各单位支持缩写，且区分大小写。

返回指定单位下两个日期时间之间的差异。

要获得以毫秒为单位的差异，请使用 `dayjs#diff`。

```javascript
const date1 = dayjs("2019-01-25");
const date2 = dayjs("2018-06-05");
date1.diff(date2); // 20214000000 默认单位是毫秒
```

要获取其他单位下的差异，则在第二个参数传入相应的单位。

```javascript
const date1 = dayjs("2019-01-25");
date1.diff("2018-06-05", "month"); // 7
```

默认情况下， `dayjs#diff` 会将结果截去小数部分，返回一个整数。 如果要得到一个浮点数，将 true 作为第三个参数传入。

```javascript
const date1 = dayjs("2019-01-25");
date1.diff("2018-06-05", "month", true); // 7.645161290322581
```

## 支持的单位列表

各个传入的单位对大小写不敏感，支持缩写和复数。 请注意，缩写是区分大小写的。

<table>
<thead>
<tr><th>单位</th><th>缩写</th><th>详情</th></tr>
</thead>
<tbody>
<tr><td><code>day</code></td><td><code>d</code></td><td>日</td></tr>
<tr><td><code>week</code></td><td><code>w</code></td><td>Week of Year</td></tr>
<tr><td><code>quarter</code></td><td><code>Q</code></td><td>Quarter</td></tr>
<tr><td><code>month</code></td><td><code>M</code></td><td>月份 (一月 0， 十二月 11)</td></tr>
<tr><td><code>year</code></td><td><code>y</code></td><td>Year</td></tr>
<tr><td><code>hour</code></td><td><code>h</code></td><td>Hour</td></tr>
<tr><td><code>minute</code></td><td><code>m</code></td><td>Minute</td></tr>
<tr><td><code>second</code></td><td><code>s</code></td><td>Second</td></tr>
<tr><td><code>millisecond</code></td><td><code>ms</code></td><td>Millisecond</td></tr>
</tbody>
</table>