# **DATEDIF**

返回两个日期之间的天数、月数或年数。返回的天数不包含结束日期，返回的月份会包含结束月份，返回的年份会包括结束年份。

## 语法{#grammar}

DATEDIF(**dateStart**, **dateEnd**, **\[type]**)

- **dateStart**：必需，起始日期
- **dateEnd**：必需，结束日期
- **type**：可选，计算类型，默认计算的是两个日期之间相隔的年份，详见[时间间隔类型](../../types.md#relative)

**示例地址：** [DATEDIF](https://demo.succbi.com/v5/bi/datedif)

## 示例{#example}

1. `DATEDIF("20200715","20210716","y")` 返回日期之间相隔的年数，返回数值`1`
2. `DATEDIF("20200715","20180717","y")` 结束日期小于起始日期，返回数值`-2`
3. `DATEDIF("20200715","20210716","m")` 返回两个日期之间的月数，返回数值`12`
4. `DATEDIF("20200715","20210716","d")` 返回两个日期之间的天数，返回数值`366`
5. `DATEDIF("20200715","20210915","ym")` 返回两个日期之间相隔的月份，忽略年份，返回数值`2`
6. `DATEDIF("20120101", "20130202", "yd")` 返回两个日期之间相隔的天数，忽略年份，返回数值`32`
7. `DATEDIF("20120101", "20130202", "md")` 返回两个日期之间相隔的天数，忽略年份和月份，返回数值`1`
8. `DATEDIF("2020-07-21","2020-07-23","d")` 日期格式为yyyy-mm-dd，返回数值`2`
9. `DATEDIF("2020.07.21","2020.07.23","d")` 日期格式为yyyy.mm.dd，返回数值`2`
10. `DATEDIF("2020/07/21","2020/07/23","d")` 日期格式为yyyy/mm/dd，返回数值`2`
11. `DATEDIF("2020 07 21","2020 07 23","d")` 日期格式为yyyy mm dd，返回数值`2`
12. `DATEDIF(DATE(2021,1,26,0,1,1),DATE(2021,1,27,0,2,2))` 转换为日期对象后返回日期之间间隔的天数，返回数值`1`，[DATE](./DATE.md)函数
13. `DATEDIF(TODATE("20210126000101","yyyymmddhhmmss"),TODATE("20210127000202","yyyymmddhhmmss"),"d")` 返回日期对象后返回日期之间间隔的天数，返回数值`1`，[TODATE](../transform/TODATE.md)函数
14. `DATEDIF(A1,A2,"d")` 引用单元格，返回`A1`到`A2`之间的天数
15. `DATEDIF([起始日期],[截止日期],"d")` 引用模型字段，返回`起始日期`到`截止日期`之间的天数