date

Description

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

date: SchedulerDateHelpers

Details

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

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

// добавляет 1 год к указанной дате: 29 июня 2027 -> 29 июня 2028
const newDate = scheduler.date.add(new Date(2027, 5, 29), 1, 'year');

• convert_to_utc() - конвертирует локальное время в UTC
  • date - (Date) объект даты, который нужно сконвертировать

//29 июня 2027 14:00 (локальное время) -> 29 июня 2027 12:00 (UTC)
const time = scheduler.date.convert_to_utc(new Date(2027, 5, 29, 14, 0));

• copy() - создает копию объекта Date
  • date - (Date) объект даты, который нужно скопировать

const copy = scheduler.date.copy(new Date(2027, 5, 29)); // -> 29 июня 2027

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

//29 июня 2027 14:30:10 -> 29 июня 2027 00:00:00
const date = scheduler.date.date_part(new Date(2027, 5, 29, 14, 30, 10));

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

const formatFunc = scheduler.date.date_to_str("%d/%m/%Y");
const date = formatFunc(new Date(2027, 5, 29)); // -> "29/06/2027"

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

// 29 июня 2027 14:30:10 -> 29 июня 2027 00:00:00
const date = scheduler.date.day_start(new Date(2027, 5, 29, 14, 30, 10));

Примечание: передаваемая в метод дата фактически будет изменена. Чтобы предотвратить изменение исходной даты, оберните входную дату в new Date() . Например:

const originalDate = new Date(2027, 5, 29, 14, 30, 10);
const dayStartDate = scheduler.date.day_start(new Date(originalDate));

• getISOWeek() - возвращает номер недели даты
  • date - (Date) объект даты, который нужно форматировать

const week = scheduler.date.getISOWeek(new Date(2027, 5, 29)); // -> 26

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

const week = scheduler.date.getUTCISOWeek(new Date(2027, 5, 29)); // -> 26

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

// 29 июня 2027 14:30 -> 01 июня 2027 00:00
const firstDay = scheduler.date.month_start(new Date(2027, 5, 29, 14, 30));

• str_to_date() - возвращает функцию, которая преобразует строку заданного формата в объект Date Параметры: format - (string) формат даты (см. Date Format Specification) utc - (boolean) указывает, нужно ли локальное время конвертировать в UTC parseExact - (boolean) определяет, распознает ли Scheduler формат даты автоматически (false, по умолчанию) или использует формат, переданный пользователем (true)

const formatFunc = scheduler.date.str_to_date("%d/%m/%Y");
const date = formatFunc("29/06/2027"); // -> 29 июня 2027 00:00:00

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

const time = scheduler.date.time_part(new Date(2027, 5, 29, 14, 30, 10));
 // time -> 52210

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

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

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

// 29 июня 2027 14:30 -> 28 июня 2027 00:00
const weekStart = scheduler.date.week_start(new Date(2027, 5, 29, 14, 30));

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

// 29 июня 2027 14:30 -> 01 июня 2027 00:00
const yearStart = scheduler.date.year_start(new Date(2027, 5, 29, 14, 30));