JavaScript/Objekte/Date/setHours

Die Methode setHours() ändert die Stunden der Uhrzeit, die in einem Datumsobjekt gespeichert sind. Die Stundenzahl ist als Parameter zu übergeben.

Syntax

dateObj.setHours(stunden[, minuten[, sekunden[, millisekunden]]])

• stunden: ganze Zahl zwischen 0 und 23, die die Stunde repräsentiert.
• minuten: optional, ganze Zahl zwischen 0 und 59
• sekunden: optional, ganze Zahl zwischen 0 und 59 (Wenn der dieser Parameter angegeben wird, muss auch ein Wert für Minuten angegeben werden.)
• millisekunden: optional, ganze Zahl zwischen 0 und 999 (Wenn der dieser Parameter angegeben wird, muss auch ein Wert für Minuten und Sekunden angegeben werden.)

Rückgabewert ist die Anzahl der Millisekunden zwischen dem 1. Januar 1970 00:00:00 UTC und dem geänderten Date-Objekt.

Beachten Sie: Wenn Sie eine zu hohe Zahl übergeben, rollt die Zeit einfach in den nächsten Tag!

Anwendungsbeispiel

Beispiel ansehen …

  function setzeStunde() {
    var Zeit = new Date(),
        aktuell = Zeit.getHours(),
        gesetzt = Zeit.setHours(23);
        gesetzt = Zeit.getHours();
	document.getElementById('aktuell').innerHTML = aktuell;
	document.getElementById('gesetzt').innerHTML = gesetzt;
  }

Das Beispiel erzeugt ein neues Datumobjekt Zeit mit dem aktuellen Zeitpunkt. Zur Kontrolle ermittelt das Beispiel die Stundenzahl aus der Tageszeit und gibt sie aus. Dann wird die Methode setHours() auf den Objektnamen Zeit angewendet. Im Beispiel wird die Stundenzahl der Uhrzeit auf 23 gesetzt. Anschließend wird zur Kontrolle der neue Stundenanteil an der Uhrzeit ermittelt und anschließend ausgegeben.

Siehe auch

• Date.prototype.getHours
• Date.prototype.getUTCHours
• Date.prototype.setUTCHours

Weblinks

• ECMAScript: ECMASript 1st Edition 1997 (pdf) date.prototype.sethours
• MDN: Global_Objects/Date/setHours