Intl.DateTimeFormat.prototype.format

Die Intl.DateTimeFormat.prototype.format Eigenschaft gibt einen Getter-Funktion zur├╝ck, die einen Zeitstempel nach den Gebiets- und Formatierungsoptionen des Intl.DateTimeFormat Objekts formatiert.

Syntax

dateTimeFormat.format(date)

Parameter

date
Der Zeitstempel, der formatiert werden soll.

Beschreibung

Die Funktion, die vom format Getter zur├╝ckgegeben wird, formatiert einen Zeitpunkt (date) in einen String. Dabei werden die Gebiets- und Formatierungsoptionen des Intl.DateTimeFormat Objekts ber├╝cksichtigt.

Beispiele

Einsatz von format

Die vom format Getter zur├╝ckgegebene Funktion wird zum Formatieren von Zeitstempeln genutzt, hier f├╝r Serbien:

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."

Einsatz von format mit map

Die vom format Getter zur├╝ckgegebene Funktion kann zum Formatieren von Zeitpunkten in einem Array genutzt werden. Zu ber├╝cksichtigen ist, dass die Funktion an das Intl.DateTimeFormat Objekt gebunden ist, von welche die Funktion stammt, so dass sie direkt an Array.prototype.map() ├╝bergeben werden kann.

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"

Spezifikationen

Spezifikation Status Kommentar
ECMAScript Internationalization API 1.0 (ECMA-402)
Die Definition von 'Intl.DateTimeFormat.format' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Internationalization API 2.0 (ECMA-402)
Die Definition von 'Intl.DateTimeFormat.format' in dieser Spezifikation.
Standard  
ECMAScript Internationalization API (ECMA-402)
Die Definition von 'Intl.DateTimeFormat.format' in dieser Spezifikation.
Lebender Standard  

Browserkompatibilit├Ąt

BCD tables only load in the browser

Siehe auch