Javascript перевод даты и время. TempusJS — работаем с датой в javascript. Автоопределение даты и парсинг

Получить текущую дату в JavaScript очень просто. Для этого предназначен объект Date . Его синтаксис достаточно прост, а имена методов интуитивно понятны. В приведенных ниже примерах я покажу, как работать с объектом Date (JavaScript new date ), чтобы получить текущие год, месяц, день и время с точностью до миллисекунды!

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

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

var date = new Date(); console.log(date);

Этот код выводит на консоль следующую информацию:

//Tue Feb 02 2016 15:46:56 GMT-0500 (Eastern Standard Time)

Здесь отображается текущий день недели, текущий месяц, день месяца, год и даже текущее время в 24-часовом формате. Фрагмент «GMT » означает время по Гринвичу, а «-0500 » — это разница в часовых поясах между местным временем и GMT .

Цитата из Википедии : «Среднее время по Гринвичу (GMT ) — это среднее солнечное время в Королевской обсерватории в Гринвиче, Лондон.» Это связано с универсальным координированным временем (UTC ). «Eastern Standard Time » в выведенном значении даты относится к временной зоне вашего браузера или компьютера.

* Обратите внимание, что GMT и UTC различаются между собой. Мы будем рассматривать значения UTC в минутах.

* Также обратите внимание, что дата в JavaScript определяется временем в миллисекундах, которое прошло с полуночи 01 января 1970 года, UTC. В одном дне 86,400,000 миллисекунд. Диапазон объекта Date составляет от -100,000,000 дней до 100,000,000 дней относительно 01 января 1970 года, UTC.

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

Хорошо, мы разобрались с new Date JavaScript форматами и теперь готовы двигаться дальше!

Получение дня недели:

Чтобы получить день недели, используйте метод JavaScript объекта Date getDay() :

var day = date.getDay(); console.log(day);

* Обратите внимание, что дни недели пронумерованы от 0 до 6, воскресенье = 0, понедельник = 1, вторник = 2 и так далее.

Получение месяца:

Чтобы получить текущий месяц текущего года, используйте метод getMonth() . До этого я говорил, что названия методов интуитивно понятны!

var month = date.getMonth(); console.log(month); //1

* Обратите внимание, что, как и дни недели, месяцы возвращаются в числовом формате от 0 до 11; январь = 0, февраль = 1, март = 2 и так далее.

Получение дня месяца:

Чтобы получить день месяца, можно использовать метод GetDate() .

var dayOfMonth = date.getDate(); console.log(dayOfMonth); //2

* Метод GetDate() возвращает дни месяца, пронумерованные от 1 до 31; номер 1 соответствует первому дню месяца.

Получение времени:

Чтобы получить текущее время, используется метод GetTime () .

var time = date.getTime(); console.log(time); //1454461242058

Выглядит… странно… Что это такое? Вы видите количество миллисекунд, прошедших с 1 января 1970 00:00:00 UTC. Так сколько это лет?

1454461242058 мс / 31540000000 мс в году = около 46 лет
1970 год + 46 лет = 2016 год

Давайте проверим, чтобы убедиться:

var year = date.getFullYear(); console.log(year) //2016

Да, это оно! Мы только что вывели с помощью JavaScript new date текущую дату и время.

Еще одна полезная для сайтов вещь - вставка текущей даты. Примеров скриптов даты можно найти в интернете десятки, однако многие из них, на мой взгляд, тяжеловесны и, следовательно, некрасивы. Между тем, используя стандартные средства JavaScript , вставить дату на страницу сайта можно очень просто. Я его очень часто применяю! На картинке (скриншот с действующего сайта) усадьбы «Сказка» !

Вот весь скрипт даты:

По-моему, проще некуда, достаточно красиво и понятно. Если у вас нет никакого желания изучать построение этого скрипта, то просто вставляйте его в любое место HTML-страницы и получите следующую надпись:

Еще один вариант более расширенный

//
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>
! Сегодня
// + " " + d.getFullYear() + " г.");
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>

Выглядит он так:

Сегодня

Вобщем не требуется никаких навыков, просто тупо вставляем код и все ок!

Подробнее:

Итак, начинаем с присвоения значения даты переменной d , затем создаём массивы (Array ) для дней недели (day ) и месяцев (month ), указывая их в необходимой грамматической форме: падеж, число, заглавная буква, если слово стоит в начале даты и т.п. Последняя строчка скрипта - собственно печать даты (document.write ). Здесь вы устанавливаете, что и в какой последовательности будете выводить в строке текущей даты. Компоненты отделяются друг от друга знаком + . Для ввода пробела используется конструкция " " , а для ввода буквы г (год) - конструкция " г."

Как видно из скрипта, получение данных о текущем времени выполняет элемент get . Этот метод позволяет получить следующую информацию:

• getDate() - возвращает число от 1 до 31, представляющее число месяца;
• getDay() - возвращает день недели как целое число от 0 (воскресенье) до 6 (суббота);
• getMonth() - возвращает номер месяца в году;
• getFullYear() - возвращает год. Если использовать просто getYear() , то будет выводиться текущий год минус 1900;
• get Hours() - возвращает час суток;
• getMinutes() - возвращает минуты как число от 0 до 59;
• getSeconds() - возвращает число секунд от 0 до 59.

Вставлять непосредственно Java -скрипт внутрь страницы сайта не всегда удобно. Лучше поместить описание скрипта в начало страницы между тегами и задать переменную, которую будем вызывать по мере необходимости в тексте. Назовём её TODAY и определим в ней форму вывода даты аналогично вышеизложенному. Скрипт будет выглядеть следующим образом:

Для вывода даты вызываем скрипт в нужном месте HTML-кода страницы, используя следующую команду:

document.write(TODAY);

Если ваш сайт содержит много страниц, на которых надо показывать дату, то удобнее выделить Java -скрипт вывода даты в отдельный файл, например, data.js . Практически, это страница, состоящая из первого из описанных скриптов, то есть со строкой document.write (см. выше). Располагать её надо в том же каталоге, что и основная страница, и вызывать в месте вывода даты следующим образом:

Не забудьте проверить, чтобы файл data.js имел ту же кодировку, что и основной документ, иначе дата будет выводиться замечательными крючками, квадратиками и прочими финтифлюшками.

Замечание. Следует иметь ввиду, что описанный скрипт выводит дату, установленную на компьютере пользователя, что не всегда соответствует реальному текущему времени. Если вам необходимо показать точное время, то необходимо использовать РНР-скрипт, который будет показывать время на сервере.

Всем привет!
Мне часто приходится работать со статистическими данными и там очень много завязано на датах. Притом, одна и та же дата может быть использована на странице в разных форматах (например, в удобном для машины и в удобном для человека). Я думаю, что большинство из вас отлично представляют весь этот ужасающий по размерам код, который получается при использовании объекта Date.
К примеру, чтобы получить текущую дату в формате ДД.ММ.ГГГГ нам потребуется сделать следующее:
var d = new Date(), fd = d.getDate() + "." + (d.getMonth()+1) + "." + d.getFullYear();
А когда таких строк становится много? Легко ли упомнить, что в javascript месяц начинается с нуля, когда разрабатываешь не только на нем? Или то, что тут миллисекунды, а не секунды, как почти везде на бэкенде? Можно решить часть задач популярной библиотекой Moment.js , но она работает весьма медленно.
Рассматриваемая библиотека решает эти проблемы.
Если интересно, предлагаю вам прочитать этот небольшой обзор.

TempusJS во многом состоит из синтаксического сахара над объектом Date, поэтому работает очень быстро. Синтаксис же самой библиотеки весьма прост. Например, записать предыдущий пример, можно так:
var fd = tempus().format("%d.%m.%Y");
Теперь о скорости. В спойлере вы можете увидеть сравнение Tempus с Moment и нативным способом форматирования даты (см. выше):

Сравнение нативного JS, MomentJS и TempusJS

Получаем текущую дату Native JS x 2,175,575 ops/sec ±0.75% (96 runs sampled) Moment x 284,864 ops/sec ±0.85% (96 runs sampled) Tempus x 2,086,081 ops/sec ±0.73% (97 runs sampled) Форматирование Native JS x 1,637,517 ops/sec ±0.61% (100 runs sampled) Moment x 8,808 ops/sec ±1.07% (100 runs sampled) Tempus x 942,815 ops/sec ±0.68% (94 runs sampled) Автоопределение даты и парсинг Native JS x 11,204,316 ops/sec ±0.81% (88 runs sampled) Moment x 38,511 ops/sec ±1.41% (95 runs sampled) Tempus x 93,973 ops/sec ±1.06% (85 runs sampled) Парсинг даты по формату Moment x 46,293 ops/sec ±0.63% (100 runs sampled) Tempus x 109,947 ops/sec ±0.93% (99 runs sampled) Парсинг и валидация Moment x 44,588 ops/sec ±1.09% (90 runs sampled) Tempus x 103,439 ops/sec ±0.90% (94 runs sampled)
Результаты получены на моем ноутбуке в Google Chrome 30.0.1599.114. В других браузерах результаты отличаются, но соотношение остается примерно тем же.
Для тестов использовалась библиотека benchmark.js
Бенчмарки по другим функциям, вы можете увидеть .

Итак, в преимущества данной библиотеки можно записать следующее:

• Поддерживает IE6+, Chrome, Firefox, Opera;
• Поддерживает цепочки вызовов;
• Месяцы могут начинаться с 1 (по умолчанию), а не нуля;
• Миллисекунды могут быть отключены (по умолчанию) или включены;
• Быстрая работа (Так как, во многих случаях, используется родной для браузера объект Date, реализация которого написана на более быстрых языках);
• Поддерживает кастомные форматы и плагины
• Валидация даты очень быстра и зависит только от устанавливающих дату функций (т.к. валидация проходит уже при занесении значений, а не высчитывается отдельно);
• Мультиязычность и автоопределение языка пользователя.

Здесь речь пойдет только о некоторых функциях.

Форматирование и парсинг

Итак, для начала еще один пример форматирования даты. Здесь мы также используем цепочку вызовов. В конце каждой установки значения, мы получаем обратно объект TempusDate, который можем использовать дальше в цепочке. Пример:
tempus(). // получаем новую дату calc({month: -1}). // уменьшаем ее на один месяц format("%d.%m.%Y"); // Выводим в виде строки
Таким образом, мы получим этот же день, час и секунду, но месяц назад. Это бывает полезно для получения отчетов за последний месяц.

Следующий пример - парсинг даты.
// Вернет объект TempusDateс датой "2013-11-18" tempus("18.11.2013"); // Вернет объект TempusDateс датой "2013-12-12" tempus("2013-12-12", "%Y-%m-%d"));
Tempus может автоматически определять некоторые известные форматы. Также, можно указывать определенный формат, тогда парсинг будет происходить быстрее. Плюс к этому, можно задавать дату, которая будет возвращена, если парсинг завершится неудачей:
// Т.к. "123" не подходит к формату "%d.%m.%Y", то // будет возвращен объект, содержащий дату 2013-01-01 tempus("123", "%d.%m.%Y", tempus());
Список форматов по умолчанию можно посмотреть

А теперь поменяем формат уже отформатированной даты
// "2013-11-05" tempus("05.11.2013").format("%Y-%m-%d"); // Или так // "October, 12" tempus("2013-10-12 12:31:01", "%Y-%m-%d %H:%M:%S").format("%B, %d");

Также, можно использовать локализацию для форматирования. По умолчанию, будет выбран язык пользователя (берем из браузера) или язык по умолчанию, если язык пользователя не обнаружен среди доступных языков Tempus.
// Устанавливаем язык tempus.lang("ru"); // Стандартно используем format // "Ноябрь, 05" tempus(1383609600).format("%B, %d");
На данный момент языков всего два - русский и английский, так что буду рад помощи.

Валидация Валидация даты происходит следующим образом:
// Вернет false tempus("32.08.2013", "%d.%m.%Y").valid(); // Вернет true tempus("00:00 01.01.2012", "%H:%M %d.%m.%Y").valid();

В случае ошибки, можно посмотреть поля, в которых она возникла - везде, где значение не false:
// Вернет {"year":-5,"month":false,"day":false,"hours":false, // "minutes":false,"seconds":false,"milliseconds":false} tempus(). year(-5). // задаем год=-5, т.е. невалидный errors(); // получаем объект с ошибками

Диапазоны дат Иногда нам требуется получить количество лет (например, возраст), месяцев, дней и т.д. между двумя датами. Для этого мы можем использовать метод between, который находит разницу между двумя датами и возвращает в нужном формате ("year", "month", "day", "hours", "minutes", "seconds", "milliseconds").
Вот простой пример получения количества месяцев между 1 ноября 2013 года и 5 мая 2014 года:
// Вернет 6 tempus().between(tempus(), "month");
Или сколько часов осталось до нового года
tempus().between(tempus(), "hours");
В последнем примере можно заметить, что я указал только год. При установке значения массивом или объектом, нехватающие значения будут
заполнены минимальными. Список констант с минимальными значениями, вы можете увидеть в документации.

Также, мы можем изменить какую-либо дату, используя функцию calc:
// Вернет TempusDate с датой 2012-01-01 tempus().calc({year: 1, month: -4, day: -1});

Свои форматы Применяем свой формат для месяца, который может принимать значения от 1 до 12 (а не 01 до 12):
// Регистрируем новый формат tempus.registerFormat("%q", // директива - %q function(date) { // Здесь указываем функцию форматирования, т.е. что будет подставлено вместо %q return date.month(); }, function(value) { // А здесь функцию парсинга var v = Number(value); return {month: (isNaN(v) ? undefined: v) }; }, 1, // Минимальная длина, которую может принимать значение 2, // Максимальная длина "number" // Тип); // Тестируем // Вернет "01.1.2013"; tempus({year: 2013, month: 1, day: 1}).format("%d.%q.%Y"); // Вернет {"year":2013,"month":2,"day":10,"hours":0,"minutes":0,"seconds":0}; tempus("10.2.2013", "%d.%q.%Y").get();
При регистрации можно заметить, что некоторые параметры задаются отдельно, в то время, как можно было бы использовать регулярное выражение. На самом деле, там изначально оно и было, но после отказа от него, скорость выросла в несколько десятков раз.
Если вам потребуется удалить какой то формат, то используйте unregisterFormat:
tempus.unregisterFormat("%d"); // Вернет "%d.01.2013", т.к. директивы %d уже не существует. tempus.format({year: 2013, month: 1, day: 1}, "%d.%m.%Y"); Геттеры/сеттеры Можно получать/устанавливать некоторые значения, используя функции year(), month(), day(), hours(), minutes(), seconds(), milliseconds(), dayOfWeek(), utc(), timestamp() или set(). Например:
tempus(). // Получаем текущую дату year(1900). // Оставляем все как есть, но устанавливаем 1900 год leapYear(); // Проверяем, високосный ли это год, в данном случае false tempus().year(); // А так получаем текущий год в числовом виде Генерация дат Вы можете сгенерировать дату множеством способов, полный список параметров находится в документации. Здесь представлен минимальный пример.
// returns ["29.03.2013", "30.03.2013", "31.03.2013", "01.04.2013", "02.04.2013"]; tempus.generate({ dateFrom: "20130329", formatFrom: "%Y.%m.%d", dateTo: "20130402", period: {day: 1}, format: "%d.%m.%Y" });
Это может быть полезно для отображения графиков по датам и смена формата отображения прямо на клиенте, без запросов к бэкенду. Дата может быть сгенерирована как массив, так и как объекты, где в качестве ключей будут сами даты (это полезно, когда нам требуется к какой-либо дате привязать какое-либо событие, например, когда делаем свой календарь). Также, даты могут быть сгруппированы по дням, неделям, месяцам, часам, годам - по чему угодно. Это также может быть применено к календарю.Плагины Ну и последнее - плагины. Здесь мы расширяем фабрику, для генерации случайной даты. Также, нам потребуется класс TempusDate, его можно найти в tempus.classes(). Вот пример плагина:
(function (tempus) { var TempusDate = tempus.classes("TempusDate"); tempus.randomDate = function() { var date = new TempusDate(); date.year(Math.floor((Math.random()*(tempus.MAX_YEAR - tempus.MIN_YEAR)) + tempus.MIN_YEAR)). month(Math.floor((Math.random()*(tempus.MAX_MONTH - tempus.MIN_MONTH)) + tempus.MIN_MONTH)). day(Math.floor((Math.random()*(date.dayCount() - tempus.MIN_DAY)) + tempus.MIN_DAY)). hours(Math.floor((Math.random()*(tempus.MAX_HOURS - tempus.MIN_HOURS)) + tempus.MIN_HOURS)). minutes(Math.floor((Math.random()*(tempus.MAX_MINUTES - tempus.MIN_MINUTES)) + tempus.MIN_MINUTES)). seconds(Math.floor((Math.random()*(tempus.MAX_SECONDS - tempus.MIN_SECONDS)) + tempus.MIN_SECONDS)); return date; }; })(tempus); // Теперь мы можем создавать даты следующим образом var someRandomDate = tempus.randomDate();
Думаю, что таким способом можно будет удобно писать виджеты, используя связку jQuery+Tempus, Angular+Tempus и т.п.

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

New Date()

Даты хранятся в нём как количество миллисекунд, прошедших с полуночи 1 января 1970 г. согласно единому всемирному времени (UTC). Благодаря такому формату с помощью Date можно точно представлять даты, отстоящие от 1 января 1970 г. на 285616 лет.

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

• миллисекунды: значение должно быть числом миллисекунд с 01.01.1970 var birthDate = new Date(8298400000); document.write(birthDate);
• строка с датой: любая дата в формате поддерживаемом методом parse() var birthDate = new Date("April 16, 1975"); document.write(birthDate);
• год, месяц, день var birthDate = new Date(1975, 4, 28); document.write(birthDate);

  Обратите внимание, что число 4 соответствует маю месяцу. Это значит, что январю соответствует число 0. Аналогичным образом вычисляются и дни, только нулю в этом случае соответствует воскресенье.

• год, месяц, день, час, минуты, секунды, миллисекунды

При работе с объектом Date важно помнить, что вычисления выполняются с использованием единого всемирного времени (UTC), несмотря на то, что ваш компьютер может отображать время в соответствии с вашей временной зоной.

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

getDate()	Возвращает день месяца (от 1 до 31) для указанной даты по местному времени.
getDay()	Возвращает день недели (от 0 до 6; 0 = воскресенье, 1 = понедельник и т.д.) для указанной даты по местному времени..
getFullYear()	Возвращает год (четыре цифры).
getHours()	Возвращает час (от 0 до 23).
getMilliseconds()	Возвращает миллисекунды (от 0 до 999).
getMinutes()	Возвращает минуты (от 0 до 59).
getMonth()	Возвращает месяц (от 0 до 11; 0 = январь, 1 = февраль и т.д.).
getSeconds()	Возвращает секунды (от 0 до 59).
getTime()	Возвращает количество миллисекунд, прошедших с полуночи 01.01.1970.
getTimezoneOffset()	Возвращает разницу во времени между временем UTC и местным временем, в минутах.
getUTCDate()	Возвращает день месяца по всемирному времени (от 1 до 31).
getUTCDay()	Возвращает день недели по всемирному времени (от 0 до 6).
getUTCFullYear()	Возвращает год по всемирному времени (четыре цифры).
getUTCHours()	Возвращает час по всемирному времени (от 0 до 23).
getUTCMilliseconds()	Возвращает миллисекунды по всемирному времени (от 0 до 999).
getUTCMinutes()	Возвращает минуты по всемирному времени (от 0 до 59).
getUTCMonth()	Возвращает месяц по всемирному времени (от 0 до 11).
getUTCSeconds()	Возвращает секунды по всемирному времени (от 0 до 59).
parse()	Анализирует строку даты (например, "21 мая 1992 года") и возвращает строку со значением даты, которая содержит число в миллисекундах с 1 января 1970 00:00:00.
setDate()	Устанавливает день месяца для указанной даты по местному времени (от 1 до 31).
setFullYear()	Устанавливает год (четыре цифры).
setHours()	Устанавливает часы для указанной даты по местному времени (от 0 до 23).
setMilliseconds()	Устанавливает миллисекунды для указанной даты по местному времени.
setMinutes()	Устанавливает минуты (от 0 до 59).
setMonth()	Устанавливает месяц (от 0 до 11).
setSeconds()	Устанавливает секунды (от 0 до 59).
setTime()	Устанавливает дату в миллисекундах после (или до) 01.01.1970.
setUTCDate()	Задает день месяца.
setUTCFullYear()	Устанавливает год по всемирному времени (четыре цифры).
setUTCHours()	Устанавливает час для указанной даты по всемирному времени.
setUTCMilliseconds()	Задает миллисекунды для указанной даты по всемирному времени.
setUTCMinutes()	Устанавливает минуты для указанной даты по всемирному времени.
setUTCMonth()	Задает месяц для указанной даты по всемирному времени.
setUTCSeconds()	Устанавливает секунды для указанной даты по всемирному времени.
toDateString()
toISOString()	Преобразует дату в строку, используя стандарт ISO 8601.
toJSON()	Возвращает дату в виде строки, отформатированную как дата JSON.
toLocaleDateString()
toLocaleTimeString()	Возвращает часть даты в виде строки, с представлением даты на основе параметров системы.
toLocaleString()	Возвращает дату в виде строки, с представлением даты на основе параметров системы.
toString()	Возвращает строку, представляющую указанный объект Date.
toTimeString()	Возвращает часть даты в виде строки.
toUTCString()	Преобразует дату в строку, используя часовой пояс UTC.
UTC()	Принимает те же параметры, что и длинная форма конструктора (т.е. 2-7) и возвращает количество миллисекунд с 1 января 1970, 00:00:00 UTC.
valueOf()	Возвращает примитивное значение объекта Date.

Используйте new Date() для создания нового объекта Date содержащего текущую дату и время.

Обратите внимание, что Date() вызываемая без аргументов, эквивалентна new Date(Date.now()) .

Когда у вас есть объект даты, вы можете применить любой из нескольких доступных методов для извлечения его свойств (например, getFullYear() чтобы получить 4-значный год).

Ниже приведены некоторые общие методы даты.

Получить текущий год var year = (new Date()).getFullYear(); console.log(year); // Sample output: 2016 Получить текущий месяц var month = (new Date()).getMonth(); console.log(month); // Sample output: 0

Обратите внимание, что 0 = январь. Это потому, что месяцы варьируются от 0 до 11 , поэтому часто желательно добавить +1 к индексу.

Получить текущий день var day = (new Date()).getDate(); console.log(day); // Sample output: 31 Получить текущий час var hours = (new Date()).getHours(); console.log(hours); // Sample output: 10 Получить текущие минуты var minutes = (new Date()).getMinutes(); console.log(minutes); // Sample output: 39 Получить текущие секунды var seconds = (new Date()).getSeconds(); console.log(second); // Sample output: 48 Получить текущие миллисекунды

Чтобы получить миллисекунды (от 0 до 999) экземпляра объекта Date , используйте метод getMilliseconds .

Var milliseconds = (new Date()).getMilliseconds(); console.log(milliseconds); // Output: milliseconds right now

Преобразование текущего времени и даты в удобочитаемую строку var now = new Date(); // convert date to a string in UTC timezone format: console.log(now.toUTCString()); // Output: Wed, 21 Jun 2017 09:13:01 GMT

Статический метод Date.now() возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC. Чтобы получить количество миллисекунд, прошедших с того времени, используя экземпляр объекта Date , используйте его метод getTime .

// get milliseconds using static method now of Date console.log(Date.now()); // get milliseconds using method getTime of Date instance console.log((new Date()).getTime());