⛓️ ☪️ 🙍🏽 Google Apps Script: mentransfer jadwal dari spreadsheet ke kalender 💪🏾 👌🏻 😦

Untuk siapa artikel ini?

Untuk orang-orang yang secara aktif menggunakan layanan Google Kalender
Untuk orang-orang yang memiliki file tabel dengan jadwal dan yang ingin bekerja dengan mereka secara lebih produktif - selalu ada acara yang akan datang di depan mata mereka, terima pemberitahuan dengan pengingat melalui surat atau pemberitahuan push
Bagi orang yang ingin mengetahui Google Apps Script dengan cepat, memahami apa itu Skrip Google, dan di mana itu dapat diterapkan

Apa yang dibutuhkan

akun Google
Pengetahuan dasar JavaScript

1. Buat tabel di Google Sheets

Ini dapat dilakukan dengan membuka halaman Google Drive Anda.

Angka: 1. Mengklik kanan pada ruang kerja membuka menu konteks di mana Anda perlu memilih "Google Sheets" - "Buat tabel kosong"

Di tabel yang dibuat, Anda perlu menyalin jadwal yang Anda miliki, dalam kasus saya, ini adalah jadwal kelas di universitas. Penting bahwa tabel berisi bidang berikut ini:

judul acara
Tanggal Acara
Waktu mulai
Waktu atau durasi berakhir (namun, ini tidak perlu - sebagai hasilnya, Anda dapat menyetel beberapa nilai default umum untuk durasi acara, misalnya, 1 jam, atau bahkan membuat acara berlangsung sepanjang hari)

, — , (, ..), .

. 2.

2.

2.1.

, , .

. 3. , "", " "

JavaScript. myFunction. , SetCalendar.

. 4. , — SetCalendar

, , . SetCalendar.

2.2.

JavaScript :

console.log("Hello, world!")

Google Apps Script . console Logger:

function SetCalendar() {
  Logger.log("Hello, world!");
}

, "", "" Ctrl+Enter:

. 5.

2.3.

function SetCalendar() {
  //         
  const rowStart = 1;
  const colStart = 1;

  //     
  const colsCount = 5;
  const rowsCount = 67;  

  //  
  var sheet = SpreadsheetApp.getActiveSheet();

  //     
  var range = sheet.getRange(rowStart, colStart, rowsCount, colsCount)
  var data = range.getDisplayValues();
}

11.

SpreadsheetApp — , , Google Sheets.

, — , ( ) . getActiveSheet.

sheet.

, range — , . getRange. :

! 1.

15: getDisplayValues.

! getDisplayValues() , . , , - , , .

2.4.

, , , . :

//-   
  const dateCol = 0;
  const timeCol = 1;
  const typeCol = 2;
  const nameCol = 3;
  const teacherCol = 4;

data , . .

  for (var i in data)
  {
    let row = data[i];

    let classDate = row[dateCol];
    let classPeriod = row[timeCol];
    let classType = row[typeCol];
    let className = row[nameCol];
    let classTeacher = row[teacherCol];

    Logger.log("[DATE] " + classDate);
    Logger.log("[PERIOD] " + classPeriod);
    Logger.log("[TYPE] " + classType);
    Logger.log("[NAME] " + className);
    Logger.log("[TEACHER] " + classTeacher);
    Logger.log("============================================");
  }

for i data, i — , .

3: data i row — .

5-9: — . , row[dateCol] — dateCol.

5-9 , , , .

, , .

2.5.

function SetCalendar() {
  //         
  const rowStart = 1;
  const colStart = 1;

  //     
  const colsCount = 5;
  const rowsCount = 8;  

  //  
  var sheet = SpreadsheetApp.getActiveSheet();

  //     
  var range = sheet.getRange(rowStart, colStart, rowsCount, colsCount)
  var data = range.getDisplayValues();

  //-   
  const dateCol = 0;
  const timeCol = 1;
  const typeCol = 2;
  const nameCol = 3;
  const teacherCol = 4;

  for (var i in data)
  {
    let row = data[i];

    let classDate = row[dateCol];
    let classPeriod = row[timeCol];
    let classType = row[typeCol];
    let className = row[nameCol];
    let classTeacher = row[teacherCol];

    Logger.log("[DATE] " + classDate);
    Logger.log("[PERIOD] " + classPeriod);
    Logger.log("[TYPE] " + classType);
    Logger.log("[NAME] " + className);
    Logger.log("[TEACHER] " + classTeacher);
    Logger.log("============================================");
  }
}

, :

. 6.

, , , , . ?

. 7.

, . , , .

, , , .

, :

  let savedDate = "";

  for (var i in data)
  {
    let row = data[i];

    let classDate = row[dateCol];

        //...

    if (classDate.trim() == "")
    {
      classDate = savedDate;
    }
    else
    {
      savedDate = classDate;
    }

    Logger.log("[DATE] " + classDate);
    //...
    Logger.log("============================================");
  }

savedDate — .

. — , savedDate, savedDate.

2.6.

— getDisplayValues(), , , .

, Google Calendar, Date: - , - .

(. 2), dd.mm.yyyy, , , hh:mm-hh.mm.

, Date. Google Apps Script, - . , JS-, - - .

function extractTime(timeStr, dateStr)
{
  let sepIdx = timeStr.indexOf(":");

  let hoursStr = timeStr.substring(0, sepIdx);
  let minsStr = timeStr.substring(sepIdx + 1);

  sepIdx = dateStr.indexOf(".");

  let dayStr = dateStr.substring(0, sepIdx);
  let monthStr = dateStr.substring(sepIdx + 1, sepIdx + 3);

  sepIdx = dateStr.indexOf(".", sepIdx + 1);

  let yearStr = dateStr.substring(sepIdx + 1);

  let t = new Date();
  t.setHours(parseInt(hoursStr), parseInt(minsStr));
  t.setYear(parseInt(yearStr));
  t.setMonth(parseInt(monthStr) - 1, parseInt(dayStr));

  return t;
}

function extractPeriod(periodStr, dateStr)
{
  let sepIdx = periodStr.indexOf("-");

  let fromStr = periodStr.substring(0, sepIdx);
  let toStr = periodStr.substring(sepIdx + 1);

  fromStr = fromStr.trim();
  toStr = toStr.trim();

  return {
    from: extractTime(fromStr, dateStr),
    to: extractTime(toStr, dateStr)
  }
}

- , extractPeriod — , .

2.7. Google Calendar

let classTimeInfo = extractPeriod(classPeriod, classDate);

let classStartTime = classTimeInfo.from;
let classEndTime = classTimeInfo.to;

let info = ": " + classTeacher + "\n : " + classType;

var event = (CalendarApp.getCalendarsByName(""))[0].createEvent
(
  className,
  classStartTime,
  classEndTime,
  {
    description: info
  }
);

Utilities.sleep(50);

1-6: - , , .

, Google Calendar CalendarApp.

getCalendarsByName .

- getDefaultCalendar, . , - Google Calendar , . -, , .

, , , - , - , , , , , , , .

"", . getCalendarsByName "".

, , :

(CalendarApp.getCalendarsByName(""))[0]

- createEvent. :

( )
Data — -
Data — -
— ( — description — )

— 50 . , , , Google Calendar , API .

3.

! , 2. , , , .

function extractTime(timeStr, dateStr)
{
  let sepIdx = timeStr.indexOf(":");

  let hoursStr = timeStr.substring(0, sepIdx);
  let minsStr = timeStr.substring(sepIdx + 1);

  sepIdx = dateStr.indexOf(".");

  let dayStr = dateStr.substring(0, sepIdx);
  let monthStr = dateStr.substring(sepIdx + 1, sepIdx + 3);

  sepIdx = dateStr.indexOf(".", sepIdx + 1);

  let yearStr = dateStr.substring(sepIdx + 1);

  let t = new Date();
  t.setHours(parseInt(hoursStr), parseInt(minsStr));
  t.setYear(parseInt(yearStr));
  t.setMonth(parseInt(monthStr) - 1, parseInt(dayStr));

  return t;
}

function extractPeriod(periodStr, dateStr)
{
  let sepIdx = periodStr.indexOf("-");

  let fromStr = periodStr.substring(0, sepIdx);
  let toStr = periodStr.substring(sepIdx + 1);

  fromStr = fromStr.trim();
  toStr = toStr.trim();

  return {
    from: extractTime(fromStr, dateStr),
    to: extractTime(toStr, dateStr)
  }
}

function SetCalendar() {
  //         
  const rowStart = 1;
  const colStart = 1;

  //     
  const colsCount = 5;
  const rowsCount = 8;  

  //  
  var sheet = SpreadsheetApp.getActiveSheet();

  //     
  var range = sheet.getRange(rowStart, colStart, rowsCount, colsCount)
  var data = range.getDisplayValues();

  //-   
  const dateCol = 0;
  const timeCol = 1;
  const typeCol = 2;
  const nameCol = 3;
  const teacherCol = 4;

  let savedDate = "";

  for (var i in data)
  {
    let row = data[i];

    let classDate = row[dateCol];
    let classPeriod = row[timeCol];
    let classType = row[typeCol];
    let className = row[nameCol];
    let classTeacher = row[teacherCol];

    if (classDate.trim() == "")
    {
      classDate = savedDate;
    }
    else
    {
      savedDate = classDate;
    }

    let classTimeInfo = extractPeriod(classPeriod, classDate);

    let classStartTime = classTimeInfo.from;
    let classEndTime = classTimeInfo.to;

    let info = ": " + classTeacher + "\n : " + classType;

    var event = (CalendarApp.getCalendarsByName(""))[0].createEvent
    (
      className,
      classStartTime,
      classEndTime,
      {
        description: info
      }
    );

    Utilities.sleep(50);
  }
}

4.

— , , , ( ). , API Google Sheets Google Apps Script , ;
JavaScript, , - .

Saya terbuka untuk kritik yang membangun, saya akan senang jika Anda menunjukkan kekurangannya, memberi saran apa yang bisa diperbaiki dan apa yang bisa diubah dalam artikel.

Google Apps Script: mentransfer jadwal dari spreadsheet ke kalender