Date.prototype.toLocaleTimeString()

Syntax

dateObj.toLocaleTimeString([locales[, options]])

Parameter

Überprüfe das Kapitel Browserkompatibilität, um zu erfahren, welcher Browser die Argumente locales and options unterstützt. Zudem sollte das Beispiel Unterstützung der Argumente locales und options beachtet werden.

Rückgabewert

Einen String, der den Zeitteil des gegebenen Date Objektes mit sprachspezifischen Konventionen repräsentiert.

Beispiele

Einsatz von toLocaleTimeString()

Standardeinsatz ohne Angaben zur Sprache und Formatierung. Ein formatierter String in der Standardsprache mit Standardoption wird zurückgegeben.

var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0));

// toLocaleTimeString() ohne Argumente abhängig von der Implementierung, 
// der Standardsprache und der Standardzeitzone. 
console.log(date.toLocaleTimeString());
// → "7:00:00 PM"  wenn in der Sprache en-US mit America/Los_Angeles Zeitzone ausgeführt 

Unterstützung der Argumente locales und options

Die Argumente locales and options sind noch nicht in allen Browsern unterstützt. Um herauszufinden, ob eine Implementierung die Argumente unterstützt, kann die Anforderung benutzt werden, dass bei nicht existierenden Sprachen ein RangeError erzeugt wird:

function toLocaleTimeStringSupportsLocales() {
  try {
    new Date().toLocaleTimeString('i');
  } catch (e) {
    return e​.name === 'RangeError';
  }
  return false;
}

Einsatz von locales

Das Beispiel zeigt einige Variation von internationalisierten Zeitformaten. Um das Format der Sprache der Benutzerschnittstelle (z. B. Webseite) zu bekommen, muss die Sprache (und manchmal eine fallback Sprache) mit dem Argument locales gesetzt werden:

var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));

// US Englische Sprache; 12-Stunden Zeit mit AM/PM
console.log(date.toLocaleTimeString('en-US'));
// → "7:00:00 PM"

// British Englishe Sprache; 24-Stunden Zeit ohne AM/PM
console.log(date.toLocaleTimeString('en-GB'));
// → "03:00:00"

// Koreanische Sprache; 12-Stunden Zeit mit AM/PM
console.log(date.toLocaleTimeString('ko-KR'));
// → "오후 12:00:00"

// In den meisten arabischen Ländern werden arabische Ziffern genutzt.
console.log(date.toLocaleTimeString('ar-EG'));
// → "٧:٠٠:٠٠ م"

// Wenn eine Sprache angegeben wird, die vielleicht nicht unterstützt wird, 
// wie Balinesisch, wird eine fallback Sprache (Indonesisch) definiert. 
console.log(date.toLocaleTimeString(['ban', 'id']));
// → "11.00.00"

Einsatz von options

Das Ergebnis der toLocaleTimeString() Methode kann benutzerdefiniert mit dem Argument options beeinflusst werden.

var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));

// Macht UTC sichtbar  
var options = { timeZone: 'UTC', timeZoneName: 'short' };
console.log(date.toLocaleTimeString('en-US', options));
// → "3:00:00 AM GMT"

// Manchal brauchen US-Sprachen auch 24-Stunden Zeiten
console.log(date.toLocaleTimeString('en-US', { hour12: false }));
// → "19:00:00"

Performance

Wenn viele Zeiten formatiert werden sollen, ist es besser ein Intl.DateTimeFormat Objekt zu erstellen und die Funktion format zu benutzen.

Spezifikationen

Browserkompatibilität

Siehe auch

• Intl.DateTimeFormat
• Date.prototype.toLocaleDateString()
• Date.prototype.toLocaleString()
• Date.prototype.toTimeString()
• Date.prototype.toString()