This documentation is archived and is not being maintained.

getHours Method

Returns the hours value in a Date object using local time.

function getHours() : Number

Remarks

To get the hours value using Coordinated Universal Time (UTC), use the getUTCHours method.

The getHours method returns an integer between 0 and 23, indicating the number of hours since midnight. A zero occurs in two situations: the time is before 1:00:00 am, or the time was not stored in the Date object when the object was created. The only way to determine which situation you have is to also check the minutes and seconds for zero values. If they are all zeroes, it is nearly certain that the time was not stored in the Date object.

The following example illustrates the use of the getHours method.

function TimeDemo(){
   var d, s = "The current local time is: ";
   var c = ":";
   d = new Date();
   s += d.getHours() + c;
   s += d.getMinutes() + c;
   s += d.getSeconds() + c;
   s += d.getMilliseconds();
   return(s);
}

Requirements

Version 1

See Also

getUTCHours Method | setHours Method | setUTCHours Method

Applies To: Date Object

Show: