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

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

`formatDate` 會使用您指定的模式設定日期格式。在您準備資料時，您可以使用 `formatDate` 來重新格式化日期。若要重新格式化分析中的日期，您可以從日期欄位的內容功能表中選擇 format (格式) 選項。

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

```
formatDate(date, ['format'])
```

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

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

 *format*   
(選用) 包含要套用的格式模式的字串。此引數接受[以支援的日期格式指定的格式](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html)模式。  
如果您不指定格式，這個字串預設為 yyyy-MM-dd**T**kk:mm:ss:SSS。

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

String

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

下列範例將 UTC 日期格式化。

```
formatDate(orderDate, 'dd-MMM-yyyy')
```

以下是指定欄位的值。

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

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

```
13 Dec 2012
28 Dec 2013
14 Nov 2012
```

## 範例
<a name="formatDate-function-example2"></a>

如果日期包含單引號或撇號，例如 `yyyyMMdd'T'HHmmss`，您可以使用下列方法之一來處理此日期格式。
+ 將整個日期用雙引號括起來，如下例所示：

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ 透過在單引號或撇號左側新增反斜線 (`\`) 讓單引號或撇號進行逸出，如下例所示：

  ```
  formatDate({myDateField}, 'yyyyMMdd\'T\'HHmmss')
  ```