Google Apps Script: Как Разобрать Дату и Время? Полное Руководство

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

let now: Date = getCurrentDateTime();
console.log(now);

/**
 * Разбирает строку даты с помощью Date.parse().
 *
 * @param {string} dateString Строка даты.
 * @return {number} Количество миллисекунд или NaN.
 */
function parseDateString(dateString: string): number {
  return Date.parse(dateString);
}

let milliseconds: number = parseDateString("2024-10-27T10:00:00");
console.log(milliseconds); // Выведет количество миллисекунд

/**
 * Разбирает строку даты с использованием Utilities.parseDate().
 *
 * @param {string} dateString Строка даты.
 * @param {string} timeZone Часовой пояс.
 * @param {string} format Формат даты.
 * @return {Date} Объект Date.
 */
function parseDateWithFormat(dateString: string, timeZone: string, format: string): Date {
  return Utilities.parseDate(dateString, timeZone, format);
}

let date: Date = parseDateWithFormat("27.10.2024 10:00:00", "Europe/Moscow", "dd.MM.yyyy HH:mm:ss");
console.log(date); // Выведет разобранную дату

try {
  let date: Date = parseDateWithFormat("invalid date", "Europe/Moscow", "dd.MM.yyyy HH:mm:ss");
  console.log(date);
} catch (e) {
  console.error("Ошибка при разборе даты: " + e);
}

/**
 * Форматирует дату в строку.
 *
 * @param {Date} date Объект Date.
 * @param {string} timeZone Часовой пояс.
 * @param {string} format Формат даты.
 * @return {string} Отформатированная строка даты.
 */
function formatDate(date: Date, timeZone: string, format: string): string {
  return Utilities.formatDate(date, timeZone, format);
}

let now: Date = new Date();
let formattedDate: string = formatDate(now, "Europe/Moscow", "dd.MM.yyyy HH:mm:ss");
console.log(formattedDate); // Выведет текущую дату и время в указанном формате

/**
 * Добавляет дни к дате.
 *
 * @param {Date} date Исходная дата.
 * @param {number} days Количество дней для добавления.
 * @return {Date} Новая дата.
 */
function addDays(date: Date, days: number): Date {
  let newDate: Date = new Date(date);
  newDate.setDate(date.getDate() + days);
  return newDate;
}

let tomorrow: Date = addDays(new Date(), 1);
console.log(tomorrow);

/**
 * Вычисляет разницу в днях между двумя датами.
 *
 * @param {Date} date1 Первая дата.
 * @param {Date} date2 Вторая дата.
 * @return {number} Разница в днях.
 */
function daysBetween(date1: Date, date2: Date): number {
  let diffInMs: number = Math.abs(date2.getTime() - date1.getTime());
  return diffInMs / (1000 * 60 * 60 * 24); // milliseconds -> seconds -> minutes -> hours -> days
}

let days: number = daysBetween(new Date("2024-10-26"), new Date("2024-10-27"));
console.log(days); // Выведет 1

/**
 * Возвращает день недели.
 *
 * @param {Date} date Дата.
 * @return {number} День недели (0-6).
 */
function getDayOfWeek(date: Date): number {
  return date.getDay();
}

let dayOfWeek: number = getDayOfWeek(new Date());
console.log(dayOfWeek); // Выведет день недели

/**
 * Разбирает даты из Google Sheets.
 */
function parseDatesFromSheet(): void {
  let ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  let sheet: GoogleAppsScript.Spreadsheet.Sheet = ss.getActiveSheet();
  let data: any[][] = sheet.getDataRange().getValues();

  // Предполагаем, что даты находятся в первом столбце (индекс 0).
  for (let i: number = 1; i < data.length; i++) { // Начинаем с 1, чтобы пропустить заголовки.
    let dateString: string = data[i][0];
    try {
      let date: Date = Utilities.parseDate(dateString, Session.getTimeZone(), "dd.MM.yyyy");
      console.log(date);
      // Здесь можно выполнять другие действия с датой, например, записывать в другой столбец.
    } catch (e) {
      console.error("Ошибка при разборе даты в строке " + (i + 1) + ": " + e);
    }
  }
}

/**
 * Форматирует дату при записи в Google Sheets.
 *
 * @param {GoogleAppsScript.Events.SheetsOnEditEvent} e Объект события onEdit.
 */
function onEdit(e: GoogleAppsScript.Events.SheetsOnEditEvent): void {
  let sheet: GoogleAppsScript.Spreadsheet.Sheet = e.range.getSheet();
  let column: number = e.range.getColumn();
  let row: number = e.range.getRow();
  let value: any = e.value;

  // Предполагаем, что столбец с датами - второй (индекс 2).
  if (column === 2) {
    try {
      let date: Date = new Date(value);
      let formattedDate: string = Utilities.formatDate(date, Session.getTimeZone(), "dd.MM.yyyy");
      sheet.getRange(row, column).setValue(formattedDate);
    } catch (e) {
      // Обработка ошибок, если введенное значение не является датой.
      console.error("Ошибка при форматировании даты: " + e);
    }
  }
}

/**
 * Преобразует дату в формат ISO 8601.
 *
 * @param {Date} date Дата.
 * @return {string} Дата в формате ISO 8601.
 */
function convertToISO8601(date: Date): string {
  return Utilities.formatDate(date, "UTC", "yyyy-MM-dd'T'HH:mm:ss'Z'");
}

let isoDate: string = convertToISO8601(new Date());
console.log(isoDate);