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

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

`truncDate` 會傳回代表日期指定部分的日期值。例如，請求值 2012-09-02T00:00:00.000Z 的年份部分會傳回 2012-01-01T00:00:00.000Z。指定未包含時間資訊之日期的時間相關期間，會傳回保持不變的初始日期值。

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

```
truncDate('period', date)
```

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

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

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

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

Date

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

下列範例會傳回代表訂單日期月份的日期。

```
truncDate('MM', orderDate)
```

以下是指定欄位的值。

```
orderDate      
=========
2012-12-14T00:00:00.000Z  
2013-12-29T00:00:00.000Z
2012-11-15T00:00:00.000Z
```

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

```
2012-12-01T00:00:00.000Z
2013-12-01T00:00:00.000Z
2012-11-01T00:00:00.000Z
```