date

набор утилит для форматирования date

Объект date предоставляет множество методов для работы с date:

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

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

• add_quarter (date, number): Date — добавляет или вычитает указанное количество кварталов (по 3 месяца) к date
  • date — (Date) date для корректировки
  • number — (number) количество кварталов для добавления (положительное) или вычитания (отрицательное)

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

• convert_to_utc (date): Date — преобразует локальное время в UTC
  • date — (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) date для копирования

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

• date_part (date): Date — сбрасывает время date до полуночи (00:00:00)
  • date — (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) желаемый формат date (см. Спецификация формата даты)
  • 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 — устанавливает время date в полночь, то же что и date_part. Используется в Day view для определения отображаемой даты, может быть переопределен
  • date — (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 — (Date) date для вычисления

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

• getUTCISOWeek (date): number — возвращает номер недели для date после конвертации локального времени в UTC
  • date — (Date) date для вычисления

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

• getWeek (date): number — возвращает номер недели для date, недели могут начинаться с понедельника или воскресенья в зависимости от настройки в start_on_monday
  • date — (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 — (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) строка с date
  • format — (string) формат строки с date (см. Спецификация формата даты)

  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) ожидаемый формат date (см. Спецификация формата даты)
  • 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 в секундах, прошедших с полуночи
  • date — (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) 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) 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) 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) 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) date для корректировки

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

К началу