Содержание (скрыть) Содержание (показать)

Вы здесь

Дата и Время

  1. Создание
  2. Получение компонентов даты
  3. Установка компонентов даты
    1. Автоисправление даты
    2. Преобразование к числу, разность дат
    3. Бенчмаркинг
  4. Форматирование
    1. Разбор строки, Date.parse
  5. Итого

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

Создание

Для создания нового объекта типа Date используется один из синтаксисов:

new Date()
Создает объект Date с текущей датой и временем:
var now = new Date();
alert(now);
new Date(milliseconds)
Создает объект Date, значение которого равно количеству миллисекунд (1/1000 секунды), прошедших с 1 января 1970 года GMT+0.
// 24 часа после 01.01.1970 GMT+0
var Jan02_1970 = new Date(3600*24*1000);
alert( Jan02_1970 );
new Date(datestring)
Если единственный аргумент - строка, используется вызов Date.parse для ее разбора.
new Date(year, month, date, hours, minutes, seconds, ms)
Дату можно создать, используя компоненты в местной временной зоне. Для этого формата обязательны только первые два аргумента. Отсутствующие параметры, начиная с hours считаются равными нулю, а date — единице.

Заметим, что год year должен быть из 4 цифр, а отсчет месяцев month начинается с нуля 0. Например:

new Date(2011, 0, 1) // 1 января 2011, 00:00:00 в местной временной зоне
new Date(2011, 0) // то же самое, date по умолчанию равно 1
new Date(2011, 0, 1, 0, 0, 0, 0); // то же самое

Дата задана с точностью до миллисекунд:

var d = new Date(2011, 0, 1, 2, 3, 4, 567); 
alert(d); // 1.01.2011, 02:03:04.567

Важность: 5

Создайте объект Date для даты: 20 февраля 2012 года, 3 часа 12 минут.

Временная зона — местная. Выведите его на экран.

Решение
Решение

Дата в местной временной зоне создается при помощи new Date.

Месяцы начинаются с нуля, так что февраль имеет номер 1. Параметры можно указывать с точностью до минут:

var d = new Date(2012, 1, 20, 3, 12);
alert(d);

Получение компонентов даты

Для доступа к компонентам даты-времени объекта Date используются следующие методы:

getFullYear()
Получить год(из 4 цифр)
getMonth()
Получить месяц, от 0 до 11.
getDate()
Получить число месяца, от 1 до 31.
getHours(), getMinutes(), getSeconds(), getMilliseconds()
Получить соответствующие компоненты.

Устаревший getYear()

Некоторые браузеры реализуют нестандартный метод getYear(). Где-то он возвращает только две цифры из года, где-то четыре. Так или иначе, этот метод отсутствует в стандарте JavaScript. Не используйте его. Для получения года есть getFullYear().

Дополнительно можно получить день недели:

getDay()
Получить номер дня в неделе. Неделя в JavaScript начинается с воскресенья, так что результат будет числом от 0(воскресенье) до 6(суббота).

Все методы, указанные выше, возвращают результат для местной временной зоны.

Существуют также UTC-варианты этих методов, возвращающие день, месяц, год и т.п. для зоны GMT+0 (UTC): getUTCFullYear(), getUTCMonth(), getUTCDay(). То есть, сразу после "get" вставляется "UTC".

Если ваше локальное время сдвинуто относительно UTC, то следующий код покажет разные часы:

var date = new Date();

alert( date.getHours() ); // час в вашей зоне для даты date
alert( date.getUTCHours() ); // час в зоне GMT+0 для даты date

Кроме описанных выше, существуют два специальных метода без UTC-варианта:

getTime()
Возвращает число миллисекунд, прошедших с 01.01.1970 00:00:00 UTC. Это то же число, которое используется в конструкторе new Date(milliseconds).
getTimezoneOffset()
Возвращает разницу между местным и UTC-временем, в минутах.

alert( new Date().getTimezoneOffset() );  // Для GMT-1 выведет 60

Важность: 5

Создайте функцию getWeekDay(date), которая выводит текущий день недели в коротком формате ‘пн’, ‘вт’, … ‘вс’.

Например:

var date = new Date(2012,0,3);  // 3 января 2012 
alert( getWeekDay(date) );      // Должно вывести 'вт'

Решение
Решение

Метод getDay() позволяет получить номер дня недели, начиная с воскресенья.

Запишем имена дней недели в массив, чтобы можно было их достать по номеру:

function getWeekDay(date) {
  var days = ['вс','пн','вт','ср','чт','пт','сб'] ;

  return days[ date.getDay() ];
}

var date = new Date(2012,0,3);  // 3 января 2012
alert( getWeekDay(date) );      // 'вт'

Важность: 5

Напишите функцию, getLocalDay(date) которая возвращает день недели для даты date.

День нужно возвратить в европейской нумерации, т.е. понедельник имеет номер 1, вторник номер 2, …, воскресенье - номер 7.

var date = new Date(2012, 0, 3);  // 3 янв 2012 
alert( getLocalDay(date) );      // вторник, выведет 2

Решение
Решение

Решение - в использовании встроенной функции getDay. Она полностью подходит нашим целям, но для воскресенья возвращает 0 вместо 7:

function getLocalDay(date) {

  var day = date.getDay();

  if ( day == 0 ) { // день 0 становится 7
    day = 7; 
  }
  
  return day;
}

alert( getLocalDay(new Date(2012,0,3)) );  // 2

Если удобнее, чтобы день недели начинался с нуля, то можно возвращать в функции day - 1, тогда дни будут от 0 (пн) до 6(вс).

Установка компонентов даты

Следующие методы позволяют устанавливать компоненты даты и времени:

  • setFullYear(year [, month, date])
  • setMonth(month [, date])
  • setDate(date)
  • setHours(hour [, min, sec, ms])
  • setMinutes(min [, sec, ms])
  • setSeconds(sec [, ms])
  • setMilliseconds(ms)
  • setTime(milliseconds) (устанавливает всю дату по миллисекундам с 01.01.1970 UTC)

Все они, кроме setTime(), обладают также UTC-вариантом, например: setUTCHours().

Как видно, некоторые методы могут устанавливать несколько компонентов даты одновременно, в частности, setHours. При этом если какая-то компонента не указана, она не меняется. Например:

var today = new Date;

today.setHours(0); 
alert( today ); // сегодня, но час изменён на 0

today.setHours(0, 0, 0, 0); 
alert (today ); // сегодня, ровно 00:00:00.

Автоисправление даты

Автоисправление — очень удобное свойство объектов Date. Оно заключается в том, что можно устанавливать заведомо некорректные компоненты (например 32 января), а объект сам себя поправит.

var d = new Date(2013, 0, *!*32*/!*); // 32 января 2013 ?!?
alert(d); // ... это 1 февраля 2013!

Неправильные компоненты даты автоматически распределяются по остальным.

Например, нужно увеличить на 2 дня дату «28 февраля 2011». Может быть так, что это будет 2 марта, а может быть и 1 марта, если год високосный. Но нам обо всем этом думать не нужно. Просто прибавляем два дня. Остальное сделает Date:

var d = new Date(2011, 1, 28);
*!*
d.setDate( d.getDate() + 2 );
*/!*

alert(d); // 2 марта, 2011

Также это используют для получения даты, отдаленной от имеющейся на нужный промежуток времени. Например, получим дату на 70 секунд большую текущей:

var d = new Date();
d.setSeconds( d.getSeconds()+70);

alert(d); // выведет корректную дату

Можно установить и нулевые, и даже отрицательные компоненты. Например:

var d = new Date;

d.setDate(1); // поставить первое число месяца
alert(d);

d.setDate(0); // нулевого числа нет, будет последнее число предыдущего месяца
alert(d);

var d = new Date;

d.setDate(-1); // предпоследнее число предыдущего месяца
alert(d);

Важность: 4

Какое число месяца было 100 дней назад? Какой день недели?

Используйте JavaScript, чтобы вывести эту информацию. День недели выводите двухбуквенном виде, т.е. одно значение из (пн, вт, ср, …,вс).

Решение
Решение

Создадим текущую дату и вычтем 100 дней:

var d = new Date;
d.setDate( d.getDate() - 100 );

alert( d.getDate() ); 

var dayNames = ['вс','пн','вт','ср','чт','пт','сб'];
alert( dayNames[d.getDay()] );

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

Обратите внимание на массив с именами дней недели. «Нулевой» день — воскресенье.

Важность: 5

Напишите функцию getLastDayInMonth(year, month), которая возвращает последний день месяца.

Параметры:

  • year — 4-значный год, например 2012.
  • month — месяц от 0 до 11.

Например, getLastDayInMonth(2012, 1) = 29 (високосный год, февраль).

Решение
Решение

Создадим дату из следующего месяца, но день не первый, а «нулевой» (т.е. предыдущий):

function getLastDayOfMonth(year, month) {
  var date = new Date(year, month+1, 0);
  return date.getDate();
}

alert( getLastDayOfMonth(2012, 1) ); // 29

Преобразование к числу, разность дат

Когда объект Date используется в числовом контексте, он преобразуется в количество миллисекунд:

alert( +new Date ) // +date то же самое, что: +date.valueOf()

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

Это используют для измерения времени:

var start = new Date; // засекли время

// что-то сделать
for (var i=0; i<100000; i++) {
  var doSomething = i*i*i; 
}

var end = new Date; // конец измерения

alert("Цикл занял " + (end-start) + " ms");

Важность: 5

Напишите код, который выводит:

  1. Сколько секунд прошло с начала сегодняшнего дня.
  2. Сколько осталось до конца дня.

Скрипт должен работать в любой день, т.е. в нём не должно быть конкретного значения сегодняшней даты.

Решение
Решение

Первая часть.

Для вывода достаточно сгенерировать date, соответствующий началу дня, т.е. «сегодня» 00 часов 00 минут 00 секунд.

Разница между текущей датой и началом дня — это количество миллисекунд от начала дня. Его можно легко перевести в секунды:

var now = new Date();

// создать объект из текущей даты, без часов-минут-секунд
var today = new Date(now.getFullYear(), now.getMonth(), now.getDate());

var diff = now - today; // разница в миллисекундах
alert( Math.round(diff / 1000) ); // перевести в секунды

Вторая часть

Для получения оставшихся до конца дня секунд нужно из «завтра 00ч 00мин 00сек» вычесть текущее время.

Чтобы сгенерировать «завтра», нужно увеличить текущий день на 1:

var now = new Date();

// создать объект из даты, без часов-минут-секунд
var tomorrow = new Date(now.getFullYear(), now.getMonth(), *!*now.getDate()+1*/!*);

var diff = tomorrow - now; // разница в миллисекундах
alert( Math.round(diff / 1000) ); // перевести в секунды

Бенчмаркинг

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

Как узнать, какой быстрее?

Для примера возьмем две функции, которые округляют число:

function floorMath(x) {
  return Math.floor(x);
}

function floorXor(x) {
  return x^0; // побитовое исключающее ИЛИ (XOR) всегда округляет число
}

Чтобы померять, какая из них быстрее, нельзя запустить один раз floorMath, один раз floorXor и замерить разницу. Одноразовый запуск ненадежен, любая мини-помеха исказит результат.

Для правильного бенчмаркинга функция запускается много раз, чтобы сам тест занял существенное время. Это сведет влияние помех к минимуму. Сложную функцию можно запускать 100 раз, простую — 1000 раз…

Померяем, какая из функций округления быстрее:

function floorMath(x) { return Math.floor(x); }
function floorXor(x) { return x^0; }

function bench(f) {
  var date = new Date();
  for (var i=0.5; i<1000000; i++) f(i);
  return new Date() - date;
}

alert('Время floorMath: ' + bench(floorMath) + 'мс');
alert('Время floorXor: ' + bench(floorXor) + 'мс');

В зависимости от браузера, может быть быстрее как floorXor так и floorMath.

Представим себе — во время первого бенчмаркинга bench(floorMath) компьютер что-то делал параллельно важное (вдруг) и это занимало ресурсы, а во время второго — перестал. Реальная ситуация? Конечно реальна, особенно на современных ОС.

Гораздо более надёжные результаты можно получить, весь пакет тестов прогнать много раз.

function floorMath(x) { return Math.floor(x); }
function floorXor(x) { return x^0; }

function bench(f) {
  var date = new Date();
  for (var i=0.5; i<100000; i++) f(i);
  return new Date() - date;
}

*!*
var timeMath = 0, timeXor = 0;
for(var i=0; i<100; i++) {
  timeMath += bench(floorMath);
  timeXor += bench(floorXor);
}
*/!*

alert('Время floorMath: ' + timeMath + 'мс');
alert('Время floorXor: ' +timeXor + 'мс');

Форматирование

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

toString(), toDateString(), toTimeString()
Возвращают стандартное строчное представление, не указанное в стандарте, а зависящее от браузера. Единственное требование - читаемость человеком. Метод toString возвращает дату целиком, toDateString() и toTimeString() - только дату и время соответственно.
var d = new Date();

alert( d.toString() ); // вывод, похожий на 'Wed Jan 26 2011 16:40:50 GMT+0300'
toLocaleString(), toLocaleDateString(), toLocaleTimeString()
То же самое, но строка должна быть с учетом локальных настроек и языка посетителя.
var d = new Date();

alert( d.toLocaleString() ); // дата на языке посетителя
toUTCString()
То же самое, что toString(), но дата в зоне UTC.
toISOString()
Возвращает дату в формате ISO Детали формата будут далее. Поддерживается современными браузерами, не поддерживается IE<9.

var d = new Date();

alert( d.toISOString() ); // вывод, похожий на '2011-01-26T13:51:50.417Z'

Встроенные методы форматирования Date не допускают указание собственного формата.

Поэтому, как правило, любой вывод, кроме отладочного, форматируется своей, а не встроенной функцией.

Важность: 3

Напишите функцию formatDate(date), которая выводит дату date в формате дд.мм.гг:

Например:

var d = new Date(2011, 0, 30); // 30 января 2011
alert( formatDate(d) ); // '30.01.11'

P.S. Обратите внимание, ведущие нули должны присутствовать, то есть 1 января 2011 должно быть 01.01.11, а не 1.1.11.

Решение
Решение

Получим компоненты один за другим.

  1. День можно получить как date.getDate(). При необходимости добавим ведущий ноль:
    var dd = date.getDate();
    if (dd<10) dd= '0'+dd;
    
  2. date.getMonth() возвратит месяц, начиная с нуля. Увеличим его на 1:
    var mm = date.getMonth() + 1;  // месяц 1-12
    if (mm<10) mm= '0'+mm;
    
  3. date.getFullYear() вернет год в 4-значном формате. Чтобы сделать его двузначным - воспользуемся оператором взятия остатка '%':
    var yy = date.getFullYear() % 100;
    if (yy<10) yy= '0'+yy;
    
    Заметим, что год, как и другие компоненты, может понадобиться дополнить нулем слева, причем возможно что yy == 0 (например, 2000 год). При сложении со строкой 0+'0' == '00', так что будет все в порядке.

Полный код:

function formatDate(date) {

  var dd = date.getDate()
  if ( dd < 10 ) dd = '0' + dd;

  var mm = date.getMonth()+1
  if ( mm < 10 ) mm = '0' + mm;

  var yy = date.getFullYear() % 100;
  if ( yy < 10 ) yy = '0' + yy;

  return dd+'.'+mm+'.'+yy;
}

var d = new Date(2011, 0, 30);  // 30 Jan 2011
alert( formatDate(d) );  // '30.01.11'

Важность: 4

Напишите функцию formatDate(date), которая форматирует дату date так:

  • Если со времени date прошло менее секунды, то возвращает "только что".
  • Иначе если со времени date прошло менее минуты, то "n сек. назад".
  • Иначе если прошло меньше часа, то "m мин. назад".
  • Иначе полная дата в формате "дд.мм.гг чч:мм".

Например:

function formatDate(date) { /* ваш код */ }

alert( formatDate( new Date(new Date - 1) ) ); // "только что"

alert( formatDate( new Date(new Date - 30*1000) ) ); // "30 сек. назад"

alert( formatDate( new Date(new Date- 5*60*1000) ) ); // "5 мин. назад"

alert( formatDate( new Date(new Date - 86400*1000) ) ); // вчерашняя дата в формате "дд.мм.гг чч:мм"

Решение
Решение

Для того, чтобы узнать время от date до текущего момента - используем вычитание дат.

function formatDate(date) {
  var diff = new Date() - date; // разница в миллисекундах
  
  if (diff < 1000) { // прошло менее 1 секунды
    return 'только что';
  }

  var sec = Math.floor( diff / 1000 ); // округлить diff до секунд
	
  if (sec < 60) {
    return sec + ' сек. назад';
  }
	
  var min = Math.floor( diff / 60000 ); // округлить diff до минут
  if (min < 60) {
    return min + ' мин. назад';		
  }

  // форматировать дату, с учетом того, что месяцы начинаются с 0
  var d = date;
  d = ['0'+d.getDate(),'0'+(d.getMonth()+1),''+d.getFullYear(), '0'+d.getHours(),'0'+d.getMinutes() ];
  for(var i=0; i<d.length; i++) {
    d[i] = d[i].slice(-2);
  }

  return d.slice(0,3).join('.')+' '+d.slice(3).join(':');
}

alert( formatDate( new Date( new Date - 1) ) ); // только что 

alert( formatDate( new Date( new Date - 30*1000) ) ); // 30 сек. назад

alert( formatDate( new Date( new Date- 5*60*1000) ) ); // 5 мин. назад

alert( formatDate( new Date( new Date - 86400*1000) ) ); // вчерашняя дата в формате "дд.мм.гг чч:мм"

Разбор строки, Date.parse

Все современные браузеры, включая IE9+, понимают даты в упрощённом формате ISO 8601 Extended.

Этот формат выглядит так: YYYY-MM-DDTHH:mm:ss.sssZ. Для разделения даты и времени в нем используется символ 'T'. Часть 'Z' обозначает (необязательную) временную зону — она может отсутствовать, тогда зона UTC, либо может быть символ z — тоже UTC, или зона в формате +-hh:mm.

Также возможны упрощенные варианты, к примеру:

YYYY 
YYYY-MM 
YYYY-MM-DD
Метод Date.parse(str) разбирает строку str в таком формате и возвращает соответствующее ей количество миллисекунд. Если это невозможно, Date.parse возвращает NaN.

На момент написания некоторые браузеры (Safari) воспринимали формат без 'Z' как дату в локальной таймзоне (по стандарту UTC), поэтому пример ниже в них работает некорректно:

var msNoZone = Date.parse('2012-01-26T13:51:50.417'); // без зоны, значит UTC

alert(msNoZone); // 1327571510417 (число миллисекунд)

var msZ = Date.parse('2012-01-26T13:51:50.417z'); // зона z означает UTC
alert(msZ == msNoZone); // true, если браузер правильный

С таймзоной -07:00 GMT в конце все современные браузеры работают правильно:

var ms = Date.parse('2012-01-26T13:51:50.417-07:00');

alert(ms); // 1327611110417 (число миллисекунд)

Формат дат для IE8-

До появления спецификации EcmaScript 5 формат не был стандартизован, и браузеры, включая IE8-, имели свои собственные форматы дат. Частично, эти форматы пересекаются.

Например, код ниже работает везде, включая старые IE:

var ms = Date.parse("January 26, 2011 13:51:50");

alert(ms);

Вы также можете почитать о старых форматах IE в документации к методу MSDN Date.parse.

Конечно же, сейчас лучше использовать современный формат, если цель — современные браузеры, а если дополнительно нужны IE8-, то либо передавать даты через миллисекунды, а не строки, либо добавить библиотеку типа es5-shim, которая добавит Date.parse в старые IE.

Итого

  • Дата и время представлены в JavaScript одним объектом: Date. Создать «только время» при этом нельзя, оно должно быть с датой. Список методов Date вы можете найти в справочнике Date или выше.
  • Объект Date удобен тем, что автокорректируется. Благодаря этому легко сдвигать даты.
  • Объекты Date можно вычитать, результатом будет разница в мс.

Комментарии

  1. Приветствуются комментарии, содержащие дополнения и вопросы по статье, и ответы на них.
  2. Если ваш комментарий касается задачи – откройте её в отдельном окне и напишите там.
  3. Для кода внутри строки используйте тег <code>, для блока кода – тег <pre>, если больше 10 строк – ссылку на песочницу.
  4. Если что-то непонятно – пишите, что именно и с какого места.
Наверх
»
Нашли опечатку?
Нашли опечатку на сайте? Что-то кажется странным? Выделите соответствующий текст и нажмите Ctrl+Enter!
»
Поделись!
Помоги другим узнать о хорошей статье!