Class Types/formatter:date

Преобразует дату в строку указанного формата.

Примечание

Параметры функции

  • date {Date} Дата.
  • mask {String} Маска формата вывода.
  • [timeZoneOffset] {Number} Смещение часового пояса, в котором требуется вывести значения. По умолчанию используется локальный.

Возвращает

{String} Дата в указанном формате.

Доступные константы для вывода дат по стандарту с учетом локализации.

  • FULL_DATE: полная дата, “DD.MM.YY” для “Ru-ru”;
  • FULL_DATE_DOW: полная дата с днем недели, “DD MMMMlo’YY, ddddl” для “Ru-ru”;
  • FULL_DATE_FULL_MONTH: полная дата с полным названием месяца, “DD MMMMlo’YY” для “Ru-ru”;
  • FULL_DATE_FULL_MONTH_FULL_YEAR: полная дата с полным названием месяца и полным годом, “DD MMMMlo YYYY” для “Ru-ru”;
  • FULL_DATE_FULL_YEAR: полная дата с полным годом, “DD.MM.YYYY” для “Ru-ru”;
  • FULL_DATE_SHORT_MONTH: полная дата с кратким названием месяца, “DD MMMl’YY” для “Ru-ru”;
  • FULL_DATE_SHORT_MONTH_FULL_YEAR: полная дата с кратким названием месяца и полным годом, “DD MMMl YYYY” для “Ru-ru”;
  • FULL_DATETIME: полный формат даты и времени, “DD MMM’YY HH:mm” для “Ru-ru”;
  • FULL_HALF_YEAR: полное полугодие и год, “YYYYhr ’YY” для “Ru-ru”;
  • FULL_MONTH: полное название месяца и год, “MMMM’YY” для “Ru-ru”;
  • FULL_QUATER: полный квартал и год, “QQQQr ’YY” для “Ru-ru”;
  • FULL_TIME: полное время, “HH:mm:ss” для “Ru-ru”;
  • SHORT_DATE: краткая дата, “DD.MM” для “Ru-ru”;
  • SHORT_DATE_DOW: краткая дата с днем недели, “DD MMMMlo, ddddl” для “Ru-ru”;
  • SHORT_DATE_FULL_MONTH: краткая дата с полным названием месяца, “DD MMMMlo” для “Ru-ru”;
  • SHORT_DATE_SHORT_MONTH: краткая дата с кратким названием месяца, “DD MMMl” для “Ru-ru”;
  • SHORT_DATETIME: краткий формат даты и времени, “DD MMMl HH:mm” для “Ru-ru”;
  • SHORT_HALF_YEAR: краткое полугодие, “YYhr ’YY” для “Ru-ru”;
  • SHORT_MONTH: краткое название месяца и год, “MMM’YY” для “Ru-ru”;
  • SHORT_QUATER: краткий квартал и год, “QQr ’YY” для “Ru-ru”;
  • SHORT_TIME: краткое время, “HH:mm” для “Ru-ru”.

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

  • FULL_YEAR: полный год, “YYYY” для “Ru-ru”;
  • DIGITAL_MONTH_FULL_YEAR: цифровой формат месяца с полным годом “MM.YYYY” для “Ru-ru”.
  • FULL_TIME_FRACTION: полное время с миллисекундами, “HH:mm:ss.SSS” для “Ru-ru”;
  • FULL_DATE_SHORT_TIME: комбинированный формат полной даты и краткого времени:, “DD.MM.YY HH:mm” для “Ru-ru”;
  • FULL_DATE_FULL_TIME: комбинированный формат полной даты и полного времени:, “DD.MM.YY HH:mm:ss” для “Ru-ru”;
  • FULL_DATE_FULL_TIME_FRACTION: комбинированный формат полной даты и полного времени с миллисекундами:, “DD.MM.YY HH:mm:ss.SSS” для “Ru-ru”;
  • FULL_DATE_FULL_YEAR_SHORT_TIME: комбинированный формат полной даты с полным годом и краткого времени:, “DD.MM.YYYY HH:mm” для “Ru-ru”;
  • FULL_DATE_FULL_YEAR_FULL_TIME: комбинированный формат полной даты с полным годом и полного времени:, “DD.MM.YYYY HH:mm:ss” для “Ru-ru”;
  • FULL_DATE_FULL_YEAR_FULL_TIME_FRACTION: комбинированный формат полной даты с полным годом и полного времени с миллисекундами:, “DD.MM.YYYY HH:mm:ss.SSS” для “Ru-ru”;
  • SHORT_DATE_SHORT_TIME: комбинированный формат краткой даты и краткого времени:, “DD.MM HH:mm” для “Ru-ru”;
  • SHORT_DATE_FULL_TIME: комбинированный формат краткой даты и полного времени:, “DD.MM HH:mm:ss” для “Ru-ru”;
  • SHORT_DATE_FULL_TIME_FRACTION: комбинированный формат краткой даты и полного времени с миллисекундами:, “DD.MM HH:mm:ss.SSS” для “Ru-ru”;
  • DURATION_SHORT_TIME: продолжительность в кратком формате времени:, “HHH:mm” для “Ru-ru”;
  • DURATION_FULL_TIME: продолжительность в полном формате времени:, “HHH:mm:SS” для “Ru-ru”;

Доступные константы для вывода дат по стандарту ISO 8601.

  • ISO_DATETIME: полные дата и время — “YYYY-MM-DDTHH:mm:ss[.SSS]ZZ”;
  • ISO_DATETIME_SQL: полные дата и время, совместимые со стандартами SQL — “YYYY-MM-DD HH:mm:ss[.SSS]ZZ”;

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

Выведем полную дату:

import {date as format} from 'Types/formatter';
const date = new Date(2018, 4, 7);
console.log(format(date, format.FULL_DATE)); // 07.05.18

Выведем полную дату с днем недели:

import {date as format} from 'Types/formatter';
const date = new Date(2018, 4, 7);
console.log(format(date, format.FULL_DATE_DOW)); // 07 мая'18, понедельник

Выведем текущее время в часовом поясе клиента:

import {date as format} from 'Types/formatter';
import {DateTime} from 'Types/entity';
const date = new Date();
console.log(format(date, format.SHORT_TIME, DateTime.getClientTimezoneOffset()));

Доступные маски.

Отображение времени:

  • s: секунды;
  • ss: секунды с лидирующим нулем;
  • m: минуты;
  • mm: минуты с лидирующим нулем;
  • h: часы в 12-часовом формате;
  • hh: часы в 12-часовом формате с лидирующим нулем;
  • H: часы в 24-часовом формате;
  • HH: часы в 24-часовом формате с лидирующим нулем;
  • HHH: число часов в абсолиютном фомрате (0-∞);
  • a: интервал суток либо до полудня (ante meridiem), либо после полудня (post meridiem) в текущей локали;
  • SSS: дробная часть секунд (миллисекунды).

Отображение даты:

  • D: порядковый номер дня месяца;
  • DD: порядковый номер дня месяца с лидирующим нулем;
  • dd: краткое название дня недели в текущей локали с заглавной буквы (например, ‘Пн’ или ‘Mo’);
  • ddl: краткое название дня недели в текущей локали в нижнем регистре (например, ‘пн’ или ‘mo’);
  • ddd: сокращенное название дня недели в текущей локали с заглавной буквы (например, ‘Пнд’ или ‘Mon’);
  • dddl: сокращенное название дня недели в текущей локали в нижнем регистре (например, ‘пнд’ или ‘mon’);
  • dddd: полное название дня недели в текущей локали с заглавной буквы (например, ‘Понедельник’ или ‘Monday’);
  • ddddl: полное название дня недели в текущей локали в нижнем регистре (например, ‘понедельник’ или ‘monday’);
  • M: порядковый номер месяца;
  • MM: порядковый номер месяца с лидирующим нулем;
  • MMM: сокращенное название месяца в текущей локали (например, ‘Янв’ или ‘Jan’);
  • MMMl: сокращенное название месяца в текущей локали в нижнем регистре (например, ‘янв’ или ‘jan’);
  • MMMM: полное название месяца в текущей локали (например, ‘Январь’ или ‘January’);
  • MMMMl: полное название месяца в текущей локали в нижнем регистре (например, ‘январь’ или ‘january’);
  • MMMMo: полное название месяца в текущей локали в плюральной форме (например, ‘Января’ или ‘January’);
  • MMMMlo: полное название месяца в текущей локали в плюральной форме и нижнем регистре (например, ‘января’ или ‘january’);
  • Y: двузначный номер года;
  • YY: двузначный номер года с лидирующим нулем;
  • YYYY: четырехзначный номер года;
  • YYhr: номер полугодия в римской нотации и полугодие в текущей локали в краткой форме (например, ‘I пл’ или ‘I hy’);
  • YYYYhr: номер полугодия в римской нотации и полугодие в текущей локали в полной форме (например, ‘I полугодие’ или ‘I half year’);
  • QQr: номер квартала в римской нотации и квартал в текущей локали в краткой форме (например, ‘I кв’ или ‘I qt’);
  • QQQr: номер квартала в римской нотации и квартал в текущей локали в сокращенной форме (например, ‘I квр’ или ‘I qtr’);
  • QQQQr: номер квартала в римской нотации и квартал в текущей локали в полной форме (например, ‘I квартал’ или ‘I quarter’).
  • Z: Смещение от стандартного времени в виде +-HH:mm например +03 или +03:30
  • ZZ: Смещение от стандартного времени в виде +-HHmm например +03 или +0330

Примеры использования масок.

Выведем дату:

import {date as format} from 'Types/formatter';
const date = new Date(2018, 4, 7);
console.log(format(date, 'Сегодня ddddl, D MMMMlo YYYY года.')); // Сегодня понедельник, 7 мая 2018 года.

Для экранирования вывода следует использовать квадратные скобки:

import {date as format} from 'Types/formatter';
const date = new Date(2018, 4, 7);
console.log(format(date, '[Today is] YYYY/DD/MM')); // Today is 2018/07/05

10/23/2020Мальцев А.А.