Windows Script Host для Windows 2000/XP

Объект 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 будут записаны текущие дата и время.

Объект Enumerator

С помощью объекта Enumerator можно получить доступ к любому элементу коллекции (в VBScript для этого служит цикл For…Each). Коллекцией в языке JScript называется множество элементов, которое отличается от массива тем, что к элементам коллекции нельзя получить прямой доступ с помощью индексов — можно только перемешать указатель текущего элемента на самый первый или следующий относительно текущего элемент.

Для создания нового объекта встроенного класса Enumerator используется конструктор следующего вида:

var е;
е = new Enumerator(collection);

Здесь параметр collection указывает на коллекцию, для доступа к элементам которой и создается объект класса Enumerator. Сами коллекции обычно являются свойствами других объектов.

Методы объекта Enumerator представлены в табл. П1.16 (свойств у этого объекта нет).

Таблица П1.16. Методы объекта Enumerator

Метод	Описание
atEnd	Возвращает true, если указатель текущего элемента находится на элементе, следующем за последним экземпляром коллекции, либо коллекция пуста, либо текущий элемент не определен. В противном случае возвращается false
item	Возвращает значение текущего элемента коллекции. Если коллекция пуста или текущий элемент не определен, возвращается неопределенное значение undefined
moveFirst	Перемещает указатель на первый элемент коллекции. Если в коллекции нет элементов, текущий элемент принимает неопределенное значение undefined
moveNext	Перемещает указатель на следующий элемент коллекции. Если перед применением этого метода указатель находился на последнем элементе коллекции, либо коллекция пуста, текущий элемент принимает неопределенное значение undefined

Пример, поясняющий схему применения объекта Enumerator, приведен в листинге П1.6.

Листинг П1.6. Пример использования Enumerator

//Объявляем переменные
var FSO, Folder, Files, s;
//Создаем объект FileSystemObject
FSOWScript.CreateObject("Scripting.FileSystemObject");
//Создаем объект Folder для корневого каталога диска С:
Folder=FSO.GetFolder("С:\\")?
//Создаем коллекцию файлов каталога "Мои документы"
Files=new Enumerator(Folder.Files);
//Цикл по всем файлам
for (; !Files.atEnd; Files.moveNext)
 //Добавляем строку с именем файла
 s+=Files.item.Name+"\n";
//Выводим полученные строки на экран
WScript.Echo(s);

Объект Math

Встроенный класс Math применяется для математических вычислений и содержит основные математические константы и функции.

Замечание

Объект Math создается сервером сценариев автоматически и не может быть создан при помощи оператора new, как другие встроенные объекты. Все методы и свойства этого объекта доступны из сценария без какого-либо предварительного объявления.

Свойства объекта Math (все они являются математическими константами) описаны в табл. П1.17.