Встроенный класс 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
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 третьего вида.