Metoda Date.UTC() w JavaScript

Definicja i użycie

UTC() Metoda zwraca liczbę milisekund między określoną datą a północą 1 stycznia 1970 roku w czasie uniwersalnym.

Wskazówka:Czas UTC (Universal Time Coordinated) jest czasem ustawionym według standardu czasu świata.

Uwaga:Czas UTC jest taki sam jak czas GMT (Greenwich Mean Time).

Przykład

Przykład 1

Zwraca liczbę milisekund między określoną datą a północą 1 stycznia 1970 roku:

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

Spróbuj sam

Przykład 2

Tworzenie obiektu daty za pomocą czasu UTC zamiast czasu lokalnego:

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

Spróbuj sam

Gramatyka

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

Wartości parametrów

Parametry Opis
year Wymagane. Reprezentuje czterocyfrową liczbę roku, dozwolone są wartości ujemne
month

Wymagane. Reprezentuje liczbę miesiąca jako całkowitą liczbę

Oczekiwana wartość to 0-11, ale dozwolone są inne wartości:

  • -1 spowoduje ostatni miesiąc poprzedniego roku
  • 12 spowoduje pierwszy miesiąc następnego roku
  • 13 spowoduje drugi miesiąc następnego roku
day

Opcjonalne. Liczba, która reprezentuje dzień w miesiącu

Oczekiwana wartość to 1-31, ale dozwolone są inne wartości:

  • 0 spowoduje ostatnią godzinę poprzedniego miesiąca
  • -1 spowoduje godzinę przed ostatnią godziną poprzedniego miesiąca

Jeśli miesiąc ma 31 dni:

  • 32 spowoduje pierwszy dzień następnego miesiąca

Jeśli miesiąc ma 30 dni:

  • 32 spowoduje drugi dzień następnego miesiąca
hour

Opcjonalne. Domyślnie 0. Reprezentuje całkowitą liczbę godzin

Oczekiwana wartość to 0-23, ale dozwolone są inne wartości:

  • -1 spowoduje ostatnią godzinę poprzedniego dnia
  • 24 spowoduje pierwszy godzinę drugiego dnia
min

Opcjonalne. Domyślnie 0. Reprezentuje całkowitą liczbę minut

Oczekiwana wartość to 0-59, ale dozwolone są inne wartości:

  • -1 spowoduje ostatnią minutę poprzedniej godziny
  • 60 spowoduje pierwszą minutę następnego godziny
sec

Opcjonalne. Domyślnie 0. Reprezentuje całkowitą liczbę sekund

Oczekiwana wartość to 0-59, ale dozwolone są inne wartości:

  • -1 spowoduje ostatnią sekundę poprzedniej minuty
  • 60 spowoduje pierwszą sekundę następnego minuty
millisec

Opcjonalne. Domyślnie 0. Reprezentuje całkowitą liczbę milisekund

Oczekiwana wartość to 0-999, ale dozwolone są inne wartości:

  • -1 spowoduje ostatnią milisekundę poprzedniego sekundy
  • 1000 spowoduje pierwszą milisekundę następnego sekundy

Szczegóły techniczne

Zwracana wartość: Liczba, która reprezentuje liczbę milisekund między określoną datą i czasem a północą 1 stycznia 1970 roku.
JavaScript wersja: ECMAScript 1

Obsługa przeglądarek

Metoda Chrome IE Firefox Safari Opera
UTC() Wsparcie Wsparcie Wsparcie Wsparcie Wsparcie

Strony związane

Tutorial:Data JavaScript

Tutorial:Format daty JavaScript