JavaScript/Objekte/Date/toLocaleString

Die Methode toLocaleString() wandelt die in Objektname gespeicherten Daten in eine Zeichenkette um. Die zurückgegebene Zeichenkette berücksichtigt die lokale Uhrzeit.

Syntax

Date.toLocaleString([locales[, options]])

Als erster optionaler Parameter kann ein Gebietsschema (Locale) angegeben werden, bspw. für Deutschland 'de-DE' . Damit werden regional übliche Formatierungen verwendet, in diesem Beispiel: "21.11.2016, 09:59:00".

Für weitere Formatierungsmöglichkeiten kann als zweiter Parameter ein options-Objekt angeben werden.

Näheres dazu im Mozilla Developer Network unter Date.prototype.toLocaleString().

Anwendungsbeispiele

Beispiel ansehen …

    var datum = new Date();
    document.getElementById('zeit').innerHTML = datum;
    document.getElementById('utc').innerHTML = datum.toUTCString();
    document.getElementById('iso').innerHTML = datum.toISOString();
    document.getElementById('loc').innerHTML = datum.toLocaleString('de-DE');

Datums- und Zeitangaben können mit verschiedenen Methoden formatiert werden. Die Methode

• datum.toUTCString() wandelt die Zeit in UTC (Universal Coordinated Time) um. Dies entspricht der ehemaligen Standardzeit GMT, ohne jedoch auf Sommer- oder Winterzeit einzugehen.
• datum.toISOString() formatiert die Datumsangabe in eine Zeichenkette nach ISO 8601 um.
• datum.toLocaleString() wird durch den übergebenen Parameter 'de-DE' in eine deutschen Gewohnheiten entsprechende Formatierung umgewandelt.

toLocaleDateString und toLocaleTimeString

Des Weiteren gibt es neben der Methode toLocaleString() die Methoden toLocaleDateString() und toLocaleTimeString(), die mit ihren jeweils anderen Voreinstellungen nur das Datum bzw. die Uhrzeit ausgeben.

Beispiel ansehen …

    var datum = new Date();
    document.getElementById('loc').innerHTML = datum.toLocaleString('de-DE');
    document.getElementById('zeit').innerHTML = datum.toLocaleTimeString('de-DE')
    document.getElementById('datum').innerHTML = datum.toLocaleDateString('de-DE');

Beachten Sie, dass die Rückgabestrings von den Browsern unterschiedlich codiert werden. So liefert Opera 49 bei (new Date("january 1, 2000 08:00")).toLocaleTimeString().length; den Wert 8, während Edge 40 und IE 11 den Wert 13 zurückgeben. Dabei ist die Bildschirmdarstellung "08:00:00" bei allen gleich. (November 2017)

Weblinks

• ECMAScript: date.prototype.tolocalestring
• MDN: Global_Objects/Date/toLocaleString