JavaScript. Подробное руководство, 6-е издание

  setYear

Устанавливает поле года объекта Date. Признан устаревшим, вместо него рекомендуется использовать setFullYear.

  toDateString

Возвращает строку, представляющую дату из Date для локального часового пояса.

  toGMTString

Преобразует Date в строку, беря за основу часовой пояс GMT. Признан устаревшим, вместо него рекомендован метод toUTCString.

  toISOString

Преобразует Date в строку, используя стандарт ISO-8601, объединяющий формат представления даты/времени и UTC.

  toJSON

Сериализует объект Date в формат JSON с помощью методаtoISOString.

  toLocaleDateString

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

  toLocaleString

Преобразует Date в строку в соответствии с локальным часовым поясом и локальными соглашениями о форматировании дат.

  toLocaleTimeString

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

  toString

Преобразует Date в строку в соответствии с локальным часовым поясом.

  toTimeString

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

  toUTCString

Преобразует Date в строку, используя универсальное время.

  valueOf

Преобразует объект Date в его внутренний миллисекундный формат.

Статические методы

В дополнение к перечисленным методам экземпляра в объекте Date определены два статических метода. Эти методы вызываются через сам конструктор Date, а не через отдельные объекты Date:

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

Date.parse Анализирует строковое представление даты и времени и возвращает внутреннее представление этой даты в миллисекундах.

Date.UTC Возвращает представление указанной даты и времени UTC в миллисекундах.

Описание

Объект Date– это тип данных, встроенный в язык JavaScript. Объекты Date создаются с помощью представленного ранее синтаксиса new Date.

После создания объекта Date можно воспользоваться его многочисленными методами. Многие из методов позволяют получать и устанавливать поля года, месяца, дня, часа, минуты, секунды и миллисекунды в соответствии либо с локальным временем, либо с временем UTC (универсальным, или GMT). Метод toString и его варианты преобразуют даты в понятные для восприятия строки. getTime и setTime преобразуют количество миллисекунд, прошедших с полуночи (GMT) 1 января 1970 года, во внутреннее представление объекта Date и обратно. В этом стандартном миллисекундном формате дата и время представляются одним целым, что делает дату очень простой арифметически. Стандарт ECMAScript требует, чтобы объект Date мог представить любые дату и время с миллисекундной точностью в пределах 100 миллионов дней до и после 01.01.1970. Этот диапазон равен ±273 785 лет, поэтому JavaScript-часы будут правильно работать до 275 755 года.

Пример

Известно множество методов, позволяющих работать с созданным объектом Date:

  d = new Date; // Получает текущую дату и время
  document.write('Сегодня: "+d.toLocaleDateString + '. ');// Показывает дату
  document.write('Время: '+ d.toLocaleTimeString); // Показывает время
  var dayOfWeek = d.getDay; // День недели
  var weekend = (dayOfWeek == 0) || (dayOfWeek == 6); // Сегодня выходной?

Еще одно типичное применение объекта Date– это вычитание миллисекундного представления текущего времени из другого времени для определения относительного местоположения двух временных меток. Следующий пример клиентского кода показывает два таких применения:

  <script language="JavaScript">
  today = new Date; // Запомнить сегодняшнюю дату
  Christmas = new Date; // Получить дату из текущего года
  Christmas.setMonth(11); // Установить месяц декабрь...
  Christmas.setDate(25); // и 25-е число

  // Если Рождество еще не прошло, вычислить количество миллисекунд между текущим моментом
  // и Рождеством, преобразовать его в количество дней и вывести сообщение
  if (today.getTime < Christmas.getTime) {
   difference = Christmas.getTime - today.getTime;
   difference = Math.floor(difference / (1000 * 60 * 60 * 24));
   document.write('Всего ' + difference + ' дней до Рождества!');
  }
  </script>
  // ... остальная часть HTML-документа ...
  <script language="JavaScript">
  // Здесь мы используем объекты Date для измерения времени
  // Делим на 1000 для преобразования миллисекунд в секунды
  now = new Date;
  document.write('<р>Страница загружалась' +