2.7. Умонтований клас Date

2.7.1. Конструктори класу 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"

Перша з цих рядків задає локальну дату і час, друга - дату і час за Гринвічем, і, нарешті, остання - час і дату за Гринвічем сo зсувом на 3 час. і 30 хв.

Метод parse звичайно застосовують разом із конструктором об'єкта Date або з методом setTime, що ми роздивимося нижче.

setDate

Метод setDate використовується для установки календарної дати в об'єкті клacca 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 третього виду.