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