[Содержание] [Предыдущая] [Следующая] [Индекс]

Date

Позволяет Вам работать с датой и временем.

Основной объект
Реализовано в Navigator 2.0, LiveWire 1.0
Navigator 3.0: добавлено свойство prototype

Создание

Конструктором Date:

new Date()
new Date("month day, year hours:minutes:seconds")
new Date(yr_num, mo_num, day_num)
new Date(yr_num, mo_num, day_num, hr_num, min_num, sec_num)

Параметры

month, day, year,
hours, minutes,
seconds
Строковые значения, представляющие части даты.
yr_num, mo_num,
day_num, hr_num,
min_num, sec_num
Целочисленные значения, представляющие части даты. Как целочисленное значение, месяц представляется с 0 до 11 (0=январь и 11=декабрь).

Описание

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

Способ JavaScript обрабатывать даты, очень похож на способ Java обработки даты: оба языка имеют много одинаковых методов работы с датой, и оба хранят дату как число миллисекунд начиная с 1 января, 1970 00:00:00. Даты до 1970 не допускаются.

Резюме Свойств

prototype
Позволяет добавление свойств к объекту Date.

Резюме Методов

getDate
Возвращает день месяца для определенной даты.
getDay
Возвращает день недели для определенной даты.
getHours
Возвращает час для определенной даты.
getMinutes
Возвращает минуты для определенной даты.
getMonth
Возвращает месяц для определенной даты.
getSeconds
Возвращает секунды для определенной даты.
getTime
Возвращает числовое значение, соответствующее времени для определенной даты.
getTimezoneOffset
Возвращает смещение часового пояса в минутах для текущего региона.
getYear
Возвращает год для определенной даты.
parse
Возвращает количество миллисекунд в строке даты начиная с 1 января, 1970, 00:00:00, в местном времени.
setDate
Устанавливает день месяца для определенной даты.
setHours
Устанавливает часы для определенной даты.
setMinutes
Устанавливает минуты для определенной даты.
setMonth
Устанавливает месяц для определенной даты.
setSeconds
Устанавливает секунды для определенной даты.
setTime
Устанавливает значение объекта Date.
setYear
Устанавливает год для определенной даты.
toGMTString
Преобразовывает дату в строку, используя Internet GMT соглашение.
toLocaleString
Преобразовывает дату в строку, используя текущие местные соглашения.
UTC
Возвращает количество миллисекунд в объекте Date начиная с 1 января, 1970, 00:00:00, Универсальное Координирование Времени (GMT).

Примеры

Следующие примеры показывают отдельные способы назначения даты:

today = new Date()
birthday = new Date("December 17, 1995 03:24:00")
birthday = new Date(95,11,17)
birthday = new Date(95,11,17,3,24,0)

Свойства

prototype

Представляет прототип для этого класса. Вы можете использовать прототип, чтобы добавлять свойства или методы ко всем образцам класса. Для информации о прототипах смотрите Function.prototype.

Свойство объекта Date
Реализовано в Navigator 3.0, LiveWire 1.0

Методы

getDate

Возвращает день месяца для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getDate()

Параметры

Нет.

Описание

Значение, возвращенное getDate - целое число между 1 и 31.

Примеры

Второе выражение присваивает значение 25 переменной day, основываясь на значении объекта Xmas95 типа Date.

Xmas95 = new Date("December 25, 1995 23:15:00")
day = Xmas95.getDate()

Смотрите также

Date.setDate

getDay

Возвращает день недели для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getDay()

Параметры

Нет.

Описание

Значение, возвращенное getDay - целое число, соответствующее дню недели: 0 для воскресенья, 1 для понедельника, 2 для вторника и так далее.

Примеры

Второе выражение присваивает значение 1 переменной weekday, основываясь на значении объекта Xmas95 типа Date. 25 декабря, 1995, понедельник.

Xmas95 = new Date("December 25, 1995 23:15:00")
weekday = Xmas95.getDay()

getHours

Возвращает час для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getHours()

Параметры

Нет.

Описание

Значение, возвращенное getHours - целое число между 0 и 23.

Примеры

Второе выражение присваивает значение 23 переменной hours, основываясь на значении объекта Xmas95 типа Date.

Xmas95 = new Date("December 25, 1995 23:15:00")
hours = Xmas95.getHours()

Смотрите также

Date.setHours

getMinutes

Возвращает минуты для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getMinutes()

Параметры

Нет.

Описание

Значение, возвращеное getMinutes - целое число между 0 и 59.

Примеры

Второе выражение присваивает значение 15 переменной minutes, основываясь на значении объекта Xmas95 типа Date.

Xmas95 = new Date("December 25, 1995 23:15:00")
minutes = Xmas95.getMinutes()

Смотрите также

Date.setMinutes

getMonth

Возвращает месяц для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getMonth()

Параметры

Нет.

Описание

Значение, возвращенное getMonth - целое число между 0 и 11. 0 соответствует январю, 1 февралю и так далее.

Примеры

Второе выражение присваивает значение 11 переменной month, основываясь на значении объекта Xmas95 типа Date.

Xmas95 = new Date("December 25, 1995 23:15:00")
month = Xmas95.getMonth()

Смотрите также

Date.setMonth

getSeconds

Возвращает секунды в текущем времени.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getSeconds()

Параметры

Нет.

Описание

Значение, возвращенное getSeconds - целое значение между 0 и 59.

Примеры

Второе выражение присваивает значение 30 переменной secs, основываясь на значении объекта Xmas95 типа Date.

Xmas95 = new Date("December 25, 1995 23:15:30")
secs = Xmas95.getSeconds()

Смотрите также

Date.setSeconds

getTime

Возвращает числовое значение, соответствующее времени для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getTime()

Параметры

Нет.

Описание

Значение, возвращенное методом getTime - количество миллисекунд начиная с 1 января 1970 00:00:00. Вы можете использовать этот метод для упрощения назначения даты и времени другому объекту Date.

Примеры

Следующий пример присваивает значение даты theBigDay объекту sameAsBigDay:

theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())

Смотрите также

Date.setTime

getTimezoneOffset

Возвращает смещение часового пояса в минутах для текущего региона.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getTimezoneOffset()

Параметры

Нет.

Описание

Смещение часового пояса это различие между местным временем и Средним Временем по Гринвичу (GMT). Время сбережения дневного света делает это значение переменным.

Примеры

x = new Date()
currentTimeZoneOffsetInHours = x.getTimezoneOffset()/60

getYear

Возвращает год для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

getYear()

Параметры

Нет.

Описание

Метод getYear возвращает или 2-значное или 4-значное значение года:

Примеры

Пример 1. Второе выражение присваивает значение 95 переменной year.

Xmas = new Date("December 25, 1995 23:15:00")
year = Xmas.getYear()
Пример 2. Второе выражение присваивает значение 2000 переменной year.

Xmas = new Date("December 25, 2000 23:15:00")
year = Xmas.getYear()
Пример 3. Второе выражение присваивает значение 95 переменной year, представляющей 1995 год.

Xmas.setYear(95)
year = Xmas.getYear()

Смотрите также

Date.setYear

parse

Возвращает количество миллисекунд в строке с датой начиная с 1 января, 1970, 00:00:00, по местному времени.

Метод объекта Date
Статический
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

Date.parse(dateString)

Параметры

:

dateString
Строка, представляющая дату.

Описание

Метод parse принимает строку с датой (такую как "Dec 25, 1995") и вовращает количество миллисекунд начиная с 1 января, 1970, 00:00:00 (по местному времени). Эта функция полезна для установки значений даты, основанных на строковых значениях, например с методом setTime и объектом Date.

Дается строка, представляющая время, parse возвращает значение времени. Оно принимает синтаксис даты в стандарте IETF: "Mon, 25 Dec 1995 13:30:00 GMT". Это подразумевает континентальные сокращения часового пояса США, но для общего использования, используется смещение часового пояса, например, "Mon, 25 Dec 1995 13:30:00 GMT+0430" (4 часа, 30 минут к западу от меридиана Гринвича). Если Вы не определяете часовой пояс, принимается местная временная зона. GMT и UTC рассматриваются эквивалентными.

Так как parse является статическим методом объекта Date, Вы всегда используете его как Date.parse(), предпочтительней чем как метод созданного Вами объекта Date.

Примеры

Если IPOdate существующий объект Date, Вы можете установить его в 9 августа, 1995 следующим образом:

IPOdate.setTime(Date.parse("Aug 9, 1995"))

Смотрите также

Date.UTC

setDate

Устанавливает день месяца для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setDate(dayValue)

Параметры

dayValue
Целое число от 1 до 31, представляющее день месяца.

Примеры

Второе выражение изменяет первоначальное значение дня объекта theBigDay на 24 июля.

theBigDay = new Date("July 27, 1962 23:30:00")
theBigDay.setDate(24)

Смотрите также

Date.getDate

setHours

Устанавливает часы для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setHours(hoursValue)

Параметры

hoursValue
Целое число между 0 и 23, представляющее час.

Примеры

theBigDay.setHours(7)

Смотрите также

Date.getHours

setMinutes

Устанавливает минуты для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setMinutes(minutesValue)

Параметры

minutesValue
Целое число между 0 и 59, представляющее минуты.

Примеры

theBigDay.setMinutes(45)

Смотрите также

Date.getMinutes

setMonth

Устанавливает месяц для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setMonth(monthValue)

Параметры

monthValue
Целое число между 0 и 11 (представляющее месяцы от января до декабря).

Примеры

theBigDay.setMonth(6)

Смотрите также

Date.getMonth

setSeconds

Устанавливает секунды для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setSeconds(secondsValue)

Параметры

secondsValue
Целое число между 0 и 59.

Примеры

theBigDay.setSeconds(30)

Смотрите также

Date.getSeconds

setTime

Устанавливает значение объекта Date.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setTime(timevalue) 

Параметры

timevalue
Целое число, представляющее количество миллисекунд начиная с 1 января 1970 00:00:00.

Описание

Используйте метод setTime для упрощения назначения даты и времени другому объекту Date.

Примеры

theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())

Смотрите также

Date.getTime

setYear

Устанавливает год для определенной даты.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

setYear(yearValue)

Параметры

yearValue
Целое число.

Описание

Если yearValue число между 0 и 99 (включительно), тогда год для dateObjectName устанавливается в 1900 + yearValue. Иначе, год для dateObjectName устанавливается в yearValue.

Примеры

Обратите внимание, что имеются два способа установки года 20-го столетия.

Пример 1. Год устанавливается в 1996.

theBigDay.setYear(96)
Пример 2. Год устанавливается в 1996.

theBigDay.setYear(1996)
Пример 3. Год устанавливается в 2000.

theBigDay.setYear(2000)

Смотрите также

Date.getYear

toGMTString

Преобразовывает дату в строку, используя Internet GMT соглашения.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

toGMTString()

Параметры

Нет.

Описание

Точный формат значения, возвращенного toGMTString изменяется в зависимости от платформы.

Примеры

В следующем примере, today это объект Date:

today.toGMTString()
В этом примере метод toGMTString преобразует дату в GMT (UTC), используя смещение часового пояса операционной системы и возвращает строковое значение, подобное следующей форме. Точный формат зависит от платформы.

Mon, 18 Dec 1995 17:28:35 GMT

Смотрите также

Date.toLocaleString

toLocaleString

Преобразовывает дату в строку, используя соглашения текущего региона.

Метод объекта Date
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

toLocaleString()

Параметры

Нет.

Описание

Если Вы передаете дату, используя toLocaleString, знайте, что различные платформы транслируют строку различными способами. Использование методов, таких как getHours, getMinutes и getSeconds дает более универсальные результаты.

Примеры

В следующем примере today является объектом Date:

today = new Date(95,11,18,17,28,35) //месяцы представлены от 0 до 11
today.toLocaleString()
В этом примере toLocaleString возвращает строковое значение, подобное следующей форме. Точный формат зависит от платформы.

12/18/95 17:28:35

Смотрите также

Date.toGMTString

UTC

Возвращает количество миллисекунд в объекте Date начиная с 1 января, 1970, 00:00:00, Универсальное Координированное Время (GMT).

Метод объекта Date
Статический
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

Date.UTC(year, month, day, hrs, min, sec)

Параметры

year
Год после 1900.
month
Месяц между 0 и 11.
date
День месяца между 1 и 31.
hrs
(Факультативно) Количество часов между 0 и 23.
min
(Факультативно) Количество минут между 0 и 59.
sec
(Факультативно) Количество секунд между 0 и 59.

Описание

UTC получает разграниченные запятой параметры даты и возвращает количество миллисекунд начиная с 1 января, 1970, 00:00:00, Универсальное Координированное Время (GMT).

Так как UTC статический метод объекта Date, Вы всегда используете его как Date.UTC(), предпочтительней, чем как метод созданного Вами объекта Date.

Примеры

Следующее выражение создает объект Date, используя GMT вместо местного времени:

gmtDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0))

Смотрите также

Date.parse


[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 16:00:33


Права © 1997 Netscape Communications Corporation



Все мессаги сюда:yanich@inbox.ru
Hosted by uCoz