Пример сценария сценариев Office: кнопка "Перфорация часов"

Идея сценария и сценарий, используемые в этом примере, были приведены участником сообщества Сценариев Office Брайаном Гонсалесом.

В этом сценарии вы создадите для сотрудника лист времени, который позволяет ему записывать время начала и окончания с помощью кнопки. В зависимости от того, что было записано ранее, нажатие кнопки приведет к началу дня (часы в) или к концу дня (часы).

Инструкции по настройке

1. Скачайте пример книги в OneDrive.

   Скачивание примера книги

   

2. Откройте книгу в Excel.

3. На вкладке Автоматизация выберите Создать скрипт и вставьте следующий скрипт в редактор.

   /**
    * This script records either the start or end time of a shift, 
    * depending on what is filled out in the table. 
    * It is intended to be used with a Script Button.
    */
   function main(workbook: ExcelScript.Workbook) {
     // Get the first table in the timesheet.
     const timeSheet = workbook.getWorksheet("MyTimeSheet");
     const timeTable = timeSheet.getTables()[0];
   
     // Get the appropriate table columns.
     const clockInColumn = timeTable.getColumnByName("Clock In");
     const clockOutColumn = timeTable.getColumnByName("Clock Out");
     const durationColumn = timeTable.getColumnByName("Duration");
   
     // Get the last rows for the Clock In and Clock Out columns.
     let clockInLastRow = clockInColumn.getRangeBetweenHeaderAndTotal().getLastRow();
     let clockOutLastRow = clockOutColumn.getRangeBetweenHeaderAndTotal().getLastRow();
   
     // Get the current date to use as the start or end time.
     let date: Date = new Date();
   
     // Add the current time to a column based on the state of the table.
     if (clockInLastRow.getValue() as string === "") {
       // If the Clock In column has an empty value in the table, add a start time.
       clockInLastRow.setValue(date.toLocaleString());
     } else if (clockOutLastRow.getValue() as string === "") {
       // If the Clock Out column has an empty value in the table, 
       // add an end time and calculate the shift duration.
       clockOutLastRow.setValue(date.toLocaleString());
       const clockInTime = new Date(clockInLastRow.getValue() as string);
       const clockOutTime  = new Date(clockOutLastRow.getValue() as string);
       const clockDuration = Math.abs((clockOutTime.getTime() - clockInTime.getTime()));
   
       let durationString = getDurationMessage(clockDuration);
       durationColumn.getRangeBetweenHeaderAndTotal().getLastRow().setValue(durationString);
     } else {
       // If both columns are full, add a new row, then add a start time.
       timeTable.addRow()
       clockInLastRow.getOffsetRange(1, 0).setValue(date.toLocaleString());
     }
   }
   
   /**
    * A function to write a time duration as a string.
    */
   function getDurationMessage(delta: number) {
     // Adapted from here:
     // https://stackoverflow.com/questions/13903897/javascript-return-number-of-days-hours-minutes-seconds-between-two-dates
   
     delta = delta / 1000;
     let durationString = "";
   
     let days = Math.floor(delta / 86400);
     delta -= days * 86400;
   
     let hours = Math.floor(delta / 3600) % 24;
     delta -= hours * 3600;
   
     let minutes = Math.floor(delta / 60) % 60;
   
     if (days >= 1) {
       durationString += days;
       durationString += (days > 1 ? " days" : " day");
   
       if (hours >= 1 && minutes >= 1) {
         durationString += ", ";
       }
       else if (hours >= 1 || minutes > 1) {
         durationString += " and ";
       }
     }
   
     if (hours >= 1) {
       durationString += hours;
       durationString += (hours > 1 ? " hours" : " hour");
       if (minutes >= 1) {
         durationString += " and ";
       }
     }
   
     if (minutes >= 1) {
       durationString += minutes;
       durationString += (minutes > 1 ? " minutes" : " minute");
     }
   
     return durationString;
   }
   

4. Переименуйте скрипт в "Ударные часы".

5. Сохраните скрипт.

6. В книге выберите ячейку E2.

7. Кнопка "Добавить скрипт". Перейдите в меню Дополнительные параметры (...) на странице Сведений о скрипте и выберите Добавить в книгу.

8. Сохраните книгу.

Запустите сценарий

Нажмите кнопку Часы удара , чтобы запустить скрипт. Он регистрирует текущее время в разделе Clock In или Clock Out в зависимости от того, что было введено ранее.

Примечание.

Длительность записывается только в том случае, если она превышает минуту. Вручную измените время "Часы в", чтобы проверить большую продолжительность.