Оглавление | Назад | Вперёд | Индекс

Date

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

Создание

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

new Date()
new Date(milliseconds)
new Date(dateString)

new Date(yr_num, mo_num, day_num
        [,
hr_num, min_num, sec_num, ms_num])

Версии до 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])

Параметры

milliseconds

dateString

yr_num, mo_num,
day_num

hr_num, min_num,
sec_num, ms_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 таково:

• Даты до 1970 не допускаются.
• JavaScript зависит от специфики дат на данной платформе; поведение объекта Date меняется от платформы к платформе.

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

constructor

prototype

Методы. Резюме.

getDate

getDay

getHours

getMinutes

getMonth

getSeconds

getTime

getTimezoneOffset

getYear

parse

setDate

setHours

setMinutes

setMonth

setYear

toGMTString

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)

constructor

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

Описание

См. Object.constructor.

getDate

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

Синтаксис

getDate()

Параметры

Отсутствуют.

Описание

getDate возвращает целое число в диапазоне от 1 до 31.

Пример

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

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

См. также

getDay

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

Синтаксис

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()

Параметры

Отсутствуют.

Описание

getFullYear возвращает абсолютное число. Для дат в диапазоне лет от 1000 до 9999 getFullYear возвращает число из 4 цифр, например, 1995. Используйте эту функцию, чтобы иметь уверенность в соответствии числа для лет после 2000.

Используёте этот метод вместо getYear.

Пример

Число из 4 цифр - год - присваивается переменной yr.

var yr;
Today = new Date();
yr = Today.getFullYear();

См. также

getHours

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

Синтаксис

getHours()

Параметры

Отсутствуют.

Описание

getHours возвращает целое число в диапазоне от 0 до 23.

Пример

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

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

См. также

getMilliseconds

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

Синтаксис

getMilliseconds()

Параметры

Отсутствуют.

Описание

getMilliseconds возвращает число в диапазоне от 0 до 999.

Пример

Часть миллисекунд текущей даты присваивается переменной ms.

var ms;
Today = new Date();
ms = Today.getMilliseconds();

См. также

getMinutes

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

Синтаксис

getMinutes()

Параметры

Отсутствуют.

Описание

getMinutes возвращает целое число в диапазоне от 0 до 59.

Пример

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

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

minutes = Xmas95.getMinutes()

См. также

getMonth

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

Синтаксис

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()

Параметры

Отсутствуют.

Описание

getSeconds возвращает целое число в диапазоне от 0 до 59.

Пример

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

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

См. также

getTime

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

Синтаксис

getTime()

Параметры

Отсутствуют.

Описание

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

Пример

Значение даты в theBigDay присваивается sameAsBigDay:

theBigDay = new Date("July 1, 1999")

sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())

См. также

getTimezoneOffset

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

Синтаксис

getTimezoneOffset()

Параметры

Отсутствуют.

Описание

Смещение часового пояса это разница между местным временем и Greenwich Mean Time (GMT). Корректировка перехода на летнее время делает это значение неконстантным.

Пример

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

getUTCDate

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

Синтаксис

getUTCDate()

Параметры

Отсутствуют.

Описание

getUTCDate возвращает целое число в диапазоне от 1 до 31.

Пример

Часть day текущей даты присваивается переменной d.

var d;
Today = new Date();
d = Today.getUTCDate();

См. также

getUTCDay

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

Синтаксис

getUTCDay()

Параметры

Отсутствуют.

Описание

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

Пример

Часть weekday текущей даты присваивается переменной ms.

var weekday;
Today = new Date()
weekday = Today.getUTCDay()

См. также

getUTCFullYear

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

Синтаксис

getUTCFullYear()

Параметры

Отсутствуют.

Описание

getUTCFullYear возвращает абсолютное число, соответствующее year-2000, например, 1995.

Пример

4-значное значение текущего года присваивается переменной yr.

var yr;
Today = new Date();
yr = Today.getUTCFullYear();

См. также

getUTCHours

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

Синтаксис

getUTCHours()

Параметры

Отсутствуют.

Описание

getUTCHours возвращает целое число в диапазоне от 0 до 23.

Пример

Часть hours текущего времени присваивается переменной hrs.

var hrs;
Today = new Date();
hrs = Today.getUTCHours();

См. также

getUTCMilliseconds

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

Синтаксис

getUTCMilliSeconds()

Параметры

Отсутствуют.

Описание

getUTCMilliseconds возвращает целое число в диапазоне от 0 до 999.

Пример

Часть milliseconds текущего времени присваивается переменной ms.

var ms;
Today = new Date();
ms = Today.getUTCMilliseconds();

См. также

getUTCMinutes

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

Синтаксис

getUTCMinutes()

Параметры

Отсутствуют.

Описание

getUTCMinutes возвращает целое число в диапазоне от 0 до 59.

Пример

Часть minutes текущего времени присваивается переменной min.

var min;
Today = new Date();
min = Today.getUTCMinutes();

См. также

getUTCMonth

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

Синтаксис

getUTCMonth()

Параметры

Отсутствуют.

Описание

getUTCMonth возвращает целое число в диапазоне от 0 до 11.
0 - январь, 1 -февраль, 2 -март и т.д.

Пример

Часть month текущей даты присваивается переменной mon.

var mon;
Today = new Date();
mon = Today.getUTCMonth();

См. также

getUTCSeconds

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

Синтаксис

getUTCSeconds()

Параметры

Отсутствуют.

Описание

getUTCSeconds возвращает целое сило в диапазоне от 0 до 59.

Пример

Часть seconds текущего времени присваивается переменной sec.

var sec;
Today = new Date();
sec = Today.getUTCSeconds();

См. также

getYear

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

Синтаксис

getYear()

Параметры

Отсутствуют.

Описание

getYear больше не используется и заменён на метод getFullYear.

Метод getYear возвращает год минус 1900; соответственно:

• Для лет больше 2000 - возвращаемое методом getYear значение будет 100 или больше. Например, если это 2026 год, getYear возвратит 126.
• Для лет от 1900 до 1999 включительно - значение, возвращаемое методом getYear, находится в диапазоне от 0 до 99. Например, если это 1976 год, getYear возвращает 76.
• Для лет меньше 1900 и больше 1999 значение, возвращаемое методом getYear, будет меньше 0. Например, если это 1800 год, getYear возвращает -100.

Чтобы учесть годы до и после 2000, Вы должны использовать Date.getFullYear вместо getYear, чтобы был специфицирован полный год.

Обратная Совместимость

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

• Для лет от 1900 до 1999 включительно - getYear возвращает значение года минус 1900. Например, если это 1976 год, будет возвращено 76.
• Для лет меньше 1900 или больше 1999 - getYear возвращает год из 4 цифр. Например, если это 1856 год, будет возвращено 1856. Если это 2026 год, будет возвращено значение 2026.

Примеры

Пример 1.

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

Xmas = new Date("December 25, 1995 23:15:00")
year = Xmas.getYear() // возвращает 95

Пример 2.

Второй оператор присваивает значение 100 переменной year.

Xmas = new Date("December 25, 2000 23:15:00")
year = Xmas.getYear() // возвращает 100

Пример 3.

Второй оператор присваивает значение -100 переменной year.

Xmas = new Date("December 25, 1800 23:15:00")
year = Xmas.getYear() // возвращает -100

Пример 4.

Второй оператор присваивает значение 95 переменной year, представляя 1995 год.

Xmas.setYear(95)
year = Xmas.getYear() // возвращает 95

См. также

parse

Возвращает количество миллисекунд в строке даты, прошедших после 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"))

См. также

prototype

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

setDate

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

Синтаксис

setDate(dayValue)

Параметр

dayValue

Пример

Второй оператор изменяет theBigDay на July 24.

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

См. также

setFullYear

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

Синтаксис

setFullYear(yearValue[, monthValue, dayValue])

Параметры

yearValue

monthValue

dayValue

Описание

Если параметры monthValue и dayValue не специфицированы, используются значения, возвращаемые методами getMonth и getDate.

Если специфицированные Вами параметры находятся вне пределов ожидаемого диапазона, setFullYear пытается соответствующим образом обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицируете 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.

Пример

theBigDay = new Date();
theBigDay.setFullYear(1997);

См. также

setHours

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

Синтаксис

setHours(hoursValue[, minutesValue, secondsValue, msValue])

Версии до JavaScript 1.3:

setHours(hoursValue)

Параметры

hoursValue

minutesValue

secondsValue

msValue

Описание

Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getMilliseconds.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setHours пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.

Примеры

theBigDay.setHours(7)

См. также

setMilliseconds

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

Синтаксис

setMilliseconds(millisecondsValue)

Параметры

millisecondsValue

Описание

Если Вы специфицируете число вне пределов ожидаемого диапазона, информация даты в Date -объекте обновляется соответствующим образом. Например, если Вы специфицировали 1005, количество секунд увеличивается на 1, а 5 используется для миллисекунд.

Пример

theBigDay = new Date();
theBigDay.setMilliseconds(100);

См. также

setMinutes

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

Синтаксис

setMinutes(minutesValue[, secondsValue, msValue])

Версии до JavaScript 1.3:

setMinutes(minutesValue)

Параметры

minutesValue

secondsValue

msValue

Примеры

theBigDay.setMinutes(45)

Описание

Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getSeconds и getMilliseconds.

Если Вы специфицировали параметр вне ожидаемого диапазона, setMinutes пытается соответствующим образом обновить информацию даты в объекте Date. Например, если Вы использовали 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будет использовано для секунд.

См. также

setMonth

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

Синтаксис

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

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

Синтаксис

setSeconds(secondsValue[, msValue])

Версии до JavaScript 1.3:

setSeconds(secondsValue)

Параметры

secondsValue

msValue

Описание

Если Вы не специфицируете параметр msValue, используется значение, возвращаемое методом getMilliseconds.

Если специфицированный Вами параметр находится вне ожидаемого диапазона, setSeconds пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты, хранимые в объекте Date, будут увеличены на 1, а 40 будет использовано для секунд.

Примеры

theBigDay.setSeconds(30)

См. также

setTime

Устанавливает значение Date -объекта в соответствии с локальным временем.

Синтаксис

setTime(timevalue)

Параметр

timevalue

Описание

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

Примеры

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

sameAsBigDay.setTime(theBigDay.getTime())

См. также

setUTCDate

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

Синтаксис

setUTCDate(dayValue)

Параметр

dayValue

Описание

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCDate пытается обновить информацию даты в Date -объекте. Например, если использовано 40 для dayValue, а хранимый в объекте Date месяц - June, день будет изменён на 10, а месяц будет увеличен до July.

Примеры

theBigDay = new Date();
theBigDay.setUTCDate(20);

См. также

setUTCFullYear

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

Синтаксис

setUTCFullYear(yearValue[, monthValue, dayValue])

Параметры

yearValue

monthValue

dayValue

Описание

Если Вы не специфицировали параметры monthValue и dayValue, используются значения, возвращаемые методами getMonth и getDate.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCFullYear пытается обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицировали 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.

Примеры

theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

См. также

setUTCHours

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

Синтаксис

setUTCHour(hoursValue[, minutesValue, secondsValue, msValue])

Параметры

hoursValue

minutesValue

secondsValue

msValue

Описание

Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getUTCMilliseconds.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCHours пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.

Примеры

theBigDay = new Date();
theBigDay.setUTCHour(8);

См. также

setUTCMilliseconds

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

Синтаксис

setUTCMilliseconds(millisecondsValue)

Параметр

millisecondsValue

Описание

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMilliseconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 1100 для millisecondsValue, секунды, хранимые в объекте Date, будут увеличены на 1, а 100 будет использовано для миллисекунд.

Примеры

theBigDay = new Date();
theBigDay.setUTCMilliseconds(500);

См. также

setUTCMinutes

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

Синтаксис

setUTCMinutes(minutesValue[, secondsValue, msValue])

Параметры

minutesValue

secondsValue

msValue

Описание

Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getUTCSeconds и getUTCMilliseconds.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMinutes пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будут использованы для секунд.

Примеры

theBigDay = new Date();
theBigDay.setUTCMinutes(43);

См. также

setUTCMonth

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

Синтаксис

setUTCMonth(monthValue[, dayValue])

Параметры

monthValue

dayValue

Описание

Если Вы не специфицировали параметр dayValue, будет использовано значение, возвращаемое методом getUTCDate.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMonth пытается обновить информацию в Date -объекте. Например, если Вы использовали 15 для monthValue, год будет увеличен на 1 (year + 1), а 3 будет использовано для месяцев.

Примеры

theBigDay = new Date();
theBigDay.setUTCMonth(11);

См. также

setUTCSeconds

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

Синтаксис

setUTCSeconds(secondsValue[, msValue])

Параметры

secondsValue

msValue

Описание

Если Вы не специфицировали параметр msValue, используется значение, возвращаемое методом getUTCMilliseconds.

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCSeconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 100 для secondsValue, минуты, хранимые в Date -объекте, будут увеличены на 1, а 40 будет использовано для секунд.

Примеры

theBigDay = new Date();
theBigDay.setUTCSeconds(20);

См. также

setYear

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

Синтаксис

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)

См. также

toGMTString

Конвертирует дату в строку с использованием соглашений Internet по GMT.

Синтаксис

toGMTString()

Параметры

Отсутствуют.

Описание

toGMTString больше не используется, не рекомендуется к применению и заменён на метод toUTCString.

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

Вы должны использовать Date.toUTCString вместо toGMTSTring.

Примеры

Здесь today это Date -объект:

today.toGMTString()

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

Mon, 18 Dec 1995 17:28:35 GMT

См. также

toLocaleString

Конвертирует дату в строку, используя соглашения данной местности.

Синтаксис

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()

Параметры

Отсутствуют.

Описание

Метод toSource возвращает следующие значения:

• Для встроенного объекта Date метод toSource возвращает следующую строку, указывающую, что исходный код недоступен:

   function Date() {

      [native code]
   }

• Для экземпляров объекта Date метод toSource возвращает строку, представляющую исходный код.

Этот метод обычно вызывается JavaScript внутренне, а не явно в коде.

См. также

toString

Возвращает строку, представляющую специфицированный 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()

Параметры

Отсутствуют.

Описание

Значение, возвращаемое методом toUTCString, является читаемой строкой, сформатированной в соответствии с соглашением UTC. Формат return-значения может варьироваться в зависимости от платформы.

Примеры

var UTCstring;
Today = new Date();
UTCstring = Today.toUTCString();

См. также

UTC

Возвращает количество миллисекунд в 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 двумя позициями:

• Date.UTC использует всемирное время, а не локальное.
• Date.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))

См. также

valueOf

Возвращает примитивное значение объекта 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