JavaScript Date.UTC() Method

Previous
Quiz

In JavaScript, the Date.UTC() method is a static method of the Date object that allows you to create a date object based on Coordinated Universal Time (UTC) values, rather than local time. This method accepts seven parameters representing the date and time components similar to "Date" constructor and number of milliseconds since January 1, 1970, 00:00:00 UTC, for the specified date and time.

Unlike the Date() constructor, which takes local time parameters, Date.UTC() constructs the date and time based on UTC values.

Syntax

Following is the syntax of JavaScript Date.UTC() method −

Date.UTC(year, month, day, hour, minute, second, millisecond);

Parameters

This method accepts seven parameters. The same are described below −

  • yearValue An integer represents a new year (four digits).
  • month (optional) An integer between 0 and 11, where 0 is January and 11 is December.
    • If -1 is provided, it will result in the last month of the previous year.
    • If 12 is provided, it will result in the first month of the next year.
  • hour (optional) An integer representing the hour (0 to 23).
    • If -1 is provided, it will result in the last hour of the previous day.
    • If 24 is provided, it will result in the first hour of the next day.
  • minute (optional) An integer representing the minutes (0 to 59). If not provided, minutes will be set to 0.
    • If -1 is provided, it will result in the last minute of the previous hour.
    • If 60 is provided, it will result in the first minute of the next hour.
  • second (optional) An integer representing the seconds (0 to 59). If not provided, seconds will be set to 0.
    • If -1 is provided, it will result in the last second of the previous minute.
    • If 60 is provided, it will result in the first second of the next minute.
  • millisecond (optional) An integer representing the milliseconds (0 to 999). If not provided, milliseconds will be set to 0.
    • If -1 is provided, it will result in the last millisecond of the previous second.
    • If 1000 is provided, it will result in the first millisecond of the next second.

Return Value

This method returns the number of milliseconds between the specified date and epoch (i.e. January 1, 1970), according to UTC.

Example 1

In the following example, we are using the JavaScript Date.UTC() method to get the number of milliseconds between the specified date and epoch, according to UTC −

<html>
<body>
<script>
   const utcDate = Date.UTC(2024);
   document.write(utcDate);
</script>
</body>
</html>

Output

The above program returns "1704067200000" as milliseconds difference.

Example 2

Here, we are proving all the parameters to the UTC() method. This program returns the milliseconds difference between the below date and epoch −

<html>
<body>
<script>
   const utcDate = Date.UTC(2023, 1, 15, 12, 30, 0);
   document.write(utcDate);
</script>
</body>
</html>

Output

The above program returns "1676464200000" as milliseconds difference.

Example 3

This example creates a Date object for January 15, 2023, 12:30:00 UTC using Date.UTC() −

<html>
<body>
<script>
   const utcDate = new Date(Date.UTC(2023, 0, 15, 12, 30, 0));
   document.write(utcDate);
</script>
</body>
</html>

Output

The resulting date object will be returned in UTC format.

Print Page
Previous
Next