spacer

Webref WebRef   Sitemap · Experts · Tools · Services · Newsletters · About i.com

home / experts / javascript / column25


UTC-Base Set Methods

Developer News
Microsoft Shows Off Silverlight 4, IE9 Plans
Metasploit Expands Vulnerability Test Framework
HyperCard Reborn?

JavaScript 1.3 provides support for the following methods for setting different time components in a given Date object:

MethodsetUTCFullYear()
Parameters<year>(mandatory)
<month>(optional)
<day of the month>(optional)
DescriptionSets the year of the specified date according to Universal Coordinated Time. If you don't specify the <month> and <day of the month>, the values returned from getUTCMonth() and getUTCDate() are used. Notice you cannot specify the <day of the month> without specifying the <month>. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 15 for the <month>, the <year> will be incremented by one, and the <month> will be set to 3.
ExamplemyBirthDate = new Date();
myBirthDate.setUTCFullYear(1998);
JavaScript 1.2setYear()

MethodsetUTCMonth()
Parameters<month>(mandatory)
<day of the month>(optional)
DescriptionSets the month of the specified date according to Universal Coordinated Time. If you don't specify the <day of the month>, the value returned from getUTCDate() is used. The expected range of <month> is between 0 and 11. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 15 for the <month>, the <year> will be incremented by one, and the <month> will be set to 3.
ExamplemyBirthDate = new Date();
myBirthMonth.setUTCMonth(2);
JavaScript 1.2setMonth()

MethodsetUTCDate()
Parameters<day of the month>
DescriptionSets the day of the month of the specified date according to Universal Coordinated Time. The expected range of <day of the month> is between 1 and 31. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 45 for the <day of the month> of June, the month of the Date object will be incremented by one to July, and the <day of the month> will be set to 15.
ExamplemyBirthDate = new Date();
myBirthDayM.setUTCDate(27);
JavaScript 1.2setDate()

MethodsetUTCHours()
Parameters<hours>(mandatory)
<minutes>(optional)
<seconds>(optional)
<milliseconds>(optional)
DescriptionSets the hours of the specified date according to Universal Coordinated Time. If you don't specify the <minutes>, <seconds>, and <milliseconds>, the values returned from getUTCMinutes(), getUTCSeconds() and getUTCMilliseconds() are used. Notice you cannot specify the <milliseconds> parameter without specifying the <minutes> and <seconds> parameters. Similarly, you cannot specify the <seconds> parameter without specifying the <minutes> one. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 1500 for the <milliseconds> parameter, the <seconds> will be incremented by one, and the <milliseconds> will be set to 500.
ExamplemyBirthDate = new Date();
myBirthDate.setUTCHours(3, 32, 30, 509);
JavaScript 1.2setHours()

MethodsetUTCMinutes()
Parameters<minutes>(mandatory)
<seconds>(optional)
<milliseconds>(optional)
DescriptionSets the minutes of the specified date according to Universal Coordinated Time. If you don't specify the <seconds> and <milliseconds>, the values returned from getUTCSeconds() and getUTCMilliseconds() are used. Notice you cannot specify the <milliseconds> without specifying the <seconds>. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 150 for the <seconds>, the <minutes> will be incremented by two, and the <seconds> will be set to 30.
ExamplemyBirthDate = new Date();
myBirthDate.setUTCMinutes(35, 18, 850);
JavaScript 1.2setMinutes()

MethodsetUTCSeconds()
Parameters<seconds>(mandatory)
<milliseconds>(optional)
DescriptionSets the seconds of the specified date according to Universal Coordinated Time. If you don't specify the <milliseconds>, the value returned from getUTCMilliseconds() is used. The expected range of <seconds> is between 0 and 59. If you specify a parameter outside its expected range, other parameters will be updated accordingly. If, for example, you specify 151 for the <seconds>, the minutes of the Date object will be incremented by two, and the <seconds> will be set to 31.
ExamplemyBirthDate = new Date();
myBirthDate.setUTCSeconds(43, 756);
JavaScript 1.2setSeconds()

MethodsetUTCMilliseconds()
Parameters<milliseconds>
DescriptionSets the milliseconds in the specified date according to Universal Coordinated Time. The parameter value should be between 0 and 999. If you specify a number outside this range, other date variables in the Date object will be incremented to accommodate your number. If you specify 1012, for example, the number of milliseconds in the Date object will be 12 and the number of seconds will be incremented by 1.
ExamplemyBirthDate = new Date();
myBirthDate.setUTCMilliseconds(103);
JavaScript 1.2None

http://www.internet.com

internet.commediabistro.comJusttechjobs.comGraphics.com

Search:

WebMediaBrands Corporate Info

Legal Notices, Licensing, Permissions, Privacy Policy.
Advertise | Newsletters | Shopping | E-mail Offers | Freelance Jobs

webref The latest from WebReference.com Browse >
Rolling Out Your Own HTML Application Version Control · HTML 5: Client-side Storage · Working with Ajax Server Extensions
Sitemap · Experts · Tools · Services · Email a Colleague · Contact FREE Newsletters 
 The latest from internet.com
Wi-Fi Product Watch, November 2009 · Chip Market Recovering From '08 Collapse · Low-Cost Tools to Kickstart Your New Business


Created: September 14, 1998
Revised: September 14, 1998

URL: http://www.webreference.com/js/column25/dateset.html