date

набор методов форматирования даты

Объект date предоставляет следующие методы:

• add (date, number, unit): Date - добавляет/вычитает указанный временной интервал к/из даты
  • date - (Date) объект даты, к которому необходимо добавить или отнять время
  • number - (number) количество единиц для добавления. Если число положительное - время будет добавлено к дате, если отрицательное - время будет вычтено
  • unit - (string) единица времени. Значения: 'minute', 'hour', 'day', 'week', 'month', 'year'.

  //добавляет 1 год к указанной дате: 29 июня, 2019 -> 29 июня, 2020
  var newDate = gantt.date.add(new Date(2019, 05, 29), 1, 'year');

• add_quarter (date, number): Date - добавляет/вычитает указанное количество кварталов к/из даты
  • date - (Date) объект даты, к которому необходимо добавить или отнять кварталы
  • number - (number) количество кварталов (1 квартал = 3 месяца) для добавления. Если число положительное - кварталы будут добавлены к дате, если отрицательное - кварталы будут вычтены

  //добавляет 1 квартал (3 месяца) к указанной дате: 
  //29 июня, 2019 -> 29 сентября, 2019
  var newDate = gantt.date.add_quarter(new Date(2019, 05, 29), 1);

• convert_to_utc (date): Date - преобразует местное время в UTC
  • date - (Date) объект даты для преобразования

  //29 июня, 2019 14:00 (местное время) -> 29 июня, 2019 12:00 (utc)
  var time = gantt.date.convert_to_utc(new Date(2019, 05, 29, 14, 00));

• copy (date): Date - создает копию объекта Date
  • date - (Date) объект даты для копирования

  var copy = gantt.date.copy(new Date(2019, 05, 29));// -> 29 июня, 2019

• date_part (date): Date - сбрасывает временную часть указанной даты на 00:00:00
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30:10 -> 29 июня, 2019 00:00:00
  var date = gantt.date.date_part(new Date(2019, 05, 29, 14, 30, 10));

• date_to_str (format, utc): Function - возвращает функцию, которая преобразует объект Date в строку указанного формата
  • format - (string) формат даты (см. Спецификация Формата Даты)
  • utc? - (boolean) указывает, следует ли преобразовать местное время в UTC

  var formatFunc = gantt.date.date_to_str("%d/%m/%Y");
  var date = formatFunc(new Date(2019, 05, 29)); // -> "29/06/2019"

• day_start (date): Date - сбрасывает временную часть указанной даты на 00:00:00. Алиас метода date_part. Используется в Дневном представлении для установки отображаемой даты и может быть переопределен для обеспечения поведения по умолчанию
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30:10 -> 29 июня, 2019 00:00:00
  var date = gantt.date.day_start(new Date(2019, 05, 29, 14, 30, 10));

• getISOWeek (date): number - возвращает номер недели по стандарту ISO-8601 для указанной даты, недели начинаются с понедельника
  • date - (Date) объект даты для форматирования

  var week = gantt.date.getISOWeek(new Date(2019, 05, 29));// ->26

• getUTCISOWeek (date): number - возвращает номер недели для даты, предварительно преобразовав местное время в UTC
  • date - (Date) объект даты для форматирования

  var week = gantt.date.getUTCISOWeek(new Date(2019, 05, 29));// ->26

• getWeek (date): number - возвращает номер недели для указанной даты. Недели начинаются либо с понедельника, либо с воскресенья, в зависимости от значения свойства start_on_monday.
  • date - (Date) объект даты для форматирования

  // недели начинаются с воскресенья
  gantt.config.start_on_monday = false;
   
  var isoWeek = gantt.date.getISOWeek(new Date(2019, 2, 25)); // ->12
  var week = gantt.date.getWeek(new Date(2019, 2, 25)); // ->13

• month_start (date): Date - возвращает объект Date первого дня месяца для указанной даты и обнуляет временную часть
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30 -> 01 июня, 2019 00:00
  var firstDay = gantt.date.month_start(new Date(2019, 05, 29, 14, 30));

• parseDate (date, format): Date - преобразует строку указанного формата в объект Date
  • date - (string) дата в виде строки
  • format - (string) формат даты (см. Спецификация Формата Даты)

  var date = gantt.date.parseDate("29/06/2019","%d/%m/%Y");//-> 29 июня, 2019 00:00:00

• str_to_date (format, utc): Function - возвращает функцию, которая преобразует строку указанного формата в объект Date
  • format - (string) формат даты (см. Спецификация Формата Даты)
  • utc? - (boolean) указывает, следует ли преобразовать местное время в UTC

  var formatFunc = gantt.date.str_to_date("%d/%m/%Y");
  var date = formatFunc("29/06/2019"); // -> 29 июня, 2019 00:00:00

• time_part (date): number - возвращает время объекта Date в виде количества секунд, прошедших с полуночи (00:00:00)
  • date - (Date) объект даты для форматирования

  var time = gantt.date.time_part(new Date(2019, 05, 29, 14, 30, 10));

• to_fixed (num): string - добавляет ведущий ноль к числам меньше 10 и возвращает результат в виде строки. Не влияет на числа от 10
  • num - (number) число для форматирования

  var num1 = gantt.date.to_fixed(2);// ->"02"
  var num2 = gantt.date.to_fixed(10);// ->10

• minute_start (date): Date - возвращает объект Date для указанной даты и обнуляет часть секунд
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30:10 -> 29 июня, 2019 14:30:00
  var date = gantt.date.minute_start(new Date(2019, 05, 29, 14, 30, 10));

• hour_start (date): Date - возвращает объект Date для указанной даты и обнуляет часть минут и секунд
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30:10 -> 29 июня, 2019 14:00:00
  var date = gantt.date.hour_start(new Date(2019, 05, 29, 14, 30, 10));

• week_start (date): Date - возвращает объект Date для первого дня недели указанной даты и обнуляет временную часть
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30 -> 24 июня, 2019 00:00
  var weekStart = gantt.date.week_start(new Date(2019, 05, 29, 14, 30));

• quarter_start (date): Date - возвращает объект Date для первого месяца квартала указанной даты и обнуляет временную часть
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30:10 -> 01 апреля, 2019 00:00:00
  var date = gantt.date.quarter_start(new Date(2019, 05, 29, 14, 30, 10));

• year_start (date): Date - возвращает объект Date для первого дня года указанной даты и обнуляет временную часть
  • date - (Date) объект даты для форматирования

  //29 июня, 2019 14:30 -> 01 января, 2019 00:00
  var yearStart = gantt.date.year_start(new Date(2019, 05, 29, 14, 30));

К началу