Объект "Date"

Статья
11/05/2008

Обновлен: Ноябрь 2007

Объект, который обеспечивает основные возможности сохранения и извлечения даты и времени. Существует две формы конструктора Date.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Аргументы

dateVal
Необязательный. Если передается числовое значение, dateVal представляет количество миллисекунд в формате UTC между указанной датой и полночью 1 января 1970 г. Если передается строка, то синтаксический анализ аргумента dateVal выполняется в соответствии с правилами метода parse. Аргумент dateVal может также быть значением даты .NET.
year
Обязательный. Полный год, например 1976 (а не 76).
month
Обязательный. Месяц, представляемый в виде числа от 0 до 11 (с января по декабрь).
date
Обязательный. Дата в виде целого числа в диапазоне от 1 до 31.
hours
Необязательный. Должен указываться, если указывается аргумент minutes. Целое число от 0 до 23 (от полуночи до 23:00), представляющее час.
minutes
Необязательный. Должен указываться, если указывается аргумент seconds. Целое число от 0 до 59, представляющее минуты.
seconds
Необязательный. Должен указываться, если указывается аргумент milliseconds. Целое число от 0 до 59, представляющее секунды.
ms
Необязательный. Целое число от 0 до 999, представляющее миллисекунды.

Заметки

Объект Date содержит число, представляющее определенный момент времени с точностью до миллисекунд. Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно. Например, если задать 150 секунд, JScript переопределит это число как две минуты и 30 секунд.

Если значение объекта равно NaN, объект не представляет какой-либо момент времени. Если не передавать параметров конструктору Date, он инициализируется текущим временем в формате UTC. Перед использованием переменной типа Date ее необходимо инициализировать.

Диапазон дат, которые могут быть представлены объектом Date, составляет около 285 616 в каждую сторону от 1 января 1970 г.

Объект Date содержит два статических метода — parse и UTC, которые можно вызвать без создания объекта Date.

Если конструктор Date вызывается без помощи оператора new, то возвращаемый объект Date содержит текущую дату вне зависимости от аргументов, переданных конструктору.

Примечание.
В языке JScript объект Date взаимодействует с типом данных System.DateTime платформы .NET Framework. Однако другие CLS-совместимые языки не могут использовать объект Date, поскольку он предоставляется только в JScript и не наследует от одного из типов .NET Framework. Поэтому при объявлении типов параметров и возвращаемых значений CLS-совместимых методов, обязательно используйте вместо объекта Date тип данных System.DateTime. Тем не менее, объект Date можно использовать для определения типов идентификаторов, которые не являются параметрами или возвращаемыми значениями. Дополнительные сведения см. в разделе Написание CLS-совместимого кода.

В языке JScript объект Date взаимодействует с типом данных System.DateTime платформы .NET Framework. Однако другие CLS-совместимые языки не могут использовать объект Date, поскольку он предоставляется только в JScript и не наследует от одного из типов .NET Framework. Поэтому при объявлении типов параметров и возвращаемых значений CLS-совместимых методов, обязательно используйте вместо объекта Date тип данных System.DateTime. Тем не менее, объект Date можно использовать для определения типов идентификаторов, которые не являются параметрами или возвращаемыми значениями. Дополнительные сведения см. в разделе Написание CLS-совместимого кода.

Пример

В следующем примере используется объект Date.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Если эта программа выполняется 26 января 1992 г., выводится следующий результат: