Google Apps Script: Как добавить дни к дате?

/**
 * Демонстрация создания объекта Date.
 */
function demonstrateDateObject(): void {
  const specificDate: Date = new Date('2023-10-26T10:00:00Z'); // Дата по UTC
  const fromTimestamp: Date = new Date(1678886400000); // Дата из timestamp
  Logger.log('Specific Date: %s', specificDate.toString());
  Logger.log('Date from Timestamp: %s', fromTimestamp.toString());
}

/**
 * Получает и логирует текущую дату и время.
 */
function logCurrentDateTime(): void {
  const now: Date = new Date();
  Logger.log('Текущая дата и время: %s', now);
  // В логах Apps Script дата обычно отображается в часовом поясе сервера
}

/**
 * Добавляет указанное количество дней к дате с использованием setDate().
 *
 * @param {Date} startDate Исходная дата.
 * @param {number} daysToAdd Количество дней для добавления (может быть отрицательным).
 * @return {Date} Новая дата.
 */
function addDaysUsingSetDate(startDate: Date, daysToAdd: number): Date {
  const resultDate = new Date(startDate);
  resultDate.setDate(resultDate.getDate() + daysToAdd);
  return resultDate;
}

/**
 * Пример использования addDaysUsingSetDate.
 */
function testAddDaysSetDate(): void {
  const today: Date = new Date();
  const futureDate: Date = addDaysUsingSetDate(today, 10);
  Logger.log('Сегодня: %s', today);
  Logger.log('Через 10 дней: %s', futureDate);

  const lastDayOfYear: Date = new Date(today.getFullYear(), 11, 31); // 31 декабря
  const nextYearDate: Date = addDaysUsingSetDate(lastDayOfYear, 1);
  Logger.log('Последний день года: %s', lastDayOfYear);
  Logger.log('Плюс 1 день: %s', nextYearDate); // Корректно перейдет на следующий год
}

/**
 * Добавляет указанное количество дней к дате через манипуляции с миллисекундами.
 *
 * @param {Date} startDate Исходная дата.
 * @param {number} daysToAdd Количество дней для добавления.
 * @return {Date} Новая дата.
 */
function addDaysUsingMilliseconds(startDate: Date, daysToAdd: number): Date {
  const millisecondsInDay: number = 24 * 60 * 60 * 1000;
  const startTime: number = startDate.getTime();
  const newTime: number = startTime + (daysToAdd * millisecondsInDay);
  const resultDate = new Date(newTime);
  return resultDate;
}

/**
 * Пример использования addDaysUsingMilliseconds.
 */
function testAddDaysMilliseconds(): void {
  const today: Date = new Date();
  const futureDate: Date = addDaysUsingMilliseconds(today, 7);
  Logger.log('Сегодня: %s', today);
  Logger.log('Через 7 дней (мс): %s', futureDate);
}

/**
 * Добавляет дни и форматирует результат для указанного часового пояса.
 *
 * @param {Date} startDate Исходная дата.
 * @param {number} daysToAdd Количество дней.
 * @param {string} timeZone Целевой часовой пояс (например, 'Europe/Moscow', 'America/New_York').
 * @param {string} format Формат даты (например, 'yyyy-MM-dd HH:mm:ss').
 * @return {string} Отформатированная строка с датой.
 */
function addDaysAndFormat(startDate: Date, daysToAdd: number, timeZone: string, format: string): string {
  // Используем setDate для добавления дней, учитывая локальные календарные дни
  const resultDate: Date = addDaysUsingSetDate(startDate, daysToAdd);

  // Форматируем результат в нужном часовом поясе
  const formattedDate: string = Utilities.formatDate(resultDate, timeZone, format);
  return formattedDate;
}

/**
 * Пример использования addDaysAndFormat.
 */
function testFormatDate(): void {
  const eventStartDate: Date = new Date(); // Текущее время
  const campaignDurationDays: number = 30;
  const timeZone: string = Session.getScriptTimeZone(); // Или указать конкретный
  const dateFormat: string = 'dd.MM.yyyy';

  const campaignEndDateFormatted: string = addDaysAndFormat(eventStartDate, campaignDurationDays, timeZone, dateFormat);
  Logger.log('Дата начала кампании (%s): %s', timeZone, Utilities.formatDate(eventStartDate, timeZone, dateFormat));
  Logger.log('Дата окончания кампании (%s): %s', timeZone, campaignEndDateFormatted);
}

/**
 * Логирует дату, которая наступит через N дней от текущей.
 *
 * @param {number} numberOfDays Количество дней для добавления.
 */
function logFutureDate(numberOfDays: number): void {
  if (typeof numberOfDays !== 'number' || !Number.isInteger(numberOfDays)) {
    Logger.log('Ошибка: Количество дней должно быть целым числом.');
    return;
  }
  const today: Date = new Date();
  const futureDate: Date = addDaysUsingSetDate(today, numberOfDays);
  const timeZone: string = Session.getScriptTimeZone();
  const format: string = 'yyyy-MM-dd';

  Logger.log('Текущая дата: %s', Utilities.formatDate(today, timeZone, format));
  Logger.log('Дата через %s дней: %s', numberOfDays, Utilities.formatDate(futureDate, timeZone, format));
}

// Вызов примера
// logFutureDate(15);

/**
 * Добавляет указанное количество дней к дате. Работает как пользовательская функция в Google Sheets.
 *
 * @param {Date | string | number} dateInput Исходная дата (может быть датой, строкой или числом из ячейки).
 * @param {number} daysToAdd Количество дней для добавления.
 * @return {Date} Новая дата.
 * @customfunction
 */
function ADD_DAYS(dateInput: any, daysToAdd: number): Date | string {
  if (daysToAdd === null || daysToAdd === undefined || typeof daysToAdd !== 'number') {
    return '#ERROR: Количество дней (второй аргумент) должно быть числом.';
  }

  let startDate: Date;
  try {
    // Пытаемся преобразовать входное значение в дату
    startDate = new Date(dateInput);
    // Проверяем, является ли результат валидной датой
    if (isNaN(startDate.getTime())) {
      throw new Error('Некорректный формат даты.');
    }
  } catch (e) {
    return `#ERROR: Не удалось распознать дату (первый аргумент). ${e.message}`;
  }

  const resultDate = new Date(startDate);
  resultDate.setDate(resultDate.getDate() + daysToAdd);
  return resultDate; // Sheets автоматически отформатирует как дату
}

/**
 * Создает событие в Google Calendar на N дней, начиная с завтрашнего дня.
 *
 * @param {string} calendarId ID календаря для добавления события.
 * @param {string} eventTitle Название события.
 * @param {number} durationDays Длительность события в днях.
 */
function createMultiDayEvent(calendarId: string, eventTitle: string, durationDays: number): void {
  if (typeof durationDays !== 'number' || durationDays <= 0 || !Number.isInteger(durationDays)) {
    Logger.log('Ошибка: Длительность должна быть положительным целым числом дней.');
    return;
  }

  const tomorrow: Date = new Date();
  tomorrow.setDate(tomorrow.getDate() + 1);
  // Устанавливаем время на начало дня для события на весь день
  tomorrow.setHours(0, 0, 0, 0);

  const endDate: Date = new Date(tomorrow);
  // Добавляем дни. Для событий 'all-day' конечная дата не включается,
  // поэтому если событие длится N дней, конечная дата должна быть N дней спустя.
  endDate.setDate(endDate.getDate() + durationDays);

  // Даты для Calendar API лучше передавать в формате 'yyyy-MM-dd'
  const startDateStr: string = Utilities.formatDate(tomorrow, Session.getScriptTimeZone(), 'yyyy-MM-dd');
  const endDateStr: string = Utilities.formatDate(endDate, Session.getScriptTimeZone(), 'yyyy-MM-dd');

  try {
    const event = CalendarApp.getCalendarById(calendarId).createAllDayEvent(eventTitle, new Date(startDateStr), new Date(endDateStr));
    Logger.log('Событие создано: ID %s, Начало: %s, Конец: %s', event.getId(), startDateStr, endDateStr);
  } catch (e) {
    Logger.log('Не удалось создать событие: %s', e);
  }
}

// Пример вызова (замените 'primary' на нужный ID календаря)
// createMultiDayEvent('primary', 'Маркетинговая кампания X', 5);

/**
 * Безопасно добавляет дни к дате, полученной из внешнего источника.
 *
 * @param {any} dateInput Потенциально некорректный ввод даты.
 * @param {any} daysInput Потенциально некорректный ввод количества дней.
 * @return {Date | null} Новая дата или null в случае ошибки.
 */
function safeAddDays(dateInput: any, daysInput: any): Date | null {
  let startDate: Date;
  let daysToAdd: number;

  // Валидация количества дней
  if (typeof daysInput !== 'number' || isNaN(daysInput)) {
    console.error('Ошибка: Количество дней должно быть числом.');
    return null;
  }
  daysToAdd = daysInput; // Можно добавить округление, если нужны целые дни

  // Валидация и создание даты
  try {
    startDate = new Date(dateInput);
    if (isNaN(startDate.getTime())) {
      throw new Error('Некорректное значение даты.');
    }
  } catch (e) {
    console.error('Ошибка обработки входной даты:', e.message);
    return null;
  }

  // Выполнение операции
  const resultDate = new Date(startDate);
  resultDate.setDate(resultDate.getDate() + daysToAdd);

  return resultDate;
}

// Пример вызова с обработкой
const inputDate = '2023-12-25';
const inputDays = '10'; // Строка, но будет приведена к числу
const result = safeAddDays(inputDate, Number(inputDays));

if (result) {
  Logger.log('Успех! Новая дата: %s', result);
} else {
  Logger.log('Не удалось добавить дни из-за ошибки входных данных.');
}

const invalidResult = safeAddDays('не дата', 5);
if (!invalidResult) {
   Logger.log('Обработка ошибки некорректной даты прошла успешно.');
}