Initial commit (version 1.0)

Author: Pedro H

README.md

@@ -3,7 +3,7 @@ Unique and original calendar/task organizer spreadsheet template.
 
 ## To-do
 - [x] Google Sheets compatible;
-  - [ ] Apps Script autorun trigger;
+  - [x] Apps Script autorun trigger;
 - [ ] LibreOffice/OpenOffice Calc (.ods) compatible;
 - [ ] Microsoft Excel (.xlsx) compatible;
 

sheets/Calendario-1.0.url

@@ -0,0 +1,5 @@
+[{000214A0-0000-0000-C000-000000000046}]
+Prop3=19,11
+[InternetShortcut]
+IDList=
+URL=https://docs.google.com/spreadsheets/d/1d1RFg44j5Ls4eoM9p6Ud4sZRzNaMkRAwsUDxzFm0vZM/edit?usp=sharing

src/sheets/appsscript.json

@@ -0,0 +1,7 @@
+{
+    "timeZone": "America/Sao_Paulo",
+    "dependencies": {
+    },
+    "exceptionLogging": "STACKDRIVER",
+    "runtimeVersion": "V8"
+  }

src/sheets/main.gs

@@ -0,0 +1,53 @@
+/**
+ * @file    main.gs
+ * @brief   Describes the routines to follow in order to retrieve the upcoming events' respective dates.
+ * @author  Pedro Henrique Pinto de Oliveira
+ * @date    2024-03-04
+ */
+
+/* Constants */
+const ss = SpreadsheetApp.getActiveSpreadsheet();         // gets spreadsheet
+const mainSheet = ss.getSheets()[0];                      // gets first sheet
+const globalUpcomingDatesRange = "B3:B1000";              // all the possible cells which can be possibly filled with an event's date
+const todayDay = new Date().getDate();
+const sheet = ss.getSheets()[new Date().getMonth() + 1];  // getMonth() returns 0-11 months, not 1-12
+
+/* Functions */
+function findEvent_returnDate()
+{
+  let data = sheet.getDataRange().getValues();            // macro to retrieve (int row, int col) cell data
+  let nDatesWritten = 0;
+
+  for(let i = (1+todayDay); i <= 32; i++) {
+    // Columns C:G
+
+    for(let j = 3; j <= 7; j++) {
+      if(sheet.getRange(i, j).getValue() == '') {} else {
+        mainSheet.getRange(3 + nDatesWritten, 2).setValue(sheet.getRange(i+1, 1).getValue());
+        nDatesWritten++;
+      }
+    }
+  }
+}
+
+function clearOutdatedEvents()
+{
+  mainSheet.getRange(globalUpcomingDatesRange).clear();
+}
+
+function highlightToday_sEntry()
+{
+  let sheet = ss.getSheets()[new Date().getMonth() + 1];
+  let dd = 2 + new Date().getDate();
+  
+  sheet.getRange(dd-1, 1).setBackgroundRGB(255, 255, 255)
+  sheet.getRange(dd, 1).setBackgroundRGB(255, 255, 0);
+}
+
+function main()
+{
+  console.log(setup(true));
+  highlightToday_sEntry();
+  clearOutdatedEvents();
+  findEvent_returnDate();
+}

src/sheets/setup.gs

@@ -0,0 +1,78 @@
+/**
+ * @file    setup.gs
+ * @brief   This run once script creates sample events for the next three days to help users understand the functionality.
+ * @author  Pedro Henrique Pinto de Oliveira
+ * @date    2024-03-16
+ */
+
+/* Constants */
+// Global scope constants borrowed from main.gs
+const entry_firstEventColumn = 3;
+const tableHeader_rowValue_offset = 2;
+
+/* Functions */
+function is_LeapYear(year)
+{
+  if(year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0))
+  {
+    return true;
+  }
+  return false;
+}
+
+function find_AmountOfDaysLeftInMonth(date, month, year)
+{
+  switch (month){
+    case 1:
+    case 3:
+    case 5:
+    case 7:
+    case 8:
+    case 10:
+    case 12:
+      return (31 - date);
+    break;
+    case 2:
+      if(is_LeapYear(year)){
+        return (29 - date);
+      }
+      return (28 - date);
+    break;
+    case 4:
+    case 6:
+    case 9:
+    case 11:
+      return (30 - date);
+    break;
+    default:
+    break;
+  }
+}
+
+function setup(mainFunctionCall) {
+  // If sheet already contains values, must NOT setup
+  if(!(mainSheet.getRange(3, 2).isBlank())) return false;
+
+  const sampleEvents = ["Evento 1", "Evento 2", "Evento 3"];
+
+  let year = new Date().getFullYear();
+  let month = new Date().getMonth() + 1;                                      // returns 0-11 months
+  let nextMonth = month + 1;
+  let date = new Date().getDate();
+  let amount = find_AmountOfDaysLeftInMonth(date, month, year);
+
+  for(let i = date + tableHeader_rowValue_offset; i < (date+amount); i++){
+    if(sampleEvents.length === 0) break;
+    sheet.getRange(i, entry_firstEventColumn).setValue(sampleEvents.shift()); // allows stack-based JavaScript array to behave like a queue
+  }
+  if(amount < 3 && sampleEvents.length === 0){
+    let i = 1 + tableHeader_rowValue_offset;                                  // Begins at '@NextMonth'!C3's address
+    while(sampleEvents.length() > 0){
+      ss.getSheets()[nextMonth].getRange(i, entry_firstEventColumn).setValue(sampleEvents.shift());
+    }
+  }
+
+  if(!mainFunctionCall) main();                                               // If main() didn't call setup(), then main() must be run to findEvent_returnDate()s (might have been onOpen(e) trigger)
+
+  return true;
+}