JavaScript | date.setUTCDate() function

The date.setUTCDate() is an inbuilt function in JavaScript which is used to set date of a month according to universal time into a date object which are created using the Date() constructor.

Syntax:

DateObj.setUTCDate(date_Value);

DateObj is a valid Date object created using Date() constructor in which we want to set the date of a month according to universal time.

Parameter: Here parameter date_Value is the value of date which we want to set in the date object created using the Date() constructor.

Return Values: It returns the new i.e updated date of the month which is set by setUTCDate() function.The date of the month is an integer value ranging from 1 to 31.

Below program illustrates the setITCDate() function:

filter_none

edit
close

play_arrow

link
brightness_4
code

<script>
// Here a date has been assigned according to universal
// time while creating Date object
var dateobj = new Date('October 13, 1996 05:35:32 GMT-3:00');
  
// new date 15 of the month is being set in above Date
// Object with the help of setDate() function
dateobj.setUTCDate(15);
  
// new date of the month according to universal time from
// above Date Object is being extracted using getDate()
var B = dateobj.getUTCDate();
  
// Printing new date of the month
document.write(B);
</script>

chevron_right


Output:

15

Errors and Exceptions

  • Example 1: Here as we know that date of the month lies in between 1 to 31 but if we try to set date as 33, it will set the date as 2 for the next month because 33-31=2 and this date 2 becomes date for next of the previous month.
    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    <script>
    // Here a date according to universal time has
    // been assigned while creating Date object
    var dateobj = new Date('October 13, 1996 05:35:32 GMT-3:00');
      
    // new date 33 of the month is being set in above Date
    // Object with the help of setUTCDate() function
    dateobj.setUTCDate(33);
      
    // new date of the month from above Date Object is
    // being extracted using getUTCDate()
    var B = dateobj.getUTCDate();
      
    // new month from above Date Object is
    // being extracted using getUTCMonth()
    var C = dateobj.getUTCMonth();
      
    // Printing new date of the month
    document.write(B + "<br>");
      
    // Printing new month
    document.write(C);
    </script>

    chevron_right

    
    

    Output:

    2
    10

    In above output 2 is date of the November month and 10 is the month of November because month name start from 0 to 11 i.e, 0 for January and 11 for December.

  • Example 2: If in Date() constructor we do not give any date of the month while creating the date object, still setUTCDate() function will be able to set new date which is given as its parameter in the created date object.
    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    <script>
    // Here date according to universal time has
    // not been assigned while creating Date object
    var dateobj = new Date('October, 1996 05:35:32 GMT-3:00');
      
    // new date 12 of the month is being set in above Date
    // Object with the help of setUTCDate() function
    dateobj.setUTCDate(12);
      
    // new date of the month from above Date Object is
    // being extracted using getUTCDate()
    var B = dateobj.getUTCDate();
      
    // Printing new date of the month
    document.write(B);
    </script>

    chevron_right

    
    

    Output:

    12
  • Example 3: If nothing as parameter is given in Date() constructor, still setDate() function will be able to set date but month remains current ones.
    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    <script>
    // Here nothing has been assigned
    // while creating Date object
    var dateobj = new Date();
      
    // new date 13 of the month is being set in above Date
    // Object with the help of setUTCDate() function
    dateobj.setUTCDate(13);
      
    // date of the month from above Date Object is
    // being extracted using getUTCDate()
    var B = dateobj.getUTCDate();
      
    // month from above Date Object is
    // being extracted using getUTCMonth()
    var C = dateobj.getUTCMonth();
      
    // Printing new date of the month
    document.write(B + "<br>");
      
    // Printing new month
    document.write(C);
    </script>

    chevron_right

    
    

    Output:

    13
    3
  • Example 4: If new date of the month is set to zero (0), the new date will be set to the last day of the previous month.
    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    <script>
    // Here a date according to universal time
    // has been assigned while creating Date object
    var dateobj = new Date('October 13, 1996 05:35:32 GMT-3:00');
      
    // new date 0 of the month is being set in above Date
    // Object with the help of setUTCDate() function
    dateobj.setUTCDate(0);
      
    // date of the month from above Date Object is
    // being extracted using getUTCDate()
    var B = dateobj.getUTCDate();
      
    // month from above Date Object is
    // being extracted using getUTCMonth()
    var C = dateobj.getUTCMonth();
      
    // Printing new date of the month
    document.write(B + "<br>");
      
    // Printing new month
    document.write(C);
    </script>

    chevron_right

    
    

    Output:

    30
    8

Supported Browsers: The browsers supported by JavaScript date.setUTCDate() Function are listed below:

  • Google Chrome
  • Internet Explorer
  • Firefox
  • Opera
  • Safari


My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :

Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.