setutcdate-method-date-javascript.md

title	ms.custom	ms.date	ms.prod	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
setUTCDate Method (Date) (JavaScript) | Microsoft Docs		01/18/2017	windows-client-threshold			devlang-javascript		language-reference	setUTCDate	JavaScript TypeScript DHTML	dates, UTC dates, setting UTC dates, setting setUTCDate method	e6c3b876-70fe-4103-b197-6c84c078ce10	14	mikejo5000	mikejo	ghogen

setUTCDate Method (Date) (JavaScript)

Sets the numeric day of the month in the Date object using Universal Coordinated Time (UTC).

Syntax

  
dateObj.setUTCDate(numDate)   

Parameters

dateObj
Required. Any Date object.

numDate
Required. A numeric value equal to the day of the month.

Remarks

To set the day of the month using local time, use the setDate method.

If the value of numDate is greater than the number of days in the month stored in the Date object or is a negative number, the date is set to a date equal to numDate minus the number of days in the stored month. For example, if the stored date is January 5, 1996, and setUTCDate(32) is called, the date changes to February 1, 1996. Negative numbers have a similar behavior.

The setUTCFullYear method can be used to set the year, month, and day of the month.

Example

The following example illustrates the use of the setUTCDate method.

function SetUTCDateDemo(newdayofmonth){  
   var d = new Date();           // Create Date object.  
   d.setUTCDate(newdayofmonth);  // Set UTC day of month.  
   var s = "Current setting is ";  
   s += d.toUTCString();   
   return(s);                    // Return new setting.  
}  

Requirements

[!INCLUDEjsv3]

Applies To: Date Object

See Also

getDate Method (Date)
getUTCDate Method (Date)
setDate Method (Date)