|
Объект Date предназначен для
манипуляций с датами и временами. Его примитивным значением является
число, равное количеству миллисекунд относительно базового
времени, равного полуночи 1 января 1970 г. по Гринвичскому
меридиану (UTC, Universal Coordinated Time). Если это значение равно NaN, то
оно считается неопределенным.
День состоит из 86400000 миллисекунд. Диапазон значений Date от
-100000000 дней до 100000000 дней относительно базового времени, что
приблизительно равно 285616 лет в каждую сторону отсчета.
Для создания объектов Date используются следующие конструкторы: new Date()
new Date(число)
new Date(строка)
new Date(год, месяц, день [,часы [,минуты [,секунды [,мс]?]?]?]?)
Здесь:
- число — числовое выражение, задающее примитивное
значение объекта в миллисекундах;
- строка — строковое выражение, задающее дату и время в
формате, описанном в методе parse;
- год — числовое выражение, задающее полный номер года
(например, 1971, а не 71);
- месяц — числовое выражение, задающее номер месяца (0 =
январь, 1 = февраль, …, 11 = декабрь);
- день — числовое выражение, задающее номер для в месяце
от 1 до 31;
- часы — необязательное числовое выражение, задающее
номер часа от 0 до 23;
- минуты — необязательное числовое выражение, задающее
номер минуты от 0 до 59;
- секунды — необязательное числовое выражение, задающее
номер секунды от 0 до 59;
- мс — необязательное числовое выражение, задающее номер
миллисекунды от 0 до 999.
Первый конструктор создает объект Date с текущей датой
и временем по местному времени. Остальные конструкторы создают объект
Date с датой и временем, заданными аргументами
конструктора.
Примеры:
var a = new Date(); // текущие дата и время
var b = new Date("March 06, 1971 01:30 AM"); // заданные дата и время
var c = new Date(1971, 2, 06, 01, 30); // то же самое в другом формате
Свойства объекта Date
| Свойство |
Описание |
Член прототипа |
| constructor |
Конструктор, который создал объект. |
Да |
| prototype |
Ссылка на прототип класса объектов. |
Нет |
Методы объекта Date
| Метод |
Описание |
Член прототипа |
| getDate |
Возвращает день месяца по местному времени. |
Да |
| getDay |
Возвращает день недели по местному времени. |
Да |
| getFullYear |
Возвращает полный номер года по местному времени. |
Да |
| getHours |
Возвращает часы по местному времени. |
Да |
| getMilliseconds |
Возвращает миллисекунды по местному времени. |
Да |
| getMinutes |
Возвращает минуты по местному времени. |
Да |
| getMonth |
Возвращает месяц по местному времени. |
Да |
| getSeconds |
Возвращает секунды по местному времени. |
Да |
| getTime |
Возвращает примитивное значение объекта. |
Да |
| getTimezoneOffset |
Возвращает разницу в минутах между местным временем и UTC. |
Да |
| getUTCDate |
Возвращает день месяца по времени UTC. |
Да |
| getUTCDay |
Возвращает день недели по времени UTC. |
Да |
| getUTCFullYear |
Возвращает полный номер года по времени UTC. |
Да |
| getUTCHours |
Возвращает часы по времени UTC. |
Да |
| getUTCMilliseconds |
Возвращает миллисекунды по времени UTC. |
Да |
| getUTCMinutes |
Возвращает минуты по времени UTC. |
Да |
| getUTCMonth |
Возвращает месяц по времени UTC. |
Да |
| getUTCSeconds |
Возвращает секунды по времени UTC. |
Да |
| getVarDate |
Возвращает примитивное значение объекта в формате VT_DATE. |
Нет |
| getYear |
Возвращает номер года по местному времени. |
Да |
| parse |
Преобразует дату, заданную строкой, в количество миллисекунд
относительно базового времени. |
Нет |
| setDate |
Устанавливает день месяца по местному времени. |
Да |
| setFullYear |
Устанавливает полный номер года по местному времени. |
Да |
| setHours |
Устанавливает часы по местному времени. |
Да |
| setMilliseconds |
Устанавливает миллисекунды по местному времени. |
Да |
| setMinutes |
Устанавливает минуты по местному времени. |
Да |
| setMonth |
Устанавливает месяц по местному времени. |
Да |
| setSeconds |
Устанавливает секунды по местному времени. |
Да |
| setTime |
Устанавливает примитивное значение объекта. |
Да |
| setUTCDate |
Устанавливает день месяца по времени UTC. |
Да |
| setUTCFullYear |
Устанавливает полный номер года по времени UTC. |
Да |
| setUTCHours |
Устанавливает часы по времени UTC. |
Да |
| setUTCMilliseconds |
Устанавливает миллисекунды по времени UTC. |
Да |
| setUTCMinutes |
Устанавливает минуты по времени UTC. |
Да |
| setUTCMonth |
Устанавливает месяц по времени UTC. |
Да |
| setUTCSeconds |
Устанавливает секунды по времени UTC. |
Да |
| setYear |
Устанавливает номер года по местному времени. |
Да |
| toDateString |
Преобразует примитивное значение объекта в строку даты. |
Да |
| toGMTString |
Преобразует примитивное значение объекта в строку даты и времени
по Гринвичскому меридиану. |
Да |
| toLocaleDateString |
Преобразует примитивное значение объекта в строку даты в формате
операционной системы. |
Да |
| toLocaleString |
Преобразует примитивное значение объекта в строку даты и времени
в формате операционной системы. |
Да |
| toLocaleTimeString |
Преобразует примитивное значение объекта в строку времени в
формате операционной системы. |
Да |
| toString |
Преобразует примитивное значение объекта в строку. |
Да |
| toTimeString |
Преобразует примитивное значение объекта в строку времени. |
Да |
| toUTCString |
Преобразует примитивное значение объекта в строку даты и времени
по UTC. |
Да |
| UTC |
Возвращает примитивное значение объекта по времени UTC. |
Нет |
| valueOf |
Возвращает примитивное значение объекта. |
Да |
Синтаксис: дата.getDate()
Результат: числовое значение
Метод getDate преобразует примитивное значение объекта
дата в номер дня месяца по местному времени и возвращает его.
Результатом является целое число в диапазоне от 1 до 31. Например,
сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getDate());
выведет на экран обозревателя число 25.
Синтаксис: дата.getDay()
Результат: числовое значение
Метод getDay преобразует примитивное значение объекта
дата в номер дня недели по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 6:
0 = воскресенье, 1 = понедельник, 2 = вторник, 3 = среда, 4 = четверг,
5 = пятница, 6 = суббота.
Например, сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getDay());
выведет на экран обозревателя число 6
(т. е. рождество в 1999 г. пришлось на субботу).
Синтаксис: дата.getFullYear()
Результат: числовое значение
Метод getFullYear преобразует примитивное значение
объекта дата в полный (четырехзначный) номер года по местному
времени и возвращает его. Например, сценарий
var today = new Date();
document.write(today.getFullYear());
выведет на экран обозревателя число
2000.
Синтаксис: дата.getHours()
Результат: числовое значение
Метод getHours преобразует примитивное значение
объекта дата в номер часа по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 23. Например,
сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getHours());
выведет на экран обозревателя число 23.
Синтаксис: дата.getMilliseconds()
Результат: числовое значение
Метод getMilliseconds преобразует примитивное значение
объекта дата в микросекунды по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 999. Например,
сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMilliseconds());
выведет на экран обозревателя число 0.
Синтаксис: дата.getMinutes()
Результат: числовое значение
Метод getMinutes преобразует примитивное значение
объекта дата в минуты по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 59. Например,
сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMinutes());
выведет на экран обозревателя число 59.
Синтаксис: дата.getMonth()
Результат: числовое значение
Метод getMonth преобразует примитивное значение
объекта дата в номер месяца по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 11: 0 = январь, 1 =
февраль, 2 = март, 3 = апрель, 4 = май, 5 = июнь, 6 = июль, 7 = август, 8
= сентябрь, 9 = октябрь, 10 = ноябрь, 11 = декабрь.
Например, сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMonth());
выведет на экран обозревателя число 11.
Синтаксис: дата.getSeconds()
Результат: числовое значение
Метод getSeconds преобразует примитивное значение
объекта дата в секунды по местному времени и возвращает его.
Результатом является целое число в диапазоне от 0 до 59. Например,
сценарий
var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getSeconds());
выведет на экран обозревателя число 59.
Синтаксис: дата.getTime()
Результат: числовое значение
Метод getTime возвращает примитивное значение объекта
дата. Этот метод полезен для копирования значения одного объекта
Date в другой. Пример:
var d1 = new Date("March 06, 1971");
var d2 = new Date();
d2.SetTime(d1.GetTime()); // теперь значения этих объектов равны
Синтаксис: дата.getTimezoneOffset()
Результат: числовое значение
Метод getTimezoneOffset возвращает разницу в минутах
между временем UTC и местным временем (т. е. временем компьютера, на
котором выполняется сценарий). Из-за переходов на летнее и зимнее время
эта разница в течение года может изменяться. Для перевода местного времени
в UTC следует прибавить к нему полученное значение.
Если, например, следующий сценарий
var today = new Date();
document.write(today.getTimezoneOffset() / 60);
выполняется на компьютере, находящемся в Екатеринбурге,
то он выведет на экран обозревателя число -6. Это означает,
что время в Екатеринбурге на 6 часов больше, чем UTC.
Синтаксис: дата.getUTCDate()
Результат: числовое значение
Метод getUTCDate преобразует примитивное значение
объекта дата в номер дня месяца по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 1 до 31. Например,
сценарий
var today = new Date();
document.write(today.getUTCDate());
выведет на экран обозревателя сегодняшний день
месяца.
Синтаксис: дата.getUTCDay()
Результат: числовое значение
Метод getUTCDay преобразует примитивное значение
объекта дата в номер дня недели по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 0 до 6:
0 = воскресенье, 1 = понедельник, 2 = вторник, 3 = среда, 4 = четверг,
5 = пятница, 6 = суббота.
Например, сценарий
var today = new Date();
document.write(today.getUTCDay());
выведет на экран обозревателя сегодняшний день
недели.
Синтаксис: дата.getUTCFullYear()
Результат: числовое значение
Метод getUTCFullYear преобразует примитивное значение
объекта дата в полный (четырехзначный) номер года по времени UTC
и возвращает его. Например, сценарий
var today = new Date();
document.write(today.getUTCFullYear());
выведет на экран обозревателя номер текущего года.
Синтаксис: дата.getHours()
Результат: числовое значение
Метод getUTCHours преобразует примитивное значение
объекта дата в номер часа по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 0 до 23. Например,
сценарий
var today = new Date();
document.write(today.getUTCHours());
выведет на экран обозревателя текущее количество
часов.
Синтаксис: дата.getUTCMilliseconds()
Результат: числовое значение
Метод getUTCMilliseconds преобразует примитивное
значение объекта дата в микросекунды по времени UTC и возвращает
его. Результатом является целое число в диапазоне от 0 до 999. Например,
сценарий
var today = new Date();
document.write(today.getUTCMilliseconds());
выведет на экран обозревателя текущее количество
миллисекунд.
Синтаксис: дата.getUTCMinutes()
Результат: числовое значение
Метод getUTCMinutes преобразует примитивное значение
объекта дата в минуты по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 0 до 59. Например,
сценарий
var today = new Date();
document.write(today.getUTCMinutes());
выведет на экран обозревателя текущее количество
минут.
Синтаксис: дата.getUTCMonth()
Результат: числовое значение
Метод getUTCMonth преобразует примитивное значение
объекта дата в номер месяца по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 0 до 11: 0 = январь, 1 =
февраль, 2 = март, 3 = апрель, 4 = май, 5 = июнь, 6 = июль, 7 = август, 8
= сентябрь, 9 = октябрь, 10 = ноябрь, 11 = декабрь.
Например, сценарий
var today = new Date();
document.write(today.getUTCMonth());
выведет на экран обозревателя номер текущего месяца.
Синтаксис: дата.getSeconds()
Результат: числовое значение
Метод getUTCSeconds преобразует примитивное значение
объекта дата в секунды по времени UTC и возвращает его.
Результатом является целое число в диапазоне от 0 до 59. Например,
сценарий
var today = new Date();
document.write(today.getUTCSeconds());
выведет на экран обозревателя текущее количество
секунд.
Синтаксис: дата.getVarDate()
Результат: числовое значение
Метод getVarDate преобразует примитивное значение
объекта дата в формат VT_DATE и возвращает его. Результат зависит
от региональных настроек и не используется JavaScript. Поэтому этот метод
предназначен исключительно для взаимодействия с COM-объектами, объектами
ActiveX или с языками, которые используют формат даты VT_DATE (таковы,
например, Visual Basic и VBScript).
Синтаксис: дата.getYear()
Результат: числовое значение Поддержка: Годы 1900-1999 возвращаются как 00-99; все остальные годы
возвращаются четырехзначными числами.
Возвращается номер года минус 1900.
Метод getYear преобразует примитивное значение объекта
дата в номер года по местному времени и возвращает его. Этот
метод является устаревшим и поддерживается только в целях совместимости;
вместо него следует пользоваться методом getFullYear.
Например, сценарий
var today = new Date();
document.write(today.getYear());
выведет на экран Internet Explorer число
2000, а на экран Netscape Navigator число 100.
Синтаксис: Date.parse(строка)
Аргументы: строка — строковое выражение
Результат: числовое значение
Метод parse преобразует дату, заданную
строкой, в количество миллисекунд относительно базового времени, и
возвращает его. Строка: должна содержать дату и время в
определенном формате. Допускаются следующие форматы даты (пробелы и
запятые трактуются как разделители):
"7/20/82" "July 10,
1995" "12-11-76" "10 Jan
2000"
Время может содержать часы, минуты и секунды, разделенные
двоеточием:
"11:" "11:45"
"23:45:12" "11:45:12 PM"
После даты и времени может стоять указатель временной зоны следующего
вида (обе формы эквивалентны и означают на 4 часа 30 минут больше
UTC):
"UTC+0430" "GMT+0430"
Если такого указателя нет, то время считается местным. Перед датой и
временем может стоять название дня недели; если оно не соответствует
заданной дате, то игнорируется.
Это статический метод объекта Date, поэтому для
доступа к нему используется форма Date.parse, а не
объект.parse.
Например, сценарий
var d = new Date();
d.setTime(Date.parse("06 March 1971 01:30"));
document.write(d.toLocaleString());
выведет на экран обозревателя примерно такую строку:
Wednesday, March 06, 1971 01:30:00 (точный вид этой строки
зависит от обозревателя и настроек операционной системы).
Синтаксис: дата.setDate(день)
Аргументы: день — числовое выражение
Результат: нет
Метод setDate изменяет номер дня месяца по
местному времени в объекте дата. День должен быть целым
числом в диапазоне от 1 до 31. Если день превышает количество
дней в данном месяце, то устанавливается день, равный дню минус
количество дней в данном месяце, а номер месяца увеличивается. Если
день отрицателен, то день и месяц изменяются по аналогичным
правилам.
Например, сценарий
var d = new Date("July 27, 1986 19:25:00");
d.setDate(32);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Wednesday,
August 01, 1986 19:25:00.
Синтаксис: дата.setFullYear(год [,месяц [,день]?]?)
Аргументы: год, месяц, день — числовые выражения
Результат: нет
Метод setFullYear изменяет полный (четырехзначный)
номер года по местному времени в объекте дата.
Одновременно он позволяет изменить номер месяца и номер
дня в месяце (ср. методы setMonth
и setDate).
Например, сценарий
var d = new Date("September 26, 2000 09:52:30");
d.setFullYear(1999);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Sunday,
September 26, 1999 09:52:30.
Синтаксис: дата.setHours(часы [,минуты [,секунды [,миллисекунды]?]?]?)
Аргументы: часы, минуты, секунды, миллисекунды — числовые выражения
Результат: нет
Метод setHours задает часы по местному
времени в объекте дата. Часы должны быть целым числом в
диапазоне от 0 до 23. Если часы больше 23, то устанавливается
час, равный часам минус 23, а номер дня увеличивается. Если
часы отрицательны, то час и день изменяются по аналогичным
правилам.
Этот метод позволяет одновременно изменить минуты,
секунды и миллисекунды в объекте дата. Ср.
методы setMinutes,
setSeconds
и setMilliseconds.
Например, сценарий
var d = new Date("July 27, 1986 19:25:00");
d.setHours(25);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Saturday,
July 28, 1986 01:30:00.
Синтаксис: дата.setMilliseconds(миллисекунды)
Аргументы: миллисекунды — числовое выражение
Результат: нет
Метод setMilliseconds задает миллисекунды по
местному времени в объекте дата. Миллисекунды должны
быть целым числом в диапазоне от 0 до 999. Если миллисекунды
больше 999, то устанавливаются миллисекунды, равные миллисекундам
минус 999, а номер секунды увеличивается. Если миллисекунды
отрицательны, то миллисекунды и секунды изменяются по аналогичным
правилам.
Например, сценарий
var d = new Date("January 20, 1999 23:59:59");
d.setMilliseconds(-1000);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Wednesday,
January 20, 1999 23:59:58.
Синтаксис: дата.setMinutes(минуты [,секунды [,миллисекунды]?]?)
Аргументы: минуты, секунды, миллисекунды — числовое выражение
Результат: нет
Метод setMinutes задает минуты по местному
времени в объекте дата. Минуты должны быть целым числом
в диапазоне от 0 до 59. Если минуты больше 59, то устанавливаются
минуты, равные минутам минус 59, а номер часа увеличивается. Если
минуты отрицательны, то минуты и часы изменяются по аналогичным
правилам.
Этот метод позволяет одновременно изменить секунды и
миллисекунды в объекте дата. Ср. методы setSeconds
и setMilliseconds.
Например, сценарий
var d = new Date("January 20, 1999 23:59:59");
d.setMinutes(60);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Thursday,
January 21, 1999 00:00:59.
Синтаксис: дата.setMonth(месяц [,день]?)
Аргументы: месяц, день — числовые выражения
Результат: нет
Метод setMonth задает номер месяца по
местному времени в объекте дата. Месяц должен быть целым
числом в диапазоне от 0 до 11. Если месяц больше 11, то
устанавливается месяц, равный месяцу минус 11, а номер года
увеличивается. Если месяц отрицателен, то месяц и годы изменяются
по аналогичным правилам.
Этот метод позволяет одновременно изменить номер дня в месяце
(ср. метод setDate).
Например, сценарий
var d = new Date("January 20, 1999 23:59:59");
d.setMonth(-1);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Sunday,
December 20, 1998 23:59:59.
Синтаксис: дата.setSeconds(секунды [,миллисекунды]?)
Аргументы: секунды, миллисекунды — числовые выражения
Результат: нет
Метод setSeconds задает секунды по местному
времени в объекте дата. Cекунды должны быть целым числом
в диапазоне от 0 до 59. Если секунды больше 59, то
устанавливаются секунды, равные секундам минус 59, а номер минуты
увеличивается. Если секунды отрицательны, то секунды и минуты
изменяются по аналогичным правилам.
Этот метод позволяет одновременно изменить микросекунды (ср.
метод setMilliseconds).
Например, сценарий
var d = new Date("January 20, 1999 23:59:59");
d.setSeconds(60);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Thursday,
January 21, 1999 00:00:00.
Синтаксис: дата.setTime(значение)
Аргументы: значение — числовое выражение
Результат: числовое значение
Метод setTime устанавливает примитивное значение
объекта дата, равным значению. Заданное
значение объекта не зависит от временной зоны. Этот метод полезен
для копирования значения одного объекта Date в другой.
Пример:
var d1 = new Date("March 06, 1971");
var d2 = new Date();
d2.SetTime(d1.GetTime()); // теперь значения этих объектов равны
Синтаксис: дата.setUTCDate(день)
Аргументы: день — числовое выражение
Результат: нет
Метод setUTCDate изменяет номер дня месяца по
времени UTC в объекте дата. День должен быть целым
числом в диапазоне от 1 до 31. Если день превышает количество
дней в данном месяце, то устанавливается день, равный дню минус
количество дней в данном месяце, а номер месяца увеличивается. Если
день отрицателен, то день и месяц изменяются по аналогичным
правилам. Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCDate(25);
Синтаксис: дата.setUTCFullYear(год [,месяц [,день]?]?)
Аргументы: год, месяц, день — числовые выражения
Результат: нет
Метод setUTCFullYear изменяет полный (четырехзначный)
номер года по времени UTC в объекте дата. Одновременно
он позволяет изменить номер месяца и номер дня в месяце
(ср. методы setUTCMonth
и setUTCDate).
Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCFullYear(1978);
Синтаксис: дата.setUTCHours(часы [,минуты [,секунды [,миллисекунды]?]?]?)
Аргументы: часы, минуты, секунды, миллисекунды — числовые выражения
Результат: нет
Метод setUTCHours задает часы по времени UTC
в объекте дата. Часы должны быть целым числом в
диапазоне от 0 до 23 . Если часы больше 23, то устанавливается
час, равный часам минус 23, а номер дня увеличивается. Если
часы отрицательны, то час и день изменяются по аналогичным
правилам.
Этот метод позволяет одновременно изменить минуты,
секунды и миллисекунды в объекте дата. Ср.
методы setUTCMinutes,
setUTCSeconds
и setUTCMilliseconds.
Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCHours(22);
Синтаксис: дата.setUTCMilliseconds(миллисекунды)
Аргументы: миллисекунды — числовое выражение
Результат: нет
Метод setUTCMilliseconds задает миллисекунды
по времени UTC в объекте дата. Миллисекунды должны быть
целым числом в диапазоне от 0 до 999. Если миллисекунды больше
999, то устанавливаются миллисекунды, равные миллисекундам минус
999, а номер секунды увеличивается. Если миллисекунды
отрицательны, то миллисекунды и секунды изменяются по аналогичным
правилам. Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCMilliseconds(999);
Синтаксис: дата.setUTCMinutes(минуты [,секунды [,миллисекунды]?]?)
Аргументы: минуты, секунды, миллисекунды — числовое выражение
Результат: нет
Метод setUTCMinutes задает минуты по времени
UTC в объекте дата. Минуты должны быть целым числом в
диапазоне от 0 до 59. Если минуты больше 59, то устанавливаются
минуты, равные минутам минус 59, а номер часа увеличивается. Если
минуты отрицательны, то минуты и часы изменяются по аналогичным
правилам.
Этот метод позволяет одновременно изменить секунды и
миллисекунды в объекте дата. Ср. методы setUTCSeconds
и setUTCMilliseconds.
Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCMinutes(31);
Синтаксис: дата.setUTCMonth(месяц [,день]?)
Аргументы: месяц, день — числовые выражения
Результат: нет
Метод setUTCMonth задает номер месяца по
времени UTC в объекте дата. Месяц должен быть целым
числом в диапазоне от 0 до 11. Если месяц больше 11, то
устанавливается месяц, равный месяцу минус 11, а номер года
увеличивается. Если месяц отрицателен, то месяц и годы изменяются
по аналогичным правилам.
Этот метод позволяет одновременно изменить номер дня в месяце
(ср. метод setUTCDate).
Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCMonth(11);
Синтаксис: дата.setUTCSeconds(секунды [,миллисекунды]?)
Аргументы: секунды, миллисекунды — числовые выражения
Результат: нет
Метод setUTCSeconds задает секунды по времени
UTC в объекте дата. Cекунды должны быть целым числом в
диапазоне от 0 до 59. Если секунды больше 59, то устанавливаются
секунды, равные секундам минус 59, а номер минуты увеличивается.
Если секунды отрицательны, то секунды и минуты изменяются по
аналогичным правилам.
Этот метод позволяет одновременно изменить микросекунды (ср.
метод setUTCMilliseconds).
Пример:
var d = new Date("July 27, 1986 19:25:00");
d.setUTCSeconds(59);
Синтаксис: дата.setYear(год)
Аргументы: год — числовое выражение
Результат: нет
Метод setYear устанавливает номер года по местному
времени в объекте дата. Если год лежит в диапазоне от 0
до 99 включительно, то устанавливается номер года, равный 1900 +
год, в остальных случаях устанавливается номер года, равный
году. Этот метод является устаревшим и поддерживается только в
целях совместимости; вместо него следует пользоваться методом setFullYear.
Например, сценарий
var d = new Date("May 1, 2000 23:00:00");
d.setYear(99);
document.write(d.toLocaleString());
выведет на экран обозревателя строку Saturday, May
01, 1999 23:00:00.
Синтаксис: дата.toDateString()
Результат: строковое выражение Поддержка: Поддерживается с версии 5.5.
Не поддерживается.
Метод toDateString преобразует примитивное значение
объекта дата в строку даты по местному времени. Например,
сценарий
var d = new Date();
document.write(d.toDateString());
выведет на экран обозревателя Internet Explorer строку
вида Sun Oct 22 2000.
Синтаксис: дата.toGMTString()
Результат: строковое выражение
Метод toGMTString преобразует примитивное значение
объекта дата в строку даты и времени по Гринвичскому меридиану
(GMT). Этот метод является устаревшим и поддерживается только в целях
совместимости. Вместо него следует пользоваться методом toUTCString.
Формат результирующей строки зависит от обозревателя, например,
сценарий
var d = new Date();
document.write(d.toGMTString());
выведет на экран обозревателя Internet Explorer строку
вида Tue, 19 Sep 2000 10:20:40 UTC, а на экран Netscape
Navigator — строку вида Tue, 19 Sep 2000 10:20:40
GMT.
Синтаксис: дата.toLocaleDateString()
Результат: строковое выражение Поддержка: Поддерживается с версии 5.5.
Не поддерживается.
Метод toLocaleDateString преобразует примитивное
значение объекта дата в строку даты по местному времени с учетом
локальных установок операционной системы. Формат результирующей строки
зависит от локализации операционной системы и обозревателя, например,
сценарий
var d = new Date();
document.write(d.toLocaleDateString());
в русифицированной версии Windows выведет на экран
обозревателя Internet Explorer строку вида 19 сентября 2000
г.
Синтаксис: дата.toLocaleString()
Результат: строковое выражение
Метод toLocaleString преобразует примитивное значение
объекта дата в строку даты и времени по местному времени с учетом
локальных установок операционной системы. Формат результирующей строки
зависит от локализации операционной системы и обозревателя, например,
сценарий
var d = new Date();
document.write(d.toLocaleString());
в русифицированной версии Windows может вывести на экран
обозревателя Internet Explorer строку вида 19 сентября 2000 г.
11:24:24, а на экран Netscape Navigator — строку вида
Tuesday, September 19, 2000 11:24:24.
Синтаксис: дата.toLocaleTimeString()
Результат: строковое выражение Поддержка: Поддерживается с версии 5.5.
Не поддерживается.
Метод toLocaleTimeString преобразует примитивное
значение объекта дата в строку времени по местному времени с
учетом локальных установок операционной системы. Формат результирующей
строки зависит от локализации операционной системы и обозревателя,
например, сценарий
var d = new Date();
document.write(d.toLocaleTimeString());
в русифицированной версии Windows выведет на экран
обозревателя Internet Explorer строку вида 11:24:24.
Синтаксис: дата.toTimeString()
Результат: строковое выражение Поддержка: Поддерживается с версии 5.5.
Не поддерживается.
Метод toTimeString преобразует примитивное значение
объекта дата в строку времени по местному времени. Например,
сценарий
var d = new Date();
document.write(d.toTimeString());
выведет на экран обозревателя Internet Explorer строку
вида 13:05:09 UTC+0500.
Синтаксис: дата.toString()
Результат: строковое выражение
Метод toString преобразует примитивное значение
объекта дата в строку даты и времени по местному времени. Формат
результирующей строки зависит от обозревателя, например, сценарий
var d = new Date();
document.write(d.toString());
может вывести на экран обозревателя Internet Explorer
строку вида Tue Sep 19 11:12:13 UTC-0700 2000 , а на экран
Netscape Navigator — строку вида Tue Sep 19 11:12:13 GMT-0700
(Pacific Daylight Time) 2000.
Синтаксис: дата.toUTCString()
Результат: строковое выражение
Метод toUTCString преобразует примитивное значение
объекта дата в строку даты и времени по времени UTC. Формат
результирующей строки зависит от обозревателя, например, сценарий
var d = new Date();
document.write(d.toUTCString());
выведет на экран обозревателя Internet Explorer строку
вида Tue, 26 Sep 2000 10:20:40 UTC, а на экран Netscape
Navigator — строку вида Tue, 26 Sep 2000 10:20:40
GMT.
Синтаксис: Date.UTC(год, месяц, день [,часы [,минуты [,секунды [,мс]?]?]?]?)
Аргументы: год, месяц, день, часы, минуты, секунды, мс — числовые выражения
Результат: числовое значение
Метод UTC преобразует заданные дату и время в
примитивное значение объекта Date по времени UTC и
возвращает его. Аргументы имеют следующие значения:
- год — выражение, задающее полный номер года (например,
1971, а не 71);
- месяц — выражение, задающее номер месяца (0 = январь,
1 = февраль, …, 11 = декабрь);
- день — выражение, задающее номер для в месяце от 1 до
31;
- часы — необязательное выражение, задающее номер часа
от 0 до 23;
- минуты — необязательное выражение, задающее номер
минуты от 0 до 59;
- секунды — необязательное выражение, задающее номер
секунды от 0 до 59;
- мс — необязательное выражение, задающее номер
миллисекунды от 0 до 999.
Это статический метод объекта Date, поэтому для
доступа к нему используется форма Date.UTC, а не
объект.UTC. Он полностью аналогичен конструктору
Date с единственным отличием: полученное примитивное
значение вычисляется по времени UTC, а не по местному времени.
Этот метод полезен для присваивания значения объектам
Date. Например, следующий сценарий
var x = Date.UTC(2001, 2, 18, 11, 15, 30);
var d = new Date(x);
document.write(d.toUTCString());
выведет на экран обозревателя строку Sun, 18 Mar
2001 11:15:30 UTC.
Синтаксис: дата.valueOf()
Результат: числовое значение
Метод valueOf возвращает примитивное значение объекта
дата. Иными словами, этот метод возвращает тот же результат, что
и метод getTime.
|