この翻訳は不完全です。英語から この記事を翻訳 してください。

概要

ローケルに応じて、この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.

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 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
未サポート 未サポート 未サポート

関連情報

ドキュメントのタグと貢献者

このページの貢献者: shide55
最終更新者: shide55,