# FormatDateTime

パターンで指定されたとおりにDateTime値から文字列を作成します。

このファンクションにより文字列が返されます。

## 関連する例

* [DateTimeエレメントの文字列への変換](https://help.qlik.com/talend/ja-JP/data-mapper-functions-reference-guide/8.0/converting-datetime-element-to-string)

## 引数

| 引数 | 定義 |
| --- | --- |
| [Value] (値) | フォーマットする値を指定します。 |

## [Properties] (プロパティ)

| [Properties] (プロパティ) | 定義 |
| --- | --- |
| Pattern | 値を日時に解析する時に使用するパターンを入力します。たとえば、YYYY-MM-ddというパターンは1960-09-11に解析されます。サンプルは、許可されている値のリストを参照してください。<br><br>パターンの文字数が形式を決めます。<br><br>Text : パターンの文字数が4字以上の場合は完全なフォームが使用されます。それ以下の場合は短縮フォームが使われます(短縮フォームがある場合)。<br><br>Number : 最小桁数。短い数値はゼロパディングで示されます。<br><br>Year : yearとweekyearのフィールドは特殊な数値表記で処理されます。たとえば、yが2桁の場合は、現在の世紀のゼロベースの年が2桁で示されます。<br><br>Month : 3桁以上の場合はテキストで、それ以外は数値で示されます。<br><br>Zone : Zはコロンなしでオフセットを出力し、ZZはコロン付きでオフセットを出力します。ZZZ以上はゾーンIDを出力します。<br><br>['a'..'z']および['A'..'Z']の範囲にないパターン の文字は、引用テキストとして処理されます。:、.、#、?といった文字やスペースは、単一引用符で囲まれていなくても、結果として得られる時間テキストに表示されます。 |

## 許可されている値

| 記号 | 説明 | 形式 | 例 |
| --- | --- | --- | --- |
| G | 時代 | テキスト | AD |
| C | 時代の世紀(&gt;=0) | 数字 | 20 |
| Y | 時代の年(&gt;=0) | 年 | 1996 |
| x | 週年 | 年 | 1996 |
| w | 週年の週 | 数字 | 27 |
| e | 週日 | 数字 | 2 |
| E | 週日 | テキスト | Tuesday、Tue |
| y | 年 | 年 | 1996 |
| D | 年の日 | 数字 | 189 |
| M | 年の月 | 月 | July、Jul、07 |
| d | 月の日 | 数字 | 10 |
| a | 日の半日 | テキスト | PM |
| K | 半日の時間(0-11) | 数字 | 0 |
| h | 半日の時刻(1-12) | 数字 | 12 |
| H | 日の時刻(0-23) | 数字 | 0 |
| k | 日の丸々1時間(1-24) | 数字 | 24 |
| m | 時刻の分 | 数字 | 30 |
| s | 分の秒 | 数字 | 55 |
| S | 秒のミリ秒 | 数字 | 978 |
| z | タイムゾーン | テキスト | Pacific Standard Time、PST |
| Z | タイムゾーンオフセット/ID | ゾーン | -0800、-08:00、America/Los\_Angeles |
| ' | テキストのエスケープ | 区切り | 該当しません。 |
| '' | 一重引用符 | リテラル | ' |