如何使用Excel Scripts设置自定义文本格式？

需求：通过Office Scripts设置单元格自定义格式，输入指定数字时显示对应字符串（如输入10显示ten），支持任意数字/字符串对。手动操作和VBA可实现，但需要TypeScript方案；动作记录器生成的代码报错“参数无效、缺失或格式不正确”，也接受Script Lab方案。

报错的测试代码 #

function main(workbook: ExcelScript.Workbook) {
  let s = workbook.getActiveWorksheet().getRange("g9")
  s.setValue("7")
  s.setNumberFormatLocal("[=7]\"\"seven\"\";General"); 
}

问题原因与修正方案 #

报错原因是格式字符串的双引号转义错误：Office Scripts的setNumberFormatLocal方法不需要额外转义双引号，直接按Excel原生自定义格式语法编写即可。同时，单元格值需设为数字类型而非字符串，否则条件格式不会生效。

单组映射的修正代码 #

function main(workbook: ExcelScript.Workbook) {
  const targetRange = workbook.getActiveWorksheet().getRange("g9");
  // 设置数字值（必须是数字类型，字符串值无法触发数字格式）
  targetRange.setValue(7);
  // 正确的自定义格式：直接用双引号包裹显示文本
  targetRange.setNumberFormatLocal('[=7]"seven";General');
}

多组映射的通用实现 #

如果需要支持任意多组数字-字符串映射，可以封装生成格式字符串的逻辑：

function main(workbook: ExcelScript.Workbook) {
  // 定义数字与对应显示字符串的映射表
  const numStringMap: Record<number, string> = {
    7: "seven",
    10: "ten",
    5: "five",
    12: "twelve"
  };

  const targetRange = workbook.getActiveWorksheet().getRange("g9:g15");
  
  // 生成自定义格式字符串
  const formatSegments: string[] = [];
  for (const num in numStringMap) {
    // 为每个数字添加条件格式段
    formatSegments.push(`[=${num}]"${numStringMap[Number(num)]}"`);
  }
  // 拼接默认格式（未匹配的数字显示原值）
  const customFormat = `${formatSegments.join(";")};General`;

  // 应用格式并测试不同值
  targetRange.setNumberFormatLocal(customFormat);
  targetRange.getCell(0, 0).setValue(7);    // 显示seven
  targetRange.getCell(1, 0).setValue(10);   // 显示ten
  targetRange.getCell(2, 0).setValue(5);    // 显示five
  targetRange.getCell(3, 0).setValue(3);    // 显示原数字3
}

注意事项 #

• 单元格值必须为数字类型：若设置为字符串（如setValue("7")），数字格式规则不会触发，仍显示原字符串。
• 特殊字符处理：如果显示字符串包含双引号，需用两个双引号转义，例如显示he"llo需写成"he""llo"。
• 格式优先级：多个条件格式段按顺序匹配，优先匹配先定义的规则。

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