Прочитать на английском

Поделиться через


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

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

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

Таблица с тремя столбцами (

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

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

    Таблица с тремя столбцами: Clock In, Clock Out и Duration.

  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 в зависимости от того, что было введено ранее.

Таблица и кнопка

Примечание

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