На главную страницу
Форум txt.version   




Статья :: Date
Оглавление | Назад | Вперёд | Индекс

Date

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

Объект ядра

Реализовано в

JavaScript 1.0, NES 2.0

JavaScript 1.1: добавлено свойство prototype.

JavaScript 1.3: удалена зависимость от платформы; добавлен параметр ms_num в конструктор Date; добавлены методы getFullYear, setFullYear, getMilliseconds, setMilliseconds, toSource и UTC-методы (такие как getUTCDate и setUTCDate).

Версия ECMA

ECMA-262

Создание

Конструктор 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

Целочисленное значение - количество миллисекунд после даты 1 января 1970 года, 00:00:00.

dateString

Строковое значение - дата. Строка должна иметь формат, распознаваемый методом Date.parse.

yr_num, mo_num,
day_num

Целочисленные значения, представляющие части даты. Месяц это числа от 0 до 11, 0=January, 11=December.

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

Позволяет добавлять свойства к  Date -объекту.

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

Метод Описание
getDate

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

getDay

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

getFullYear

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

getHours

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

getMilliseconds

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

getMinutes

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

getMonth

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

getSeconds

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

getTime

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

getTimezoneOffset

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

getUTCDate

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

getUTCDay

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

getUTCFullYear

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

getUTCHours

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

getUTCMilliseconds

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

getUTCMinutes

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

getUTCMonth

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

getUTCSeconds

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

getYear

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

parse

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

setDate

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

setFullYear

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

setHours

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

setMilliseconds

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

setMinutes

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

setMonth

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

setSeconds

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

setTime

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

setUTCDate

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

setUTCFullYear

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

setUTCHours

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

setUTCMilliseconds

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

setUTCMinutes

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

setUTCMonth

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

setUTCSeconds

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


setYear

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


toGMTString

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

toLocaleString

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

toSource

Возвращает литерал объекта, представляющий специфицированный Date -объект; Вы можете использовать это значение для создания нового объекта. Переопределяет метод Object.toSource.

toString

Возвращает строку, представляющую специфицированный Date -объект. Переопределяет метод Object.toString.

toUTCString

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


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)

constructor


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

Свойство из

Date

Реализовано в

JavaScript 1.1, NES 2.0

Версия ECMA

ECMA-262

Описание

См. Object.constructor.

getDate


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

getDate()

Параметры

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

Описание

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


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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

См. также

Date.getUTCDay, Date.setDate

getFullYear


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getFullYear()

Параметры

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

Описание

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

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

Пример

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

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

См. также

Date.getYear, Date.getUTCFullYear , Date.setFullYear

getHours


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getMilliseconds()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getUTCMilliseconds, Date.setMilliseconds

getMinutes


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

getTimezoneOffset()

Параметры

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

Описание

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

Пример

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

getUTCDate


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCDate()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getDate, Date.getUTCDay , Date.setUTCDate

getUTCDay


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCDay()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getDay, Date.getUTCDate, Date.setUTCDate

getUTCFullYear


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCFullYear()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getFullYear, Date.setFullYear

getUTCHours


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCHours()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getHours, Date.setUTCHours

getUTCMilliseconds


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCMilliSeconds()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getMilliseconds, Date.setUTCMilliseconds

getUTCMinutes


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCMinutes()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getMinutes, Date.setUTCMinutes

getUTCMonth


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCMonth()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getMonth, Date.setUTCMonth

getUTCSeconds


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

getUTCSeconds()

Параметры

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

Описание

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

Пример

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

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

См. также

Date.getSeconds, Date.setUTCSeconds

getYear


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: не рекомендуется применять; getYear возвращает год минус 1900, независимо от специфицированного года.

Версия ECMA

ECMA-262

Синтаксис

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

См. также

Date.getFullYear, Date.getUTCFullYear, Date.setYear

parse


Возвращает количество миллисекунд в строке даты, прошедших после 2 января 1970, 00:00:00, местного времени.

Метод из

Date

Static

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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

См. также

Date.UTC

prototype


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

Свойство из

Date

Реализовано в

JavaScript 1.1, NES 2.0

Версия ECMA

ECMA-262

setDate


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

setDate(dayValue)

Параметр

dayValue

Целое число от 1 до 31 - день/число месяца.

Пример

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

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

См. также

Date.getDate, Date.setUTCDate

setFullYear


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setFullYear(yearValue[, monthValue, dayValue])

Параметры

yearValue

Целое число - год, например, 1995.

monthValue

Целое число от 0 до 11 - месяц от January до December.

dayValue

Целое число от 1 до 31 день/число месяца. Если Вы специфицируете параметр dayValue, Вы обязаны также специфицировать и monthValue.

Описание

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

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

Пример

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

См. также

Date.getUTCFullYear,Date.setUTCFullYear, Date.setYear

setHours


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлены параметры minutesValue, secondsValue и msValue.

Версия ECMA

ECMA-262

Синтаксис

setHours(hoursValue[, minutesValue, secondsValue, msValue])
Версии до JavaScript 1.3:
setHours(hoursValue)

Параметры

hoursValue

Целое число от 0 до 23 - час.

minutesValue

Целое число от 0 до 59 - минуты.

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)

См. также

Date.getHours, Date.setUTCHours

setMilliseconds


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setMilliseconds(millisecondsValue)

Параметры

millisecondsValue

Число от 0 до 999 - миллисекунды.

Описание

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

Пример

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

См. также

Date.getMilliseconds, Date.setUTCMilliseconds

setMinutes


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлены параметры secondsValue  msValue.

Версия ECMA

ECMA-262

Синтаксис

setMinutes(minutesValue[, secondsValue, msValue])
Версии до JavaScript 1.3:
setMinutes(minutesValue)

Параметры

minutesValue

Целое число от 0 до 59 - минуты.

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 будет использовано для секунд.

См. также

Date.getMinutes, Date.setUTCMilliseconds

setMonth


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлен параметр dayValue.

Версия ECMA

ECMA-262

Синтаксис

setMonth(monthValue[, dayValue])
Версии до JavaScript 1.3:
setMonth(monthValue)

Параметры

monthValue

Целое число от 0 до 11 (месяцы с January до December).

dayValue

Целое число от 1 до 31 - день/число месяца.

Описание

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

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

Примеры

theBigDay.setMonth(6)

См. также

Date.getMonth, Date.setUTCMonth

setSeconds


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлен параметр msValue.

Версия ECMA

ECMA-262

Синтаксис

setSeconds(secondsValue[, msValue])
Версии до JavaScript 1.3:
setSeconds(secondsValue)

Параметры

secondsValue

Целое от 0 до 59.

msValue

Число от 0 до 999 - миллисекунды.

Описание

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

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

Примеры

theBigDay.setSeconds(30)

См. также

Date.getSeconds, Date.setUTCSeconds

setTime


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCDate(dayValue)

Параметр

dayValue

Целое число от 1 до 31 - день/число месяца.

Описание

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

Примеры

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

См. также

Date.getUTCDate, Date.setDate

setUTCFullYear


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCFullYear(yearValue[, monthValue, dayValue])

Параметры

yearValue

Целое число, специфицирующее числовое значение года, например, 1995.

monthValue

Целое число от 0 до 11 - месяцы от January до December.

dayValue

Целое число от 1 до 31 день/число месяца. Если Вы специфицировали параметр dayValue, Вы обязаны также специфицировать monthValue.

Описание

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

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

Примеры

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

См. также

Date.getUTCFullYear, Date.setFullYear

setUTCHours


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

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

Параметры

hoursValue

Целое число от 0 до 23 - час.

minutesValue

Целое число от 0 до 59 - минуты.

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

См. также

Date.getUTCHours, Date.setHours

setUTCMilliseconds


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCMilliseconds(millisecondsValue)

Параметр

millisecondsValue

Число от 0 до 999, представляющее миллисекунды.

Описание

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

Примеры

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

См. также

Date.getUTCMilliseconds, Date.setMilliseconds

setUTCMinutes


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCMinutes(minutesValue[, secondsValue, msValue])

Параметры

minutesValue

Целое число от 0 до 59 - минуты.

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

См. также

Date.getUTCMinutes, Date.setMinutes

setUTCMonth


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCMonth(monthValue[, dayValue])

Параметры

monthValue

Целое число от 0 до 11 - месяц от January до December.

dayValue

Целое число от 1 до 31 - день/число месяца.

Описание

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

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

Примеры

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

См. также

Date.getUTCMonth, Date.setMonth

setUTCSeconds


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

setUTCSeconds(secondsValue[, msValue])

Параметры

secondsValue

Целое число от 0 до 59.

msValue

Число от 0 до 999 - миллисекунды.

Описание

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

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

Примеры

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

См. также

Date.getUTCSeconds, Date.setSeconds

setYear


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Не рекомендуется использовать в JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

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)

См. также

Date.getYear, Date.setFullYear, Date.setUTCFullYear

toGMTString


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Не рекомендуется использовать в JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

toGMTString()

Параметры

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

Описание

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

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

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

Примеры

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

today.toGMTString()

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

Mon, 18 Dec 1995 17:28:35 GMT

См. также

Date.toLocaleString, Date.toUTCString

toLocaleString


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

Метод из

Date

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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

См. также

Date.toGMTString, Date.toUTCString

toSource


Возвращает строку, представляющую исходный код объекта.

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

toSource()

Параметры

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

Описание

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

  • Для встроенного объекта Date метод toSource возвращает следующую строку, указывающую, что исходный код недоступен:
  •    function Date() {
          [native code]
       }
  • Для экземпляров объекта Date метод toSource возвращает строку, представляющую исходный код.

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

См. также

Object.toSource

toString


Возвращает строку, представляющую специфицированный Date -объект.

Метод из

Date

Реализован в

JavaScript 1.1, NES 2.0

Версия ECMA

ECMA-262

Синтаксис

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

См. также

Object.toString

toUTCString


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

Метод из

Date

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис

toUTCString()

Параметры

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

Описание

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

Примеры

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

См. также

Date.toLocaleString, Date.toUTCString

UTC


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

Метод из

Date

Static

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлен параметр ms.

Версия ECMA

ECMA-262

Синтаксис

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

Параметры

year

Год после 1900.

month

Целое число от 0 до 11 - месяц.

date

Целое число от 1 до 31 - день/число месяца.

hrs

Целое число от 0 до 23 - час.

min

Целое число от 0 до 59 - минуты.

sec

Целое число от 0 до 59 - секунды.

ms

Целое число от 0 до 999 - миллисекунды.

Описание

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

См. также

Date.parse

valueOf


Возвращает примитивное значение объекта Date.

Метод из

Date

Реализован в

JavaScript 1.1

Версия ECMA

ECMA-262

Синтаксис

valueOf()

Параметры

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

Описание

Метод valueOf объекта Date возвращает примитивное значение объекта Date как тип данных number (число), количество миллисекунд, прошедших после полуночи 01 января 1970 года по UTC.

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

Примеры

x = new Date(56,6,17);
myVar=x.valueOf()      //присваивает -424713600000 переменной myVar

См. также

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

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation

Date

страницы в данном разделе 
 ancor  applet
 area.htm  array
 Индекс  Boolean
 button  Checkbox
 Классы, Конструкторы и Методы Java  Значения Цветов
 Оглавление  Куки Netscape
 date.htm  document
 event  FileUpload
 form.htm  Frame
 Function  Обработчики Событий
 Hidden  History
 Image  Оглавление
 java.htm  JavaArray
 JavaClass  JavaObject
 JavaPackage  Приложение A. Зарезервированные Слова
 Layer  JSException
 JSObject  Plugin
 link.htm  Location
 math.htm  MimeType
 navigator  netscape
 Number  Object
 Объекты, Методы и Свойства  Операции
 Option  Packages
 Приложения  Справочник по Классам LiveConnect
 Элементы Языка  Объекты. Справочник.
 Password  Plugin
 Об Этой Книге  Radio
 RegExp  Reset
 screen  Select
 Операторы  String
 Style  Submit
 sun.htm  text.htm
 Textarea  toc.htm
 Свойства и Функции Верхнего Уровня  Новые Возможности в Этой Версии
 window   


Разделы
Околокомпьютерная литература (375)
Программирование (102)
Программы (75)
ОС и Сети (49)
Интернет (29)
Аппаратное обеспечение (16)
Базы данных (6)

Содержание сайта (выборка)
Apache
Протоколы TCP/IP (принципы, протоколы и архитектура)

PHP, PELR, JSP
PHP
JavaServer Pages (JSP)

Базы данных
Основы mysql
СУБД INFORMIX
СУБД POSTGRES
Основы проектирования реляционных баз данных

HTML, javascript
Спецификация HTML 4.01
Каскадные Таблицы Стилей, Уровень 2
Клиентский JavaScript. Справочник.
JavaScript руководство пользователя
Серверный JavaScript 1.4. Руководство по Использованию.

Паскаль, C, C++, C#
GCC (примеры)
FAQ Валентинa Озеровa DELPHI
C





 
©  programming-lang.com  справочник программиста