> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用AI表格DATEDIF函数

> 📌更多函数可以参考公式函数大全

> 📌更多函数可以参考[公式函数大全](/zh/aitable/formulas/function-reference)

**DATEDIF**是一种在AI表格中使用的函数，用于计算两个日期之间的差值。它可以按年、月或天等不同的时间单位来返回结果，适用于需要精确计算日期差异的场景。

# 1 函数基础介绍

### **基本语法**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DATEDIF([开始日期], [结束日期], 单位)
```

* **开始日期**：计算日期差的起始日期。
* **结束日期**：计算日期差的终止日期。
* **单位**：指定返回值的时间单位。常见的单位包括：
  * **"Y"**：两个日期之间的完整年份数。
  * **"M"**：两个日期之间的完整月份数。
  * **"D"**：两个日期之间的天数。
  * **"MD"**：忽略年份和月份，仅计算两个日期之间相差的天数。
  * **"YM"**：忽略年份，仅计算两个日期之间相差的月数。
  * **"YD"**：忽略年份，仅计算两个日期之间相差的天数。

### **示例**

假设您有以下日期字段：\[开始日期]\[结束日期]

#### **示例 1：计算两个日期之间的完整年份差**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
=DATEDIF([开始日期], [结束日期], "Y")
```

#### **示例 2：计算两个日期之间的天数差**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
=DATEDIF([开始日期], [结束日期], "D")
```

# 2 常见场景案例

### 2.1 计算处理周期

利用函数计算\[派发时间]和\[执行时间]的间隔，从而掌握该门店的反应速度

```纯文本 theme={"theme":{"light":"github-light","dark":"github-dark"}}
DATEDIF([派发时间],[执行时间],"D")
```

<img src="https://mintcdn.com/dingtalk-8c0f98e2/b7BGrWpz3gF8nNyZ/zh/aitable/formulas/using-functions/datedif/images/onyx-yarrow.gif?s=5205943fbda386cc6f9e53e50738c1bf" alt="" width="1280" height="642" data-path="zh/aitable/formulas/using-functions/datedif/images/onyx-yarrow.gif" />

### 2.2 计算剩余天数

利用函数计算\[检查日期]和\[今天]所隔的天数，从而合理计划

```excel formula  theme={"theme":{"light":"github-light","dark":"github-dark"}}
DATEDIF(TODAY(),[检查日期],"D")
```

<img src="https://mintcdn.com/dingtalk-8c0f98e2/b7BGrWpz3gF8nNyZ/zh/aitable/formulas/using-functions/datedif/images/walnut-brook.gif?s=baf2c40944897ae85303125ecf65e68d" alt="" width="1280" height="641" data-path="zh/aitable/formulas/using-functions/datedif/images/walnut-brook.gif" />

# 3 常见问题

* 问：使用 DATEDIF 函数时返回值显示为 "#ERROR!" 怎么办？

  答：检查**DATEDIF**函数的参数中，结束时间是否早于开始时间。如果结束时间早于开始时间，可能会导致计算错误或返回不合理的负值。