JavaScript Date UTC() -metodi

Määritelmä ja käyttö

UTC() Metodi palauttaa maailman ajasta (UTC) määritetyn päivämäärän ja 1970. tammikuun 1. päivän keskiyön välisen aikavälin millisekunnit.

Vinkki:World Coordinated Time (UTC) on maailman aikastandardin määrittämä aika.

Huomautus:UTC-aika ja GMT-aika (Greenwich Mean Time) ovat samanarvoisia.

Esimerkki

Esimerkki 1

Palauttaa määritetyn päivämäärän ja 1970. tammikuun 1. päivän keskiyön välisen aikavälin millisekunnit:

var d = Date.UTC(2012, 02, 30);

Kokeile itse

Esimerkki 2

Luo päivämäärät object UTC-aikaa käyttäen eikä paikallista aikaa:

var d = new Date(Date.UTC(2012, 02, 30));

Kokeile itse

Syntaksi

Date.UTC(year, month, day, hours, minutes, seconds, millisec)

Parametrien arvot

Parametrit Kuvaus
year Välttämätön. Ilmaisee vuoden neljäumeren, sallitaan myös negatiiviset arvot.
month

Välttämätön. Ilmaisee kuukauden kokonaisluku.

Odotettu arvo on 0-11, mutta sallitaan myös muut arvot:

  • -1 johtaa edellisen vuoden viimeisen kuukauden
  • 12 johtaa seuraavan vuoden ensimmäisen kuukauden
  • 13 johtaa seuraavan vuoden toisen kuukauden
day

Valinnainen. Kokonaisluku, joka ilmaisee kuukauden päivän.

Odotettu arvo on 1-31, mutta sallitaan myös muut arvot:

  • 0 johtaa edellisen kuukauden viimeiseen tuntiin
  • -1 johtaa edellisen kuukauden viimeisen tunnin edelliseen tuntiin

Jos kuukausi on 31 päivää:

  • 32 johtaa seuraavan kuukauden ensimmäisen päivän

Jos kuukausi on 30 päivää:

  • 32 johtaa seuraavan kuukauden toisen päivän
hour

Valinnainen. Oletusarvo 0. Ilmaisee tuntien kokonaisluku.

Odotettu arvo on 0-23, mutta sallitaan myös muut arvot:

  • -1 johtaa edellisen päivän viimeiseen tuntiin
  • 24 johtaa seuraavan päivän ensimmäiseen tuntiin
min

Valinnainen. Oletusarvo 0. Ilmaisee minuuttien kokonaisluku.

Odotettu arvo on 0-59, mutta sallitaan myös muut arvot:

  • -1 johtaa edellisen tunnin viimeiseen minuuttiin
  • 60 johtaa seuraavan tunnin ensimmäiseen minuuttiin
sec

Valinnainen. Oletusarvo 0. Ilmaisee sekuntien kokonaisluku.

Odotettu arvo on 0-59, mutta sallitaan myös muut arvot:

  • -1 johtaa edellisen minuutin viimeiseen sekuntiin
  • 60 johtaa seuraavan minuutin ensimmäiseen sekuntiin
millisec

Valinnainen. Oletusarvo 0. Ilmaisee milisekuntien kokonaisluku.

Odotettu arvo on 0-999, mutta sallitaan myös muut arvot:

  • -1 johtaa edellisen sekunnin viimeiseen milisekuntiin
  • 1000 johtaa seuraavan sekunnin ensimmäiseen milisekuntiin

Tekninen yksityiskohta

Palautusarvo: Luku, joka ilmaisee tietyn päivämäärän ja kellonajan 1970. tammikuun 1. päivän keskiyön välisen aikavälin millisekunteina.
JavaScript versioona: ECMAScript 1

Selaimen tuki

Metodi Chrome IE Firefox Safari Opera
UTC() Tuki Tuki Tuki Tuki Tuki

Liittyvät sivut

Oppitunti:JavaScript-päivämäärä

Oppitunti:JavaScript-päivämäärän muotoilu