JavaScript - Date setUTCHours() Method

Description

Javascript date setUTCHours() method sets the hour for a specified date according to local time.

Syntax

Its syntax is as follows −

Date.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

Note − Parameters in the bracket are always optional.

Parameter Detail

hoursValue − An integer between 0 and 23, representing the hour.
minutesValue − An integer between 0 and 59, representing the minutes.
secondsValue − An integer between 0 and 59, representing the seconds. If you specify the secondsValue parameter, you must also specify the minutesValue.
msValue − A number between 0 and 999, representing the milliseconds. If you specify the msValue parameter, you must also specify the minutesValue and secondsValue.

If you do not specify the minutesValue, secondsValue, and msValue parameters, the values returned from the getUTCMinutes, getUTCSeconds, and getUTCMilliseconds methods are used.

If a parameter you specify is outside the expected range, setUTCHours attempts to update the date information in the Date object accordingly. For example, if you use 100 for secondsValue, the minutes will be incremented by 1 (min + 1), and 40 will be used for seconds.

Example

Try the following example.

Live Demo

<html>  
   <head>
      <title>JavaScript setUTCHours Method</title>
   </head>
   
   <body>      
      <script type = "text/javascript">
         var dt = new Date( "Aug 28, 2008 23:30:00" );
         dt.setUTCHours( 15 );
         document.write( dt ); 
      </script>      
   </body>
</html>

Output

Thu Aug 28 2008 20:30:00 GMT+0530 (India Standard Time)

javascript_date_object.htm