 |
     |
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaScript 1.1: добавлено свойство prototype. JavaScript 1.3: удалена зависимость от платформы; добавлен параметр ms_num в конструктор Date; добавлены методы getFullYear, setFullYear, getMilliseconds, setMilliseconds, toSource и UTC-методы (такие как getUTCDate и setUTCDate). | |
new Date()Версии до JavaScript 1.3:
new Date(milliseconds)
new Date(dateString)
new Date(yr_num, mo_num, day_num
[, hr_num, min_num, sec_num, ms_num])
new Date()
new Date(milliseconds)
new Date(dateString)
new Date(yr_num, mo_num, day_num[, hr_num, min_num, sec_num])
milliseconds | Целочисленное значение - количество миллисекунд после даты 1 января 1970 года, 00:00:00. |
dateString | Строковое значение - дата. Строка должна иметь формат, распознаваемый методом Date.parse. |
yr_num, mo_num, | Целочисленные значения, представляющие части даты. Месяц это числа от 0 до 11, 0=January, 11=December. |
hr_num, min_num, |
Если аргументы не заданы, конструктор создаёт объект Date с текущей датой и временем в соответствии с локальным временем. Если заданы некоторые, но не все, аргументы, отсутствующие аргументы устанавливаются в 0. Если Вы задаёте некоторые аргументы, Вы обязаны как минимум задать значения year, month и day. Можно опустить hours, minutes, seconds и milliseconds.
Дата измеряется в миллисекундах, прошедших с полуночи 01 января 1970 UTC.
В сутках 86,400,000 миллисекунд. Объект Date имеет диапазон от -100,000,000
до 100,000,000 дней относительно 01 January, 1970 UTC.
Объект Date имеет универсальное поведение на всех платформах.
Объект Date поддерживает несколько UTC-методов (универсальных), а также методы локального времени.
UTC, известное также как Greenwich Mean Time (GMT) - время по Гринвичу, это время по стандарту World Time Standard.
локальное время это время компьютера, на котором выполняется JavaScript.
Для обеспечения совместимости с переходом в новое тысячелетие Вы должны всегда полностью специфицировать год; например, используйте 1998, а не 98. Для специфицирования полного года JavaScript имеет методы getFullYear, setFullYear, getFullUTCYear и setFullUTCYear.
Следующий пример возвращает время в миллисекундах, прошедшее между датами timeA и timeB.
timeA = new Date();
// Здесь некоторые операторы.
timeB = new Date();
timeDifference = timeB - timeA;
JavaScript 1.2 и ранее.Поведение объекта Date таково:
| Свойство | Описание |
|---|---|
constructor | |
prototype |
| Метод | Описание |
|---|---|
getDate | Возвращает день/число месяца для специфицированной даты в соответствии с локальным временем. |
getDay | Возвращает день недели для специфицированной даты в соответствии с локальным временем. |
Возвращает год для специфицированной даты в соответствии с локальным временем. | |
getHours | Возвращает часы для специфицированной даты в соответствии с локальным временем. |
Возвращает миллисекунды для специфицированной даты в соответствии с локальным временем. | |
getMinutes | Возвращает минуты для специфицированной даты в соответствии с локальным временем. |
getMonth | Возвращает месяц для специфицированной даты в соответствии с локальным временем. |
getSeconds | Возвращает секунды для специфицированной даты в соответствии с локальным временем. |
getTime | Возвращает числовое значение - время для специфицированной даты в соответствии с локальным временем. |
getTimezoneOffset | Возвращает смещение часового пояса в минутах для текущей местности. |
Возвращает число/день месяца для специфицированной даты в соответствии со всемирным временем. | |
Возвращает день недели для специфицированной даты в соответствии со всемирным временем. | |
Возвращает год для специфицированной даты в соответствии со всемирным временем. | |
Возвращает часы для специфицированной даты в соответствии со всемирным временем. | |
Возвращает миллисекунды для специфицированной даты в соответствии со всемирным временем. | |
Возвращает минуты для специфицированной даты в соответствии со всемирным временем. | |
Возвращает месяц для специфицированной даты в соответствии со всемирным временем. | |
Возвращает секунды для специфицированной даты в соответствии со всемирным временем. | |
getYear | Возвращает год для специфицированной даты в соответствии с локальным временем. |
parse | Возвращает количество миллисекунд в дате, прошедших после 1 января 1970, 00:00:00, местного времени. |
setDate | Устанавливает день месяца для специфицированной даты в соответствии с локальным временем. |
Устанавливает год для специфицированной даты в соответствии с локальным временем. | |
setHours | Устанавливает час для специфицированной даты в соответствии с локальным временем. |
Устанавливает часы для специфицированной даты в соответствии с локальным временем. | |
setMinutes | Устанавливает минуты для специфицированной даты в соответствии с локальным временем. |
setMonth | Устанавливает месяц для специфицированной даты в соответствии с локальным временем. |
Устанавливает секунды для специфицированной даты в соответствии с локальным временем. | |
Устанавливает значение объекта Date в соответствии с локальным временем. | |
Устанавливает число/день месяца для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает полный год для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает час для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает миллисекунды для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает минуты для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает месяц для специфицированной даты в соответствии со всемирным временем. | |
Устанавливает секунды для специфицированной даты в соответствии со всемирным временем. | |
setYear | Устанавливает год для специфицированной даты в соответствии с локальным временем. |
toGMTString | Конвертирует дату в строку, используя соглашения Internet по GMT. |
toLocaleString | Конвертирует дату в строку, используя соглашения текущей местности. |
toSource | Возвращает литерал объекта, представляющий специфицированный Date -объект; Вы можете использовать это значение для создания нового объекта. Переопределяет метод Object.toSource. |
toString | Возвращает строку, представляющую специфицированный Date -объект. Переопределяет метод Object.toString. |
Конвертирует дату в строку, используя соглашения по всемирному времени. | |
UTC | Возвращает количество миллисекунд в Date -объекте после 1 января 1970, 00:00:00, всемирного времени. |
valueOf | Возвращает примитивное значение Date -объекта. Переопределяет метод Object.valueOf. |
Кроме того, этот объект наследует методы watch и unwatch из объекта Object.
Вот примеры присвоения значений-дат:
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)
Специфицирует функцию, создающую прототип объекта. Заметьте, что значение этого свойства является ссылка на функцию, а не строка с именем функции.
См. Object.constructor.
Возвращает день/число месяца в специфицированной дате в соответствии с локальным временем.
getDate()
getDate возвращает целое число в диапазоне от 1 до 31.
Второй оператор присваивает значение 25 переменной day на основе значения Date -объекта Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
day = Xmas95.getDate()
Возвращает день для специфицированной даты в соответствии с локальным временем.
getDay()
getDay возвращает целое число, соответствующее дню недели: 0 - воскресенье, 1 - понедельник, 2 - вторник и т.д.
Второй оператор присваивает значение 1 переменной weekday на основе значения Date -объекта Xmas95. December 25, 1995, это Monday/Понедельник.
Xmas95 = new Date("December 25, 1995 23:15:00")
weekday = Xmas95.getDay()
Возвращает день год для специфицированной даты в соответствии с локальным временем.
getFullYear()
getFullYear возвращает абсолютное число. Для дат в диапазоне лет от 1000 до 9999 getFullYear возвращает число из 4 цифр, например, 1995. Используйте эту функцию, чтобы иметь уверенность в соответствии числа для лет после 2000.
Используёте этот метод вместо getYear.
Число из 4 цифр - год - присваивается переменной yr.
var yr;
Today = new Date();
yr = Today.getFullYear();
Возвращает час для специфицированной даты в соответствии с локальным временем.
getHours()
getHours возвращает целое число в диапазоне от 0 до 23.
Второй оператор присваивает значение 23 переменной hours на основе значения Date -объекта Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
hours = Xmas95.getHours()
Возвращает количество миллисекунд для специфицированной даты в соответствии с локальным временем.
getMilliseconds()
getMilliseconds возвращает число в диапазоне от 0 до 999.
Часть миллисекунд текущей даты присваивается переменной ms.
var ms;
Today = new Date();
ms = Today.getMilliseconds();
Возвращает минуты для специфицированной даты в соответствии с локальным временем.
getMinutes()
getMinutes возвращает целое число в диапазоне от 0 до 59.
Второй оператор присваивает значение 15 переменной minutes на основе значения Date -объекта Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
minutes = Xmas95.getMinutes()
Возвращает месяц для специфицированной даты в соответствии с локальным временем.
getMonth()
getMonth возвращает целое число в диапазоне от 0 до 11. 0 соответствует January, 1 - February и т.д.
Второй оператор присваивает значение 11 переменной month на основе значения Date -объекта Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
month = Xmas95.getMonth()
Возвращает секунды для специфицированной даты в соответствии с локальным временем.
getSeconds()
getSeconds возвращает целое число в диапазоне от 0 до 59.
Второй оператор присваивает значение 30 переменной secs на основе значения Date -объекта Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:30")
secs = Xmas95.getSeconds()
Возвращает числовое значение, соответствующее времени для специфицированной даты в соответствии с локальным временем.
getTime()
getTime возвращает количество миллисекунд, прошедших после 1 января 1970, 00:00:00. Вы можете использовать этот метод для присвоения даты и времени другому Date -объекту.
Значение даты в theBigDay присваивается sameAsBigDay:
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())
Возвращает смещение часового пояса в минутах для данной местности.
getTimezoneOffset()
Смещение часового пояса это разница между местным временем и Greenwich Mean Time (GMT). Корректировка перехода на летнее время делает это значение неконстантным.
x = new Date()
currentTimeZoneOffsetInHours = x.getTimezoneOffset()/60
Возвращает день/число месяца для специфицированной даты в соответствии со всемирным временем.
getUTCDate()
getUTCDate возвращает целое число в диапазоне от 1 до 31.
Часть day текущей даты присваивается переменной d.
var d;
Today = new Date();
d = Today.getUTCDate();
Возвращает день недели для специфицированной даты в соответствии со всемирным временем.
getUTCDay()
getUTCDay возвращает целое число - день недели: 0 - воскресенье, 1 - понедельник, 2 - вторник и т.д.
Часть weekday текущей даты присваивается переменной ms.
var weekday;
Today = new Date()
weekday = Today.getUTCDay()
Возвращает год для специфицированной даты в соответствии со всемирным временем.
getUTCFullYear()
getUTCFullYear возвращает абсолютное число, соответствующее year-2000, например, 1995.
4-значное значение текущего года присваивается переменной yr.
var yr;
Today = new Date();
yr = Today.getUTCFullYear();
Возвращает час для специфицированной даты в соответствии со всемирным временем.
getUTCHours()
getUTCHours возвращает целое число в диапазоне от 0 до 23.
Часть hours текущего времени присваивается переменной hrs.
var hrs;
Today = new Date();
hrs = Today.getUTCHours();
Возвращает миллисекунды для специфицированной даты в соответствии со всемирным временем.
getUTCMilliSeconds()
getUTCMilliseconds возвращает целое число в диапазоне от 0 до 999.
Часть milliseconds текущего времени присваивается переменной ms.
var ms;
Today = new Date();
ms = Today.getUTCMilliseconds();
Возвращает минуты для специфицированной даты в соответствии со всемирным временем.
getUTCMinutes()
getUTCMinutes возвращает целое число в диапазоне от 0 до 59.
Часть minutes текущего времени присваивается переменной min.
var min;
Today = new Date();
min = Today.getUTCMinutes();
Возвращает месяц для специфицированной даты в соответствии со всемирным временем.
getUTCMonth()
getUTCMonth возвращает целое число в диапазоне от 0 до 11.
0 - январь, 1 -февраль, 2 -март и т.д.
Часть month текущей даты присваивается переменной mon.
var mon;
Today = new Date();
mon = Today.getUTCMonth();
Возвращает секунды для специфицированной даты в соответствии со всемирным временем.
getUTCSeconds()
getUTCSeconds возвращает целое сило в диапазоне от 0 до 59.
Часть seconds текущего времени присваивается переменной sec.
var sec;
Today = new Date();
sec = Today.getUTCSeconds();
Возвращает год для специфицированной даты в соответствии с локальным временем.
JavaScript 1.3: не рекомендуется применять; getYear возвращает год минус 1900, независимо от специфицированного года. | |
getYear()
getYear больше не используется и заменён на метод getFullYear.
Метод getYear возвращает год минус 1900; соответственно:
Чтобы учесть годы до и после 2000, Вы должны использовать Date.getFullYear вместо getYear, чтобы был специфицирован полный год.
JavaScript 1.2 и ранее. Метод getYear возвращает 2-х или 4-хзначное число - год:
Второй оператор присваивает значение 95 переменной year.
Xmas = new Date("December 25, 1995 23:15:00")Пример 2.
year = Xmas.getYear() // возвращает 95
Второй оператор присваивает значение 100 переменной year.
Xmas = new Date("December 25, 2000 23:15:00")Пример 3.
year = Xmas.getYear() // возвращает 100
Второй оператор присваивает значение -100 переменной year.
Xmas = new Date("December 25, 1800 23:15:00")Пример 4.
year = Xmas.getYear() // возвращает -100
Второй оператор присваивает значение 95 переменной year, представляя 1995 год.
Xmas.setYear(95)
year = Xmas.getYear() // возвращает 95
Возвращает количество миллисекунд в строке даты, прошедших после 2 января 1970, 00:00:00, местного времени.
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 это static-метод объекта Date, Вы всегда используете его как Date.parse(), а не как метод Date -объекта, созданного Вами.
Если IPOdate это существующий Date -объект, Вы можете установить его в August 9, 1995 таким образом:
IPOdate.setTime(Date.parse("Aug 9, 1995"))
Прототип для данного класса. Вы можете использовать этот прототип для добавления свойств или методов во все экземпляры класса. О прототипах см. Function.prototype.
Устанавливает день/число месяца для специфицированной даты в соответствии с локальным временем.
setDate(dayValue)
dayValue |
Второй оператор изменяет theBigDay на July 24.
theBigDay = new Date("July 27, 1962 23:30:00")
theBigDay.setDate(24)
Устанавливает полный год для специфицированной даты в соответствии с локальным временем.
setFullYear(yearValue[, monthValue, dayValue])
yearValue | |
monthValue | |
dayValue | Целое число от 1 до 31 день/число месяца. Если Вы специфицируете параметр dayValue, Вы обязаны также специфицировать и monthValue. |
Если параметры monthValue и dayValue не специфицированы, используются значения, возвращаемые методами getMonth и getDate.
Если специфицированные Вами параметры находятся вне пределов ожидаемого диапазона, setFullYear пытается соответствующим образом обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицируете 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.
theBigDay = new Date();
theBigDay.setFullYear(1997);
Устанавливает час для специфицированной даты в соответствии с локальным временем.
JavaScript 1.3: добавлены параметры minutesValue, secondsValue и msValue. | |
setHours(hoursValue[, minutesValue, secondsValue, msValue])Версии до JavaScript 1.3:
setHours(hoursValue)
hoursValue | |
minutesValue | |
secondsValue | Целое число от 0 до 59 - секунды. Если Вы специфицируете параметр secondsValue, Вы обязаны также специфицировать и minutesValue. |
msValue | Число от 0 до 999 - миллисекунды. Если вы специфицируете параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue. |
Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setHours пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.
theBigDay.setHours(7)
Устанавливает миллисекунды для специфицированной даты в соответствии с локальным временем.
setMilliseconds(millisecondsValue)
millisecondsValue |
Если Вы специфицируете число вне пределов ожидаемого диапазона, информация даты в Date -объекте обновляется соответствующим образом. Например, если Вы специфицировали 1005, количество секунд увеличивается на 1, а 5 используется для миллисекунд.
theBigDay = new Date();
theBigDay.setMilliseconds(100);
Устанавливает минуты для специфицированной даты в соответствии с локальным временем.
setMinutes(minutesValue[, secondsValue, msValue])Версии до JavaScript 1.3:
setMinutes(minutesValue)
minutesValue | |
secondsValue | Целое число от 0 до 59 - секунды. Если Вы специфицировали параметр secondsValue, Вы обязаны также специфицировать и minutesValue. |
msValue | Число от 0 до 999 - миллисекунды. Если вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue. |
theBigDay.setMinutes(45)
Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getSeconds и getMilliseconds.
Если Вы специфицировали параметр вне ожидаемого диапазона, setMinutes пытается соответствующим образом обновить информацию даты в объекте Date. Например, если Вы использовали 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будет использовано для секунд.
Устанавливает месяц для специфицированной даты в соответствии с локальным временем.
setMonth(monthValue[, dayValue])Версии до JavaScript 1.3:
setMonth(monthValue)
monthValue | |
dayValue |
Если Вы не специфицировали параметр dayValue, используется значение из метода getDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setMonth пытается обновить информацию даты в Date -объекте. Например, если Вы использовали 15 для monthValue, год увеличивается на 1 (year + 1), а 3 будет использовано для месяцев/month.
theBigDay.setMonth(6)
Устанавливает секунды для специфицированной даты в соответствии с локальным временем.
setSeconds(secondsValue[, msValue])Версии до JavaScript 1.3:
setSeconds(secondsValue)
secondsValue | |
msValue |
Если Вы не специфицируете параметр msValue, используется значение, возвращаемое методом getMilliseconds.
Если специфицированный Вами параметр находится вне ожидаемого диапазона, setSeconds пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты, хранимые в объекте Date, будут увеличены на 1, а 40 будет использовано для секунд.
theBigDay.setSeconds(30)
Устанавливает значение Date -объекта в соответствии с локальным временем.
setTime(timevalue)
timevalue | Целое число - количество миллисекунд после 1 января 1970, 00:00:00. |
Используйте метод setTime для присвоения даты и времени другому Date -объекту.
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())
Устанавливает день/число месяца для специфицированной даты в соответствии со всемирным временем.
setUTCDate(dayValue)
dayValue |
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCDate пытается обновить информацию даты в Date -объекте. Например, если использовано 40 для dayValue, а хранимый в объекте Date месяц - June, день будет изменён на 10, а месяц будет увеличен до July.
theBigDay = new Date();
theBigDay.setUTCDate(20);
Устанавливает полный год для специфицированной даты в соответствии со всемирным временем.
setUTCFullYear(yearValue[, monthValue, dayValue])
yearValue | Целое число, специфицирующее числовое значение года, например, 1995. |
monthValue | |
dayValue | Целое число от 1 до 31 день/число месяца. Если Вы специфицировали параметр dayValue, Вы обязаны также специфицировать monthValue. |
Если Вы не специфицировали параметры monthValue и dayValue, используются значения, возвращаемые методами getMonth и getDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCFullYear пытается обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицировали 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.
theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
Устанавливает час для специфицированной даты в соответствии со всемирным временем.
setUTCHour(hoursValue[, minutesValue, secondsValue, msValue])
hoursValue | |
minutesValue | |
secondsValue | Целое число от 0 до 59 - секунды. Если Вы специфицировали secondsValue, Вы обязаны также специфицировать minutesValue. |
msValue | Число от 0 до 999 - миллисекунды. Если Вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue. |
Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCHours пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.
theBigDay = new Date();
theBigDay.setUTCHour(8);
Устанавливает миллисекунды для специфицированной даты в соответствии со всемирным временем.
setUTCMilliseconds(millisecondsValue)
millisecondsValue |
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMilliseconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 1100 для millisecondsValue, секунды, хранимые в объекте Date, будут увеличены на 1, а 100 будет использовано для миллисекунд.
theBigDay = new Date();
theBigDay.setUTCMilliseconds(500);
Устанавливает минуты для специфицированной даты в соответствии со всемирным временем.
setUTCMinutes(minutesValue[, secondsValue, msValue])
minutesValue | |
secondsValue | Целое число от 0 до 59 - секунды. Если Вы специфицировали secondsValue, Вы обязаны также специфицировать minutesValue. |
msValue | Число от 0 до 999 - миллисекунды. Если Вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue. |
Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getUTCSeconds и getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMinutes пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будут использованы для секунд.
theBigDay = new Date();
theBigDay.setUTCMinutes(43);
Устанавливает месяц для специфицированной даты в соответствии со всемирным временем.
setUTCMonth(monthValue[, dayValue])
monthValue | |
dayValue |
Если Вы не специфицировали параметр dayValue, будет использовано значение, возвращаемое методом getUTCDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMonth пытается обновить информацию в Date -объекте. Например, если Вы использовали 15 для monthValue, год будет увеличен на 1 (year + 1), а 3 будет использовано для месяцев.
theBigDay = new Date();
theBigDay.setUTCMonth(11);
Устанавливает секунды для специфицированной даты в соответствии со всемирным временем.
setUTCSeconds(secondsValue[, msValue])
secondsValue | |
msValue |
Если Вы не специфицировали параметр msValue, используется значение, возвращаемое методом getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCSeconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 100 для secondsValue, минуты, хранимые в Date -объекте, будут увеличены на 1, а 40 будет использовано для секунд.
theBigDay = new Date();
theBigDay.setUTCSeconds(20);
Устанавливает год для специфицированной даты в соответствии с локальным временем.
setYear(yearValue)
yearValue |
setYear больше не используется и заменён на метод setFullYear.
Если yearValue это число от 0 до 99 (включительно), то год для dateObjectName устанавливается в 1900 + yearValue. Иначе год для dateObjectName устанавливается в yearValue.
Чтобы учесть годы до и после 2000, Вы должны использовать setFullYear вместо setYear, чтобы год был специфицирован полностью.
Обратите внимание, что имеются два способа установки года в 20 столетии.
Пример 1.Год установлен в 1996.
theBigDay.setYear(96)Пример 2.
Год установлен в 1996.
theBigDay.setYear(1996)Пример 3.
Год установлен 2000.
theBigDay.setYear(2000)
Конвертирует дату в строку с использованием соглашений Internet по GMT.
toGMTString()
toGMTString больше не используется, не рекомендуется к применению и заменён на метод toUTCString.
Точный формат возвращаемого toGMTString значения варьируется в зависимости от платформы.
Вы должны использовать Date.toUTCString вместо toGMTSTring.
today.toGMTString()
В этом примере метод toGMTString конвертирует дату в GMT (UTC), используя смещение часового пояса операционной системы, и возвращает строковое значение, которое имеет примерно следующую форму. (Точная форма зависит от платформы.)
Mon, 18 Dec 1995 17:28:35 GMT
Конвертирует дату в строку, используя соглашения данной местности.
toLocaleString()
Если Вы передаёте дату с использованием toLocaleString, имейте в виду, что разные платформы ассемблируют строки по-разному. Методы, такие как getHours, getMinutes и getSeconds, дают более переносимые результаты.
Метод toLocaleString опирается на ОС при форматировании дат. Он конвертирует дату в строку, используя соглашения по форматированию операционной системы, на которой скрипт запущен. Например, в США месяц идёт перед числом (04/15/98), а в Германии число идёт перед месяцем (15.04.98). Если ОС не решает проблему year-2000 и не использует полный год для лет до 1900 или после 2000, toLocaleString возвращает строку, которая не решает проблему year-2000. toLocaleString ведёт себя аналогично методу toString при конвертации года, который ОС форматирует несоответствующим образом.
В следующем примере today это Date -объект:
today = new Date(95,11,18,17,28,35) //месяц представлен числами от 0 до 11
today.toLocaleString()
В следующем примере toLocaleString возвращает строковое значение в такой форме. (Точный формат зависит от платформы.)
12/18/95 17:28:35
Возвращает строку, представляющую исходный код объекта.
toSource()
Метод toSource возвращает следующие значения:
function Date() {
[native code]
}
Этот метод обычно вызывается JavaScript внутренне, а не явно в коде.
Возвращает строку, представляющую специфицированный Date -объект.
toString()
Объект Date переопределяет метод toString объекта Object; он не наследует Object.toString. Для объектов Date метод toString возвращает строковое представление объекта.
JavaScript автоматически вызывает метод toString, когда даты представлена как текстовое значение или когда на дату ссылаются при конкатенации строк.
toString -значение объекта Date присваивается переменной myVar:
x = new Date();
myVar=x.toString(); //присваивается значение переменной myVar, как здесь, например:
//Mon Sep 28 14:36:22 GMT-0700 (Pacific Daylight Time) 1998
Конвертирует дату в строку, используя соглашение по всемирному времени.
toUTCString()
Значение, возвращаемое методом toUTCString, является читаемой строкой, сформатированной в соответствии с соглашением UTC. Формат return-значения может варьироваться в зависимости от платформы.
var UTCstring;
Today = new Date();
UTCstring = Today.toUTCString();
Возвращает количество миллисекунд в Date -объекте, прошедших после 1 января 1970 года, 00:00:00, всемирного времени.
Date.UTC(year, month, day[, hrs, min, sec, ms])
year | |
month | |
date | |
hrs | |
min | |
sec | |
ms |
UTC принимает разделённые запятыми параметры даты и возвращает количество миллисекунд прошедшее в период от 1 января 1970 года 00:00:00 всемирного времени до времени, специфицированного Вами.
Вы должны специфицировать полный год для year; например, 1998. Если специфицирован год в диапазоне от 0 до 99, метод конвертирует год в год 20 столетия (1900 + year); например, если специфицировано 95, используется 1995 год.
Метод UTC отличается от конструктора Date двумя позициями:
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, метод UTC обновляет другие параметры Вашего числа. Например, если Вы используете 15 для month, год будет увеличен на 1 (year + 1), а 3 будет использоваться для месяца.
Поскольку UTC это static-метод объекта Date, Вы всегда используете его так Date.UTC(), а не как метод созданного Вами Date -объекта.
Оператор создаёт Date -объект с использованием GMT вместо локального времени:
gmtDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0))
Возвращает примитивное значение объекта Date.
valueOf()
Метод valueOf объекта Date возвращает примитивное значение объекта Date как тип данных number (число), количество миллисекунд, прошедших после полуночи 01 января 1970 года по UTC.
Это метод обычно вызывается в JavaScript внутренне, а не явно в коде.
x = new Date(56,6,17);
myVar=x.valueOf() //присваивает -424713600000 переменной myVar
Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation
|
Книги-online