Система уроков по JavaScript

Встроенный класс Date

С помощью методов встроенного класса Date сценарий JavaScript может выполнять различные действия с часами компьютера, например, получать и устанавливать текущую дату и время.

Ниже приведено краткое описание конструкторов и методов этого класса.

Конструкторы класса Date

Для использования большинства методов класса Date необходимо создать объект этого класса при помощи одного из трех конструкторов. Конструктор первого вида вызывается следующим образом:

var dtNewDate;
dtNewDate = new Date();

Здесь создается объект Date, в котором хранится информация о текущей дате и времени. Это время задается по Гринвичу или, пользуясь более современным определением, с использованием времени Universal Coordinated Time.

Конструктор второго вида позволяет указать дату через единственный параметр:

var dtNewDate;
dtNewDate = new Date(nMilliseconds);

Параметр nMilliseconds задает дату в миллисекундах, считая от 1 января 1970 года.

И, наконец, конструктор третьего вида предназначен для раздельной установки компонент даты и во многих случаев более удобен для использования:

var dtNewDate;
dtNewDate=new Date(year, month, date, hours, min, sec, ms);

Параметры этого конструктора описаны ниже:

Параметр	Описание
year	Год, например, 1998 или 2012
month	Номер месяца от 0 (январь) до 11 (декабрь)
date	Календарная дата, задается в диапазоне от 1 до 31
hours	Необязательный параметр, задающий час дня в диапазоне от 0 до 23. Обязательно указывается, если задан параметр min
min	Необязательный параметр, задающий минуты в диапазоне от 0 до 59. Обязательно указывается, если задан параметр sec
sec	Необязательный параметр, задающий секунды в диапазоне от 0 до 59. Обязательно указывается, если задан параметр ms
ms	Необязательный параметр, задающий миллисекунды в диапазоне от 0 до 999

Методы класса Date

getDate

Определение даты, хранящейся в объекте класса Date. Метод возвращает значение календарной даты в диапазоне от 1 до 31. Пример использования:

var dtNewDate;
var nDate;
dtNewDate = new Date();
nDate = dtNewDate.getDate();

getDay

Определение номера дня недели, хранящегося в объекте класса Date. Метод возвращает 0 для воскресения, 1 - для понедельника, и так далее. Пример использования:

nDay = dtDate.getDay();

getHours

Определение количества часов, прошедших после полуночи. Пример использования:

nHours = dtDate.getHours();

getMinutes

Определение количества минут, прошедших после начала часа. Пример использования:

nMinutes = dtDate.getMinutes();

getMonth

Определение количества месяцев, прошедших с января. Пример использования:

nMonth = dtDate.getMonth();

getSeconds

Определение количества секунд, прошедших с начала минуты. Пример использования:

nSeconds = dtDate.getSeconds();

getTime

Определение времени для заданного объекта класса Date. Метод getTime возвращает количество миллисекунд, прошедших с 1 января 1970 года. Пример использования:

nMilliseconds = dtDate.getTime();

getTimeZoneOffset

Определение смещения локального времени относительно времени по Гринвичу (в миллисекундах). Пример использования:

nOffsetMilliseconds = dtDate.getTimeZoneOffset();

getYear

Метод getYear возвращает год, хранящийся в объекте класса Date. Пример использования:

nYear = dtDate.getYear();

parse

Метод parse возвращает количество миллисекунд, прошедших с 00 часов 00 минут 1 января 1970 года по время, указанное в параметре функции. Для вызова этого метода не нужно создавать объект класса Date, а можно просто сослаться на имя этого класса:

nMS = Date.parse(szDataString);

Через параметр szDataString можно указать время, например, так:

"12 Oct 1998 12:00:00"
"12 Oct 1998 12:00:00 GMT"
"12 Oct 1998 12:00:00 GMT+0330"

Первая из этих строк задает локальную дату и время, вторая - дату и время по Гринвичу, и, наконец, последняя, - время и дату по Гринвичу со смещением на 3 часа и 30 минут.

Метод parse обычно применяют вместе с конструктором объекта Date или с методом setTime (рассмотрен ниже).

setDate

Метод setDate используется для установки календарной даты в объекте класса Date. Пример использования:

dtNewDate.setDate(nDateNumber);

Параметр nDateNumber может принимать значения от 1 до 31.

setHours

Метод setHours используется для установки количества часов, прошедших после полуночи, в объекте класса Date. Пример использования:

dtNewDate.setHours(nHours);

Параметр nHours может принимать любые положительные или отрицательные значения. При необходимости происходит соответствующее изменение календарной даты, записанной в объекте класса Date.

setMinutes

Метод setMinutes используется для установки количества минут, прошедших после начала часа, в объекте класса Date. Пример использования:

dtNewDate.setMinutes(nMinutes);

Параметр nMinutes может принимать любые положительные или отрицательные значения. При необходимости происходит соответствующее изменение календарной даты, записанной в объекте класса Date.

setMonth

Метод setMonth используется для установки номера месяца, прошедшего с начала года, в объекте класса Date. Пример использования:

dtNewDate.setMonth(nMonth);

Параметр nMonth может принимать любые положительные или отрицательные значения. При необходимости происходит соответствующее изменение календарной даты, записанной в объекте класса Date.

setSeconds

Метод setSeconds используется для установки количества секунд, прошедших с начала минуты, в объекте класса Date. Пример использования:

dtNewDate.setSeconds(nSeconds);

Параметр nSeconds может принимать любые положительные или отрицательные значения. При необходимости происходит соответствующее изменение календарной даты, записанной в объекте класса Date.

setTime

С помощью метода setTime можно установить дату в объекте класса Date, соответствующую заданному количеству миллисекунд, прошедших после 1 января 1970 года. Пример использования:

dtNewDate.setTime(nMilliseconds);

setYear

Метод setYear используется для установки номера года, в объекте класса Date. Пример использования:

dtNewDate.setYear(nsetYear);

toGMTString

Метод toGMTString предназначен для преобразования даты в строку, записанную в стандартном формате времени по Гринвичу (GMT).

toLocaleString

Аналогично предыдущему, однако вместо времени GMT используется локальное время.

UTC

Метод UTC преобразует дату, заданную параметрами метода, в количество миллисекунд, прошедшее с 1 января 1970 года. При использовании метода UTC, так же как и метода parse, вам не нужно создавать объект класса Date:

nMillisecond = 
  Date.UTC(year, month, date, hours, min, sec, ms);

Параметры метода UTC задаются таким же образом, как и описанные выше параметры конструктора объекта класса Date третьего вида.