Intl.DateTimeFormat.prototype.format

概要

ローケルに応じて、このDateTimeFormatオブジェクトのオプションをもった日付をフォーマットするゲッター関数を返します。

構文

dateTimeFormat.format(date)

引数

date

フォーマットする日付

説明

formatによって返される関数は、ローケルに応じて、このDateTimeFormat オブジェクトのオプションをもつ文字列に日付をフォーマットします。

例

例: formatを使う

単一の日付をフォーマットするためにformatによって返される関数を使って下さい。以下ではSerbia:

var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
var dateTimeFormat = new Intl.DateTimeFormat('sr-RS', options);
console.log(dateTimeFormat.format(new Date()));
// → "недеља, 7. април 2013."

例: mapとともにformat を使う

配列内のすべての日付をフォーマットするためにformatによって返される関数を使って下さい。 関数はDateTimeFormatにバインドされていることに注意して下さい。というのも、直接Array.prototype.map()に渡されるからです。

var a = [new Date(2012, 08), new Date(2012, 11), new Date(2012, 03)];
var options = { year: 'numeric', month: 'long' };
var dateTimeFormat = new Intl.DateTimeFormat('pt-BR', options);
var formatted = a.map(dateTimeFormat.format);
console.log(formatted.join('; '));
// → "setembro de 2012; dezembro de 2012; abril de 2012"

仕様

ブラウザ実装状況

関連情報

• Intl.DateTimeFormat
• Date.prototype.toLocaleString()
• Date.prototype.toLocaleDateString()
• Date.prototype.toLocaleTimeString()