Google Apps Script: Как получить текущую дату и время?

/**
 * Получает текущую дату и время сервера.
 * @returns {Date} Объект Date, представляющий текущий момент.
 */
function getCurrentDateTime(): Date {
  const now: Date = new Date();
  Logger.log(now); // Выведет дату и время в лог
  return now;
}

/**
 * Демонстрирует получение идентификаторов временных зон.
 */
function logTimeZones(): void {
  const scriptTimeZone: string = Session.getScriptTimeZone();
  Logger.log(`Временная зона скрипта: ${scriptTimeZone}`);

  try {
    // Требует разрешения, может не работать в некоторых контекстах (например, из пользовательской функции Sheets без явного вызова)
    const userTimeZone: string = Session.getActiveUser().getTimeZone();
    Logger.log(`Временная зона пользователя: ${userTimeZone}`);
  } catch (e) {
    Logger.log(`Не удалось получить временную зону пользователя: ${e}`);
  }
}

/**
 * Получает текущую дату и время (объект Date).
 * @returns {Date} Текущая дата и время.
 */
function getNow(): Date {
  return new Date(); 
}

/**
 * Форматирует текущую дату и время для разных сценариев.
 */
function formatCurrentDateTime(): void {
  const now: Date = new Date();
  const scriptTimeZone: string = Session.getScriptTimeZone(); // Например, 'America/New_York'
  const moscowTimeZone: string = 'Europe/Moscow';

  // Формат ISO 8601 в временной зоне скрипта
  const formattedDefault: string = Utilities.formatDate(now, scriptTimeZone, 'yyyy-MM-dd HH:mm:ss');
  Logger.log(`Формат по умолчанию (${scriptTimeZone}): ${formattedDefault}`);

  // Формат для России (Москва)
  const formattedMoscow: string = Utilities.formatDate(now, moscowTimeZone, 'dd.MM.yyyy HH:mm:ss');
  Logger.log(`Формат для Москвы (${moscowTimeZone}): ${formattedMoscow}`);

  // Только дата
  const formattedDateOnly: string = Utilities.formatDate(now, scriptTimeZone, 'yyyy-MM-dd');
  Logger.log(`Только дата (${scriptTimeZone}): ${formattedDateOnly}`);

  // Дата с полным названием дня недели и месяца (локализация зависит от среды)
  const formattedFull: string = Utilities.formatDate(now, scriptTimeZone, 'EEEE, d MMMM yyyy HH:mm');
  Logger.log(`Полный формат (${scriptTimeZone}): ${formattedFull}`); 
}

/**
 * Записывает текущую временную метку и сообщение в активный лист Google Sheets.
 * @param {string} message Сообщение для записи.
 * @param {string} timeZone Целевая временная зона.
 */
function logToSheet(message: string, timeZone: string = Session.getScriptTimeZone()): void {
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = SpreadsheetApp.getActiveSheet();
  const now: Date = new Date();
  const timestamp: string = Utilities.formatDate(now, timeZone, 'yyyy-MM-dd HH:mm:ss');
  
  // Добавляет новую строку с временной меткой и сообщением
  sheet.appendRow([timestamp, message]); 
}

// Пример вызова: logToSheet('Запуск процесса обработки данных');

/**
 * Создает событие в Google Calendar, начинающееся через час от текущего момента.
 * @param {string} title Название события.
 * @param {string} calendarId ID календаря (или 'primary' для основного).
 */
function scheduleEventFromNow(title: string, calendarId: string = 'primary'): void {
  const calendar: GoogleAppsScript.Calendar.Calendar = CalendarApp.getCalendarById(calendarId);
  const now: Date = new Date();
  
  // Время начала: сейчас + 1 час (3600 секунд * 1000 миллисекунд)
  const startTime: Date = new Date(now.getTime() + 60 * 60 * 1000);
  // Время окончания: начало + 1 час
  const endTime: Date = new Date(startTime.getTime() + 60 * 60 * 1000);

  try {
    const event: GoogleAppsScript.Calendar.CalendarEvent = calendar.createEvent(title, startTime, endTime);
    Logger.log(`Событие создано: ${event.getTitle()} (ID: ${event.getId()})`);
  } catch (e) {
    Logger.log(`Ошибка создания события: ${e}`);
  }
}

// Пример вызова: scheduleEventFromNow('Срочное совещание по PPC-кампании');

/**
 * Создает копию файла в Google Drive с добавлением временной метки к имени.
 * @param {string} fileId ID исходного файла.
 * @param {string} targetFolderId ID папки для сохранения копии.
 */
function backupFileWithTimestamp(fileId: string, targetFolderId: string): void {
  try {
    const file: GoogleAppsScript.Drive.File = DriveApp.getFileById(fileId);
    const folder: GoogleAppsScript.Drive.Folder = DriveApp.getFolderById(targetFolderId);
    const now: Date = new Date();
    const timeZone: string = Session.getScriptTimeZone();
    const timestamp: string = Utilities.formatDate(now, timeZone, 'yyyyMMdd_HHmmss');
    const newName: string = `${file.getName()}_backup_${timestamp}`;

    const copiedFile: GoogleAppsScript.Drive.File = file.makeCopy(newName, folder);
    Logger.log(`Создана копия файла: ${copiedFile.getName()} (ID: ${copiedFile.getId()}) в папке ${folder.getName()}`);
  } catch (e) {
    Logger.log(`Ошибка копирования файла: ${e}`);
  }
}

// Пример вызова: backupFileWithTimestamp('ID_ВАШЕГО_ФАЙЛА', 'ID_ПАПКИ_НАЗНАЧЕНИЯ');

// Предварительно нужно добавить библиотеку Moment.js в проект
// Идентификатор скрипта: 15I5UtU-rcMgcomponenta_EuqFEG2zYm339e8U-B0KeU4eiFAWQxh-e-klt3_

/**
 * Демонстрация использования Moment.js (требуется подключенная библиотека).
 */
function demoMomentLib(): void {
  if (typeof Moment === 'undefined') {
    Logger.log('Библиотека Moment.js не подключена.');
    return;
  }
  const now = Moment(); // Текущий момент
  const scriptTimeZone = Session.getScriptTimeZone();
  
  // Форматирование с использованием Moment.js (в зоне скрипта)
  Logger.log(`Moment Формат: ${now.tz(scriptTimeZone).format('YYYY-MM-DD HH:mm:ss Z')}`); 

  // Добавление 7 дней
  const nextWeek = Moment().add(7, 'days');
  Logger.log(`Через неделю: ${nextWeek.format('DD.MM.YYYY')}`);

  // Относительное время
  const pastDate = Moment('2023-01-01');
  Logger.log(`Дата ${pastDate.format('YYYY-MM-DD')} была ${pastDate.fromNow()}`);
}

/**
 * Пример оптимизации: форматирование даты вне цикла.
 * @param {string[][]} data Массив данных для записи.
 * @param {string} timeZone Целевая временная зона.
 */
function optimizedLogBatchToSheet(data: string[][], timeZone: string = Session.getScriptTimeZone()): void {
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = SpreadsheetApp.getActiveSheet();
  const now: Date = new Date();
  const timestamp: string = Utilities.formatDate(now, timeZone, 'yyyy-MM-dd HH:mm:ss');
  
  const rowsToAdd: string[][] = data.map(row => [timestamp, ...row]);
  
  if (rowsToAdd.length > 0) {
    sheet.getRange(sheet.getLastRow() + 1, 1, rowsToAdd.length, rowsToAdd[0].length).setValues(rowsToAdd);
    Logger.log(`Добавлено ${rowsToAdd.length} строк с временной меткой ${timestamp}`);
  } else {
    Logger.log('Нет данных для добавления.');
  }
}

// Пример вызова: 
// const analyticsData = [['Campaign A', '100', '10'], ['Campaign B', '250', '25']];
// optimizedLogBatchToSheet(analyticsData);