Tutorialspoint.dev

JavaScript | date.getUTCDay() Function

The date.getUTCDay() is an inbuilt function in JavaScript which is used to fetch the day of a week according to universal time from a given Date object.

Syntax:

DateObj.getUTCDay();

In the above syntax, DateObj is a valid Date object created using Date() conctructor from which we want to fetch day of a week accoding to universal time.

Parameter: This function does not takes any parameter. It is just used along with a Date Object from which we want to fetch day of the week.

Return Values: It returns the day of the week for the given date object according to universal time. Day of the week will be returned in the form of integer value ranging from 0 to 6 means 0 for Sunday, 1 for Monday and so on till 6 for Saturday.



Below program illustrate the getUTCDay() method:

// Here a date has been assigned according to universal
// time while creating Date object
var dateobj = new Date('October 15, 1996 05:35:32 GMT-11:00');
  
// day of the week from above date object is
// being extracted using getUTCDay()
var B = dateobj.getUTCDay();
  
// Printing day of the week 
// according to universal time.
console.log(B);

/div>

Output:

2

Errors and Exceptions:

  • Code #1: The date of the month should must lie in between 1 to 31 because none of the month have date greater than 31. That is why the getUTCDay() function returns NaN when date is greater than 31 i.e, not a number because date for the month does not exist. So, Day of the week will also not exists when date does not exists.
    // Here a date has been assigned according to 
    // universal time while creating Date object
    var dateobj = new Date('October 33, 1996 05:35:32 GMT-11:00');
      
    // day of the week from above date object is
    // being extracted using getUTCDay()
    var B = dateobj.getUTCDay();
      
    // Printing day of the week 
    // according to universal time.
    console.log(B);

    Output:

    NaN
  • Code #2: If date of the month is not given, by default the getUTCDay() function consider it as first date of the month and hence accordingly it returns day of the week according to universal time. It is an exception case.
    // Here a date has been assigned according to universal
    // time while creating Date object
    var dateobj = new Date('October 1996 05:35:32 GMT+11:00');
      
    // day of the week from above date object is
    // being extracted using getUTCDay().
    var B = dateobj.getUTCDay();
      
    // Printing day of the week 
    // according to universal time.
    console.log(B);

    Output:

    1
  • Here it returns 1 means Monday i.e, on first october 1996 there would be Monday.

  • Code #3: If nothing as parameter is given to the Date() constructor, the getUTCDay() function returns current day of the week.
    // Here nothing has been assigned according to universal
    // time while creating Date object
    var dateobj = new Date();
      
    // day of the week from above date object is
    // being extracted using date.getUTCDay().
    var B = dateobj.getUTCDay();
      
    // Printing current day of the week 
    // according to universal time.
    console.log(B);

    Output:

    4

Application: It has many applications such as getting current day of the week according to universal time. Below program shows one of the application of this function. It gives the current Day of the week according to universal time.

// Here nothing has been assigned according to universal
// time while creating Date object
var dateobj = new Date();
  
// day of the week from above date object is
// being extracted using date.getUTCDay().
var B = dateobj.getUTCDay();
  
// Printing current day of the week 
// according to universal time.
console.log(B);

Output:

4


This article is attributed to GeeksforGeeks.org

You Might Also Like

leave a comment

code

0 Comments

load comments

Subscribe to Our Newsletter