Office Script中If条件的工作原理及高亮今日日期单元格的方法

Office Script基于TypeScript，它的If条件逻辑和标准JavaScript/TypeScript完全一致：

• 核心是布尔表达式判断：If语句接收一个返回true或false的表达式，当表达式结果为true时，执行紧跟的代码块；为false则跳过该代码块。
• 支持分支扩展：可以搭配else处理条件不满足的情况，或者用else if实现多分支判断。
• 代码块用大括号{}包裹：即使单条语句，也建议用大括号明确范围，避免逻辑歧义。

基础示例：

let value = 10;
if (value > 5) {
  console.log("值大于5");
} else if (value === 5) {
  console.log("值等于5");
} else {
  console.log("值小于5");
}

要实现这个需求，核心是遍历单元格、用If判断单元格日期是否与今日日期匹配，再设置高亮样式。以下是完整实现步骤和代码：

步骤说明 #

1. 获取目标工作表和数据范围：定位到要处理的工作表，再获取包含日期的单元格范围（避免遍历整个工作表提升效率）。
2. 标准化今日日期：单元格中的日期可能包含时分秒，需把今日日期的时间部分清零，确保只比较日期部分。
3. 遍历单元格并判断：循环遍历每个单元格，通过If语句判断单元格值是否为日期类型，且与标准化后的今日日期一致。
4. 设置高亮样式：满足条件的单元格，设置填充颜色为高亮色（比如黄色）。

完整代码示例 #

function main(workbook: ExcelScript.Workbook) {
  // 获取目标工作表（替换为你的工作表名称）
  const sheet = workbook.getWorksheet("Sheet1");
  // 获取包含日期的数据范围（这里假设日期在A列，可根据实际调整）
  const dateRange = sheet.getRange("A:A").getUsedRange();
  const dateValues = dateRange.getValues();

  // 标准化今日日期（清除时分秒）
  const today = new Date();
  today.setHours(0, 0, 0, 0);

  // 遍历每个单元格
  for (let row = 0; row < dateValues.length; row++) {
    const cellValue = dateValues[row][0];
    // 判断当前单元格是否为日期类型，且日期等于今日
    if (cellValue instanceof Date) {
      const cellDate = new Date(cellValue);
      cellDate.setHours(0, 0, 0, 0);
      if (cellDate.getTime() === today.getTime()) {
        // 设置单元格填充为黄色高亮
        dateRange.getCell(row, 0).getFormat().getFill().setColor("#FFFF00");
      }
    }
  }
}

关键细节解释 #

• 日期标准化：用setHours(0,0,0,0)清除日期的时分秒部分，避免因单元格日期带时间（比如2024/05/20 14:30）导致判断不匹配。
• 类型判断：用cellValue instanceof Date确保只处理日期类型的单元格，避免非日期值干扰逻辑。
• 效率优化：使用getUsedRange()获取实际有数据的范围，而不是遍历整列，提升脚本运行速度。

内容的提问来源于stack exchange，提问作者somi