Прикладной код

Дата

Дата

Создает экземпляр объекта Date, представляющего собой момент времени.

Синтаксис

Объект = new Date()
Объект = new Date(Значение)
Объект = new Date(year, month, date[, hours, minutes, seconds, ms])

Параметры

  • Значение — принимает числовое или строковое значение.
    • Числовой параметр выражен количеством миллисекунд, прошедших с 1 января 1970 00:00:00 по UTC;
    • Строковый параметр - это дата по стандартным правилам (RFC 2822 или ISO 8601).
  • year — год в формате ГГГГ.
  • month — месяц от 0 (Янв) до 11 (Дек).
  • date — необязательный параметр. Целое значение, день месяца от 1 до 31.
  • hours — необязательный параметр, устанавливает количество часов от 0 до 23. Указывается, если указан параметр minutes.
  • minutes — необязательный параметр, устанавливает количество минут от 0 до 59. Указывается, если указан параметр second.
  • second — необязательный параметр, устанавливает количество секунд от 0 до 59. Указывается, если указан параметр ms.
  • ms — необязательный параметр, устанавливает количество миллисекунд от 0 до 999.

Описание

  • Если никаких аргументов не передано, конструктор создает объект Date для текущих даты и времени, согласно системным настройкам.
  • Если передано два и более аргументов, то отсутствующие аргументы устанавливаются либо в 1 (если пропущен день), либо в 0 (все остальные значения).
  • Дата в JavaScript измеряется в миллисекундах, прошедших с полуночи 1 января 1970 года по UTC. День содержит 86 400 000 миллисекунд. Объект Date имеет диапазон дат от -100 000 000 до 100 000 000 дней относительно 1 января 1970 года по UTC.

Объект Date обеспечивает универсальное поведение на всех платформах.

Date поддерживает и методы для работы в зоне UTC (GMT+0) и методы работы с местным временем. UTC (среднее время по Гринвичу) ссылается на время, установленное Всемирным стандартном времени. Местное время - это системное время компьютера, на котором выполняется JavaScript.

Вызов объекта Date без использования оператора new вернет строку с текущей датой и временем.

Методы

  • — разбирает строковое представление даты и возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC;
  • — возвращает строку с языко-зависимым представлением даты;
  • — возвращает день месяца указанной даты по местному времени;
  • — возвращает порядковый номер дня недели указанной даты по местному времени;
  • — возвращает год указанной даты по местному времени;
  • — возвращает миллисекунды указанной даты по местному времени;
  • — возвращает минуты указанной даты по местному времени;
  • — возвращает секунды указанной даты по местному времени;
  • — возвращает часы указанной даты по местному времени;
  • — возвращает месяц указанной даты по местному времени;
  • — возвращает числовое значение, соответствующее указанной дате по всемирному координированному времени;
  • — возвращает примитивное значение объекта Date;
  • — создает экземпляр объекта Date, представляющего собой момент времени.

Комментарии

Объекты Date могут быть созданы только через вызов функции Date в качестве конструктора. Обычный вызов функции (без использования оператора new) вернет строку, вместо объекта Date. В отличие от других объектных типов JavaScript, Date не имеет литерального синтаксиса.

Если функция Date вызывается в качестве конструктора несколькими аргументами, то значения, которые больше логического диапазона (например номер месяца 15 или количество дней 43), перейдут в соседние значения. Например, вызов new Date (2013, 13, 1) и new Date (2014, 1, 1) создадут одинаковую дату 2014—02—01.

Если функция Date вызвана как конструктор с несколькими аргументами, то указаные аргументы интерпретируются как локальное время. Если нужно указать время в UTC, используйте конструкцию new Date(Date.UTC(...)) с теми же аргументами.

Примеры

Получение текущей даты.

Создание объекта Date разными способами.

var today = new Date();
var birthday = new Date('December 17, 1995 03:24:00');
var birthday = new Date('1995-12-17T03:24:00');
var birthday = new Date(1995, 11, 17);
var birthday = new Date(1995, 11, 17, 3, 24, 0);

Вычисление затраченного времени.

// Используя объекты Date
var start = Date.now();

// Событие, для которого замеряется время, происходит тут:
doSomethingForALongTime();
var end = Date.now();
var elapsed = end - start; // затраченное время в миллисекундах
// Используя встроенные методы
var start = new Date();

// Событие, для которого замеряется время, происходит тут:
doSomethingForALongTime();
var end = new Date();
var elapsed = end.getTime() - start.getTime(); // затраченное время в миллисекундах
// Проверяет функцию и возвращает её возвращаемое значение
function printElapsedTime(fTest) {
 var nStartTime = Date.now(),
  vReturn = fTest(),
  nEndTime = Date.now();

 console.log('Затраченное время: ' + String(nEndTime - nStartTime) + ' миллисекунд');
 return vReturn;
}

yourFunctionReturn = printElapsedTime(yourFunction);