本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# dateDiff
<a name="dateDiff-function"></a>

`dateDiff` 會以天為單位，傳回兩個日期欄位之間的差異。如果您包含的值為一段期間，`dateDiff` 傳回的差異則以期間間隔為單位，而非以天為單位。

## 語法
<a name="dateDiff-function-syntax"></a>

```
dateDiff(date1, date2,[period])
```

## 引數
<a name="dateDiff-function-arguments"></a>

`dateDiff` 需要兩個日期做為引數。指定期間為選用。

 *date 1*   
第一個日期比較。日期欄位或對輸出日期的另一個函數的呼叫。

 *date 2*   
第二個日期比較。日期欄位或對輸出日期的另一個函數的呼叫。

 *period*   
您想要傳回差異的期間，將其括在引號中。有效的期間如下：  
+ YYYY：這會傳回日期的年份部分。
+ Q：這會傳回日期所屬的季別第一天的日期。
+ MM：這會傳回日期的月份部分。
+ DD：這會傳回日期的日部分。
+ WK：這會傳回日期的週部分。本週從 Amazon Quick 的星期日開始。
+ HH：這會傳回日期的小時部分。
+ MI：這會傳回日期的分鐘部分。
+ SS：這會傳回日期的秒部分。
+ MS：這會傳回日期的毫秒部分。

## 傳回類型
<a name="dateDiff-function-return-type"></a>

Integer

## 範例
<a name="dateDiff-function-example"></a>

以下範例會傳回兩個日期之間的差異。

```
dateDiff(orderDate, shipDate, "MM")
```

以下是指定欄位的值。

```
orderDate          shipdate
=============================
01/01/18            03/05/18
09/13/17            10/20/17
```

對於這些欄位值，會傳回以下值。

```
2
1
```