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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
formatChrome Vollständige Unterstützung 24Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 29IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 15Safari Vollständige Unterstützung 10WebView Android Vollständige Unterstützung 4.4Chrome Android Vollständige Unterstützung 25Firefox Android Vollständige Unterstützung 56Opera Android Vollständige Unterstützung 14Safari iOS Vollständige Unterstützung 10Samsung Internet Android Vollständige Unterstützung 1.5nodejs Vollständige Unterstützung 0.12
Hinweise
Vollständige Unterstützung 0.12
Hinweise
Hinweise Before version 13.0.0, only the locale data for en-US is available by default. See the DateTimeFormat() constructor for more details.

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.

Siehe auch