翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

`formatDate` は、指定されたパターンを使用して日付を書式設定します。データを準備するときに、`formatDate` を使用して日付を再フォーマットできます。分析で日付の書式を変更するには、日付フィールドのコンテキストメニューから書式オプションを選択します。

## 構文
<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')
  ```