Lightning コンポーネント開発者ガイド
jJavaScript での日付の書式設定
AuraLocalizationService JavaScript API では、日付の書式設定とローカライズを処理するメソッドを使用できます。
たとえば、formatDate() メソッドは、2 つ目の引数として設定された formatString パラメータに基づいて日付を書式設定します。
1formatDate (String | Number | Date date, String formatString)date パラメータには、String、Number、または最も一般的な JavaScript の Date を使用できます。String 値を指定する場合、解析エラーを避けるために ISO 8601 形式を使用します。
formatString パラメータには、日時を書式設定するトークンが含まれます。たとえば、"YYYY-MM-DD" では 15th January, 2017 が "2017-01-15" と書式設定されます。デフォルトの形式文字列は、$Locale 値プロバイダから提供されます。
次の表に、formatString でサポートされているトークンのリストを示します。
| 説明 | トークン | 出力 |
|---|---|---|
| 日付 | d | 1 … 31 |
| 日付 | dd | 01 … 31 |
| 日付。非推奨。同一の dd を使用。 | DD | 01 … 31 |
| 曜日 (数値) | E | 0 … 6 |
| 曜日 (短縮名) | EEE | Sun … Sat |
| 曜日 (完全名) | EEEE | Sunday … Saturday |
| 月 | M | 1 ... 12 |
| 月 | MM | 01 … 12 |
| 月 (短縮名) | MMM | Jan … Dec |
| 月 (完全名) | MMMM | January … December |
| 年 (2 桁) | yy | 17 |
| 年 (4 桁) | yyyy | 2017 |
| 年。非推奨。同一の yyyy を使用。 | y | 2017 |
| 年。非推奨。同一の yyyy を使用。 | Y | 2017 |
| 年。非推奨。同一の yy を使用。 | YY | 17 |
| 年。非推奨。同一の yyyy を使用。 | YYYY | 2017 |
| 時 (1 ～ 12) | h | 1 … 12 |
| 時 (0 ～ 23) | H | 0 … 23 |
| 時 (00 ～ 23) | HH | 00 … 23 |
| 時 (1 ～ 24) | k | 1 … 24 |
| 時 (01 ～ 24) | kk | 01 … 24 |
| 分 | m | 0 … 59 |
| 分 | mm | 00 … 59 |
| 秒 | s | 0 … 59 |
| 秒 | ss | 00 … 59 |
| ミリ秒 | SSS | 000 … 999 |
| AM または PM | a | AM または PM |
| AM または PM。非推奨。同一の a を使用。 | A | AM または PM |
| UTC からのゾーンオフセット | Z | -12:00 … +14:00 |
| 四半期 | Q | 1 … 4 |
| 年の通算週 | w | 1 … 53 |
| 年の通算週 | ww | 01 … 53 |
デフォルトの出力値が異なる類似したメソッドもあります。
- formatDateTime() — デフォルトの formatString は、日付の代わりに日時を出力します。
- formatDateTimeUTC() — 日時を UTC 標準時で書式設定します。
- formatDateUTC() — 日付を UTC 標準時で書式設定します。
AuraLocalizationService のすべてのメソッドについての詳細は「コンポーネントライブラリ」の JavaScript API を参照してください。
例
$A.localizationService を使用して、AuraLocalizationService のメソッドを使用します。
1var now = new Date();
2var dateString = "2017-01-15";
3
4// Returns date in the format "Jun 8, 2017"
5console.log($A.localizationService.formatDate(now));
6
7// Returns date in the format "Jan 15, 2017"
8console.log($A.localizationService.formatDate(dateString));
9
10// Returns date in the format "2017 01 15"
11console.log($A.localizationService.formatDate(dateString, "yyyy MM dd"));
12
13// Returns date in the format "June 08 2017, 01:45:49 PM"
14console.log($A.localizationService.formatDate(now, "MMMM dd yyyy, hh:mm:ss a"));
15
16// Returns date in the format "Jun 08 2017, 01:48:26 PM"
17console.log($A.localizationService.formatDate(now, "MMM dd yyyy, hh:mm:ss a"));