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

# DATE\_TRUNC 函數
<a name="DATE_TRUNC"></a>

DATE\_TRUNC 函數會根據您指定的日期部分 (例如小時、天或月) 來截斷時間戳記運算式或常值。

## 語法
<a name="DATE_TRUNC-synopsis"></a>

```
date_trunc(format, datetime) 
```

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

 *format*   
代表要截斷之單位的格式。有效格式如下：  
+ "YEAR"、"YYYY"、"YY" - 截斷至 ts 所在年份的第一天，時間部分將為零
+ "QUARTER" - 截斷至 ts 所在季度的第一天，時間部分將為零
+ "MONTH"、"MM"、"MON" - 截斷至 ts 所在月份的第一天，時間部分將為零
+ "WEEK" - 截斷至 ts 所在一週的星期一，時間部分將為零
+ "DAY"、"DD" - 零時間部分
+ "HOUR" - 以分數部分將分鐘和秒歸零
+ "MINUTE"- 以分數部分將秒數歸零
+ "SECOND" - 將第二個分數部分歸零
+ "MILLISECOND" - 微秒零
+ "MICROSECOND" - 所有項目仍保留

 *ts*   
日期時間值

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

傳回截**斷至格式模型所指定單位的時間戳記

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

下列範例會將日期值截斷為年初。輸出顯示日期 "2015-03-05" 已截斷為 "2015-01-01"，這是 2015 年的開始。

```
SELECT date_trunc('YEAR', '2015-03-05');
 
 date_trunc
-----------
2015-01-01
```