Как использовать Moment.js в Google Apps Script для работы с датами?

/**
 * Создает объект Moment.js с текущей датой и временем.
 * @return {Moment} - Объект Moment.js.
 */
function createMomentNow() {
  return moment();
}

/**
 * Создает объект Moment.js из строки.
 * @param {string} dateString - Строка, представляющая дату (например, '2023-10-27').
 * @param {string} format - Формат даты (например, 'YYYY-MM-DD').
 * @return {Moment} - Объект Moment.js или null, если строка недействительна.
 */
function createMomentFromString(dateString, format) {
  return moment(dateString, format);
}

/**
 * Создает объект Moment.js из объекта Date.
 * @param {Date} dateObject - Объект Date.
 * @return {Moment} - Объект Moment.js.
 */
function createMomentFromDate(dateObject) {
  return moment(dateObject);
}

//Пример
function exampleCreateMoment() {
  let now = createMomentNow();
  Logger.log(now.format('YYYY-MM-DD HH:mm:ss'));

  let fromString = createMomentFromString('2023-11-15', 'YYYY-MM-DD');
  Logger.log(fromString.format('DD.MM.YYYY'));

  let dateObj = new Date();
  let fromDateObj = createMomentFromDate(dateObj);
  Logger.log(fromDateObj.format('YYYY/MM/DD'));
}

/**
 * Форматирует объект Moment.js в строку.
 * @param {Moment} momentObject - Объект Moment.js.
 * @param {string} formatString - Строка формата (например, 'YYYY-MM-DD').
 * @return {string} - Отформатированная строка даты.
 */
function formatMoment(momentObject, formatString) {
  return momentObject.format(formatString);
}

//Пример
function exampleFormatMoment() {
    let now = moment();
    Logger.log(formatMoment(now, 'YYYY-MM-DD HH:mm:ss')); // 2023-10-27 10:30:00 (пример)
    Logger.log(formatMoment(now, 'DD/MM/YYYY')); // 27/10/2023
    Logger.log(formatMoment(now, 'MMMM Do, YYYY')); // October 27th, 2023
}

/**
 * Добавляет дни к объекту Moment.js.
 * @param {Moment} momentObject - Объект Moment.js.
 * @param {number} days - Количество дней для добавления.
 * @return {Moment} - Новый объект Moment.js с добавленными днями.
 */
function addDaysToMoment(momentObject, days) {
  return momentObject.clone().add(days, 'days'); // .clone() чтобы не изменять исходный объект
}

/**
 * Вычитает месяцы из объекта Moment.js.
 * @param {Moment} momentObject - Объект Moment.js.
 * @param {number} months - Количество месяцев для вычитания.
 * @return {Moment} - Новый объект Moment.js с вычтенными месяцами.
 */
function subtractMonthsFromMoment(momentObject, months) {
  return momentObject.clone().subtract(months, 'months');
}

//Пример
function exampleManipulateMoment() {
    let now = moment();
    let tomorrow = addDaysToMoment(now, 1);
    Logger.log(tomorrow.format('YYYY-MM-DD'));

    let lastMonth = subtractMonthsFromMoment(now, 1);
    Logger.log(lastMonth.format('YYYY-MM'));
}

/**
 * Сравнивает два объекта Moment.js и возвращает true, если первая дата раньше второй.
 * @param {Moment} momentObject1 - Первый объект Moment.js.
 * @param {Moment} momentObject2 - Второй объект Moment.js.
 * @return {boolean} - True, если первая дата раньше второй, иначе false.
 */
function isBeforeMoment(momentObject1, momentObject2) {
  return momentObject1.isBefore(momentObject2);
}

/**
 * Сравнивает два объекта Moment.js и возвращает true, если первая дата позже второй.
 * @param {Moment} momentObject1 - Первый объект Moment.js.
 * @param {Moment} momentObject2 - Второй объект Moment.js.
 * @return {boolean} - True, если первая дата позже второй, иначе false.
 */
function isAfterMoment(momentObject1, momentObject2) {
  return momentObject1.isAfter(momentObject2);
}

/**
 * Сравнивает два объекта Moment.js и возвращает true, если даты равны.
 * @param {Moment} momentObject1 - Первый объект Moment.js.
 * @param {Moment} momentObject2 - Второй объект Moment.js.
 * @return {boolean} - True, если даты равны, иначе false.
 */
function isEqualMoment(momentObject1, momentObject2) {
  return momentObject1.isSame(momentObject2);
}

//Пример
function exampleCompareMoment() {
    let date1 = moment('2023-10-26', 'YYYY-MM-DD');
    let date2 = moment('2023-10-27', 'YYYY-MM-DD');

    Logger.log(isBeforeMoment(date1, date2)); // true
    Logger.log(isAfterMoment(date1, date2)); // false
    Logger.log(isEqualMoment(date1, date2)); // false
}

function getCurrentDateTime() {
  let now = moment();
  return now.format('YYYY-MM-DD HH:mm:ss');
}

function sendReport() {
  let dateTime = getCurrentDateTime();
  //Код для отправки отчета с указанием времени
  Logger.log("Отчет отправлен: " + dateTime);
}

/**
 * Рассчитывает количество дней между двумя датами.
 * @param {string} startDate - Начальная дата (YYYY-MM-DD).
 * @param {string} endDate - Конечная дата (YYYY-MM-DD).
 * @return {number} - Количество дней между датами.
 */
function calculateDaysBetween(startDate, endDate) {
  let start = moment(startDate, 'YYYY-MM-DD');
  let end = moment(endDate, 'YYYY-MM-DD');
  return end.diff(start, 'days');
}

function analyzeCampaignPerformance(startDate, endDate) {
  let days = calculateDaysBetween(startDate, endDate);
  //Код для анализа кампании за указанный период
  Logger.log("Анализ кампании за " + days + " дней");
}

/**
 * Преобразует дату из формата YYYY-MM-DD в формат DD.MM.YYYY.
 * @param {string} dateString - Дата в формате YYYY-MM-DD.
 * @return {string} - Дата в формате DD.MM.YYYY.
 */
function formatDate(dateString) {
  let date = moment(dateString, 'YYYY-MM-DD');
  return date.format('DD.MM.YYYY');
}

function displayAdStatistics(date) {
  let formattedDate = formatDate(date);
  //Код для отображения статистики за указанную дату
  Logger.log("Статистика за " + formattedDate);
}

/**
 * Возвращает день недели для заданной даты.
 * @param {string} dateString - Дата в формате YYYY-MM-DD.
 * @return {string} - День недели (например, 'Понедельник').
 */
function getDayOfWeek(dateString) {
  let date = moment(dateString, 'YYYY-MM-DD');
  return date.format('dddd'); // 'dddd' возвращает полное название дня недели
}

function scheduleReport(date) {
  let dayOfWeek = getDayOfWeek(date);
  //Код для планирования отправки отчета в определенный день недели
  Logger.log("Отчет запланирован на " + dayOfWeek);
}