Книга: Windows Script Host для Windows 2000/XP
Объект Date
Объект Date
Для создания нового объекта встроенного класса Date
используется один из трех конструкторов.
Конструктор первого вида позволяет создать объект, в котором хранится информация о текущих дате и времени:
var d;
d = new Date();
Здесь время задается по Гринвичу, т.е. с использованием времени (UCT — Universal Coordinated Time).
Конструктор второго вида имеет единственный параметр:
var d;
d = new Date(nMilliseconds);
Параметр nMilliseconds
задает дату в миллисекундах, считая от 1 января 1970 года.
Конструктор третьего вида предназначен для раздельного задания компонентов даты и имеет следующий вид:
var d;
d = new Date(year, month, date [, hours [, min [, sec [, ms]]]]);
Значения параметров последнего конструктора приведены в табл. П1.14.
Таблица П1.14. Параметры конструктора Date
Параметр | Описание |
---|---|
year |
Год в четырехзначном формате, например 1998 (но не 98) |
month |
Номер месяца от 0 (январь) до 11 (декабрь) |
date |
Календарная дата в диапазоне от 1 до 31 |
hours |
Час дня в диапазоне от 0 до 23 |
min |
Минуты в диапазоне от 0 до 59 |
sec |
Секунды в диапазоне от 0 до 59 |
ms |
Миллисекунды в диапазоне от 0 до 999 |
Наиболее часто используемые методы объекта Date
описаны в табл. П1.15.
Таблица П1.15. Некоторые методы объекта Date
Метод | Описание |
---|---|
getDate() |
Возвращает календарную дату в диапазоне от 1 до 31 |
getDay() |
Возвращает номер дня недели (0 для воскресенья, 1 — для понедельника и т.д.) |
getFullYear() |
Возвращает четырехзначный номер года |
getHours() |
Возвращает число часов (отсчет идет с полуночи) |
getMilliseconds() |
Возвращает число миллисекунд |
getMinutes() |
Возвращает число минут (отсчет идет с начала часа) |
getMonth() |
Возвращает число месяцев (отсчет идет с января) |
getSeconds() |
Возвращает число секунд (отсчет идет с начала минуты) |
getTime() |
Определение времени для объекта Date. Возвращает количество миллисекунд, прошедших с 1 января 1970 года |
getTimezoneOffset() |
Возвращает смещение локального времени относительно времени по Гринвичу (в миллисекундах) |
parse(dateVal) |
Возвращает число миллисекунд, прошедших с полуночи 1 января 1970 года по время, заданное параметром dateVal . Для вызова метода parse необязательно создавать объект класса Date , достаточно просто сослаться на имя этого класса: n = Date.parse("10 May 2001 13:00:00"); Параметр dateVal может задаваться в нескольких форматах (подробнее см документацию по языку JScript) |
setDate(date) |
Устанавливает календарную дату. Параметр date может принимать любые положительные или отрицательные значения. Если значение date больше, чем количество дней в месяце, который хранится в объекте Date , или date является отрицательным числом, то календарная дата устанавливается в число, равное разности параметра date и числа дней в этом месяце |
setFullYear(year) |
Устанавливает номер года, заданный параметром year |
setHours(hours) |
Устанавливает количество часов, заданное параметром hours . Параметр hours может принимать любые положительные или отрицательные значения (при необходимости происходит соответствующее изменение даты, записанной в объекте класса Date ) |
setMilliseconds(ms) |
Устанавливает количество миллисекунд, заданное параметром ms . Параметр ms может принимать любые положительные или отрицательные значения (при необходимости происходит соответствующее изменение даты, записанной в объекте класса Date ) |
setMinutes(min) |
Устанавливает количество минут, заданное параметром min . Параметр min может принимать любые положительные или отрицательные значения (при необходимости происходит соответствующее изменение даты, записанной в объекте класса Date ) |
setMonth(mon) |
Устанавливает номер месяца, прошедшего с начала года. Параметр mon может принимать любые положительные или отрицательные значения (при необходимости происходит соответствующее изменение даты, записанной в объекте класса Date ) |
setSeconds(sec) |
Устанавливает количество секунд, заданное параметром sec . Параметр sec может принимать любые положительные или отрицательные значения (при необходимости происходит соответствующее изменение даты, записанной в объекте класса Date ) |
setTime(ms) |
Устанавливает дату, соответствующую количеству миллисекунд (параметр ms ), прошедших с 1 января 1970 года |
toGMTString() |
Преобразует дату в строку и возвращает результат в стандартном формате времени по Гринвичу (Greenwich Mean Time, GMT) |
ToLocaleString() |
Преобразует дату в строку и возвращает результат в формате локального времени |
ToUTCString() |
Преобразует дату в строку и возвращает результат в формате UTC |
UTC(year, month, date[, hours[, min[, see [,ms]]]]) |
Преобразует дату, заданную параметрами метода, в количество миллисекунд, прошедшее с полуночи 1 января 1970 года. При использовании этого метода, как и метода parse , объект класса Date создавать необязательно: n = Date.UTC(year, month, date); |
Пример использования методов объекта Date
приведен в листинге П1.5.
Листинг П1.5. Пример использования методов объекта Date
var d;
var s = "";
d = new Date();
s = "Дата: " + d.getDate() + "." + d.getMonth() + "." + d.getYear(); s += "n";
s += "Время: " + d.getHours() + ":" + d.getMinutes() + ":" + d.getSeconds();
После выполнения этих строк в переменной s будут записаны текущие дата и время.
- Автоматическое обновление (automatic update)
- Пример: СОМ-объект для архивирования файлов
- Создание макета файла DateArc.wsc с помощью Windows Script Component Wizard (JScript)
- Доработка объекта-сценария DateArc.wsc (JScript)
- Регистрация файла DateArc.wsc в качестве СОМ-объекта
- Реализация объекта DateArc.wsc на VBScript
- Встроенные объекты (классы)
- 7.19. Взаимные преобразования объектов Date, Time и DateTime
- Пошаговые инструкции для перехода на 3-й диалект
- Права