如何通过JavaScript/Excel API调用Excel的「转换为数字」功能？

你遇到的情况是单元格内容为文本型数字（初始格式为「General」或@），仅设置numberFormat只会改变显示样式，不会修改值的数据类型——所以Excel仍将其视为文本，无法正常参与求和等计算。必须把文本值转换为数值类型，才能实现和手动点击「转换为数字」一样的效果。

以下是两种可行的实现方案：

方案一：直接遍历转换单元格值 #

通过读取单元格值，将文本转换为数字后写回，同时设置数字格式：

var ws = context.workbook.worksheets.getActiveWorksheet();
var Used_Rng_And_Props = await Ranges.Get_Used_Rng_And_Props(context, ws, false);

// 获取目标列索引
var recvdwt_col_index = await Ranges.Get_Header_Col_Index(context, Used_Rng_And_Props, "Recvd_wt");
console.log('recvdwt_col_index:' + recvdwt_col_index);
var rng = await Ranges.Get_Entire_Col_Rng(ws, recvdwt_col_index);

// 加载单元格的JSON格式值
rng.load("valuesAsJson");
await context.sync();

// 遍历单元格，将可转换的文本转为数字
var convertedValues = rng.valuesAsJson.map(row => 
  row.map(cell => {
    const num = parseFloat(cell.value);
    // 转换失败则保留原内容，避免破坏非数字数据
    return isNaN(num) ? cell.value : num;
  })
);

// 写回转换后的值，并设置数字格式
rng.valuesAsJson = convertedValues;
rng.numberFormat = "0.00";

await context.sync();
rng.select();

方案二：利用Excel的VALUE函数批量转换 #

通过设置公式调用VALUE函数转换文本，再将公式结果转为静态值：

var ws = context.workbook.worksheets.getActiveWorksheet();
var Used_Rng_And_Props = await Ranges.Get_Used_Rng_And_Props(context, ws, false);

var recvdwt_col_index = await Ranges.Get_Header_Col_Index(context, Used_Rng_And_Props, "Recvd_wt");
console.log('recvdwt_col_index:' + recvdwt_col_index);
var rng = await Ranges.Get_Entire_Col_Rng(ws, recvdwt_col_index);

// 排除表头行（假设表头为第一行）
var dataRng = rng.getOffsetRange(1, 0).getResizedRange(-1, 0);

// 为数据区域设置VALUE转换公式
const colLetter = dataRng.getCell(0,0).address.match(/[A-Z]+/)[0];
dataRng.formulas = Array.from({length: dataRng.rowCount}, (_, i) => 
  `=VALUE(${colLetter}${i+2})` // 从第2行开始对应数据行
);

await context.sync();

// 将公式结果转为静态值
dataRng.values = dataRng.values;
// 设置数字格式
dataRng.numberFormat = "0.00";

await context.sync();
rng.select();

两种方案的核心都是修改单元格值的数据类型，而不仅仅是格式。方案一适合小规模数据，逻辑直观；方案二适合大量数据，利用Excel内置函数提升效率。

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