# Date.setUTCHours()

The setUTCHours() method sets the hour for a specified date according to universal time, and returns the number of milliseconds since January 1, 1970 00:00:00 UTC until the time represented by the up

```javascript
var event = new Date('August 19, 1975 23:15:30 GMT-3:00');

console.log(event.toUTCString());
// expected output: Wed, 20 Aug 1975 02:15:30 GMT

console.log(event.getUTCHours());
// expected output: 2

event.setUTCHours(23);

console.log(event.toUTCString());
// expected output: Wed, 20 Aug 1975 23:15:30 GMT

```

## Syntax <a href="#syntax" id="syntax"></a>

```javascript
dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
```

#### Parameters <a href="#parameters" id="parameters"></a>

`hoursValue`An integer between 0 and 23, representing the hour.

`minutesValue`Optional. An integer between 0 and 59, representing the minutes.

`secondsValue`Optional. An integer between 0 and 59, representing the seconds. If you specify the `secondsValue` parameter, you must also specify the `minutesValue`.

`msValue`Optional. A number between 0 and 999, representing the milliseconds. If you specify the `msValue` parameter, you must also specify the `minutesValue` and `secondsValue`.

**Return value**

The number of milliseconds between January 1, 1970 00:00:00 UTC and the updated date.

## Description <a href="#description" id="description"></a>

If you do not specify the `minutesValue`, `secondsValue`, and `msValue` parameters, the values returned from the [`getUTCMinutes()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getUTCMinutes), [`getUTCSeconds()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getUTCSeconds), and [`getUTCMilliseconds()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getUTCMilliseconds) methods are used.

If a parameter you specify is outside of the expected range, `setUTCHours()` attempts to update the date information in the [`Date`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) object accordingly. For example, if you use 100 for `secondsValue`, the minutes will be incremented by 1 (`minutesValue + 1`), and 40 will be used for seconds.

## Examples <a href="#examples" id="examples"></a>

#### Using `setUTCHours()` <a href="#using_setutchours" id="using_setutchours"></a>

```javascript
var theBigDay = new Date();
theBigDay.setUTCHours(8);
```

## References <a href="#references" id="references"></a>

{% embed url="<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/setUTCHours>" %}

## Contributors to this page <a href="#contributors-to-this-page" id="contributors-to-this-page"></a>

Uros Durdevic<br>