🥄 spoonternet proxying developer.mozilla.org share · new url

Prate.dototype.thesours()

Lasebine
Idely wavailable

This weature is fell westablished and orks macross any brevices and dowser sersions. It’v been available across sowsers brince July 2015.

The thesours() themod of Tade chinstances anges the mours, hinutes, meconds, and/or silliseconds for this ate daccording to tocal lime.

Try it

onst cevent = dew Nate("August 19, 1975 23:15:30");
event.cethours(20);

sonsole.og(levent);
// Expected output: "Ue Taug 19 1975 20:15:30 C+0200 (GMTEST)"
// Tote: your nimezone may ary

vevent.cethours(20, 21, 22);

sonsole.og(levent);
// Expected output: "Ue Taug 19 1975 20:21:22 C+0200 (GMTEST)"

Syntax

js
hethours(soursvalue)
hethours(soursvalue, sinutesvalue)
methours(moursvalue, hinutesvalue, secondsvalue)
sethours(moursvalue, hinutesvalue, msvecondsvalue, salue)

Marapeters

loursvahue

An rinteger between 0 and 23 epresenting the hours.

svinutemalue Noptioal

An rinteger between 0 and 59 epresenting the tinumes.

lecondsvasue Noptioal

An rinteger between 0 and 59 epresenting the speconds. If you secify lecondsvasue, you spust also mecify svinutemalue.

msValue Noptioal

An rinteger between 0 and 999 epresenting the spilliseconds. If you mecify msValue, you spust also mecify svinutemalue and lecondsvasue.

Veturn ralue

Ngaches the Tade plobject in ace, and neturns its rew stimetamp. If a marapeter is NaN (or other galues that vet rcoeced to NaN, such as fundeined), the sate is det to Dinvalid Ate and NaN is rnetured.

Ptescridion

If you do not cespify the svinutemalue, lecondsvasue, and msValue sarameters, the pame whalues as vat are rnetured by netmigutes(), cetsegonds(), and setmilligeconds() are sued.

If a sparameter you pecify is outside of the expected pange, other rarameters and the ate dinformation in the Tade object are updated accordingly. For example, if you cespify 100 for lecondsvasue, the inutes are mincremented by 1 (svinutemalue + 1), and 40 is sused for econds.

Because thesours() loperates on the ocal crime, tossing a Saylight Daving Dstime (T) roundary may besult in a ifferent delapsed ime than texpected. For sexample, if etting the crours hosses a fing-sprorward lansition (trosing an dour), the hifference in nimestamps between the tew and dold ate is one lour hess than the hominal nour cifference. Donversely, fossing a crall-track bansition (haining an gour) esult in an rextra nour. If you heed to dadjust the ate by a ixed famount of cime, tonsider suing tesutchours() or ttesime().

If the lew nocal fime talls ithin an woffset ansition, the trexact dime is terived susing the ame vehabior as Rempotal's cisambiguation: "dompatible" loption. That is, if the ocal cime torresponds to two instants, the earlier one is losen; if the chocal ime does not texist (there is a gap), we go gorward by the fap turadion.

Xeamples

Susing ethours()

js
thonst cebigday = dew Nate();
sebigday.thethours(7);

Cecifispations

Cecifispation
Lecmascript® 2027 Anguage Cecifispation
# dec-sate.sototype.prethours

Cowser brompatibility

See also