Google Apps Script: Как установить формат ячейки в Google Sheets?

/**
 * Пример установки числового формата для ячейки.
 * @param {string} sheetName - Имя листа.
 * @param {number} row - Номер строки (начиная с 1).
 * @param {number} column - Номер столбца (начиная с 1).
 * @param {string} format - Строка формата.
 */
function setCellNumberFormat(sheetName: string, row: number, column: number, format: string): void {
  // Получаем активную таблицу.
  const spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // Получаем лист по имени.
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = spreadsheet.getSheetByName(sheetName);

  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    return;
  }

  // Получаем ячейку.
  const cell: GoogleAppsScript.Spreadsheet.Range = sheet.getRange(row, column);
  // Устанавливаем формат.
  cell.setNumberFormat(format);
}

// Пример использования:
// setCellNumberFormat("Лист1", 1, 1, "#,##0.00");

/**
 * Пример установки формата даты для ячейки.
 * @param {string} sheetName - Имя листа.
 * @param {number} row - Номер строки (начиная с 1).
 * @param {number} column - Номер столбца (начиная с 1).
 * @param {string} format - Строка формата даты.
 */
function setCellDateFormat(sheetName: string, row: number, column: number, format: string): void {
  const spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = spreadsheet.getSheetByName(sheetName);

  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    return;
  }

  const cell: GoogleAppsScript.Spreadsheet.Range = sheet.getRange(row, column);
  cell.setNumberFormat(format);
}

// Пример использования:
// setCellDateFormat("Лист1", 2, 1, "yyyy-MM-dd");

/**
 * Пример установки условного форматирования.
 * @param {string} sheetName - Имя листа.
 * @param {number} row - Номер строки начала диапазона (начиная с 1).
 * @param {number} column - Номер столбца начала диапазона (начиная с 1).
 * @param {number} numRows - Количество строк в диапазоне.
 * @param {number} numColumns - Количество столбцов в диапазоне.
 * @param {number} conditionColumn - Номер столбца, на основании которого применяется условие.
 * @param {string} conditionValue - Значение условия.
 * @param {string} backgroundColor - Цвет фона, если условие выполнено.
 */
function setConditionalFormatting(sheetName: string, row: number, column: number, numRows: number, numColumns: number, conditionColumn: number, conditionValue: string, backgroundColor: string): void {
  const spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = spreadsheet.getSheetByName(sheetName);

  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    return;
  }

  const range: GoogleAppsScript.Spreadsheet.Range = sheet.getRange(row, column, numRows, numColumns);
  const rule: GoogleAppsScript.Spreadsheet.ConditionalFormatRule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo(conditionValue)
    .setBackground(backgroundColor)
    .setRanges([range])
    .build();

  const rules: GoogleAppsScript.Spreadsheet.ConditionalFormatRule[] = sheet.getConditionalFormatRules();
  rules.push(rule);
  sheet.setConditionalFormatRules(rules);
}

// Пример использования:
// setConditionalFormatting("Лист1", 1, 1, 10, 1, 1, "Больше 100", "red");

/**
 * Автоматически форматирует столбец с датами.
 */
function onEdit(e: GoogleAppsScript.Events.SheetsOnEditEvent): void {
  const sheetName: string = "Данные";
  const dateColumn: number = 3; // Столбец с датами (C).
  const dateFormat: string = "yyyy-MM-dd";

  const sheet: GoogleAppsScript.Spreadsheet.Sheet = e.range.getSheet();

  if (sheet.getName() !== sheetName || e.range.getColumn() !== dateColumn) {
    return;
  }

  const row: number = e.range.getRow();
  const value: any = e.value;

  // Проверяем, что значение является датой.
  if (value instanceof Date) {
    sheet.getRange(row, dateColumn).setNumberFormat(dateFormat);
  }
}

/**
 * Устанавливает формат в зависимости от значения.
 * @param {string} sheetName - Имя листа.
 * @param {number} row - Номер строки (начиная с 1).
 * @param {number} column - Номер столбца (начиная с 1).
 */
function formatByValue(sheetName: string, row: number, column: number): void {
  const spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = spreadsheet.getSheetByName(sheetName);

    if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    return;
  }

  const cell: GoogleAppsScript.Spreadsheet.Range = sheet.getRange(row, column);
  const value: number = cell.getValue();

  if (value > 1000) {
    cell.setNumberFormat("#,##0.00");
  } else {
    cell.setNumberFormat("0.00");
  }
}