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"

仕様

仕様 状況 コメント
ECMAScript Internationalization API 1.0 (ECMA-402)
Intl.DateTimeFormat.format の定義
標準 Initial definition.

ブラウザ実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから!
機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート 24 29 (29) 11 15 未サポート
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート 未サポート 26 未サポート
バグ 864843
未サポート 未サポート 未サポート

関連情報