R openxlsx升级后百分比格式化异常问题咨询

问题根源 #

openxlsx版本更新后，全局options("openxlsx.numFmt")的格式解析逻辑发生了变化：旧版本可以直接识别Excel自定义格式字符串（如"0.0%"），但新版本对全局参数的处理更严格，甚至会将"0.0%"误判为日期格式；而直接设置"PERCENTAGE"时，因未指定小数位数且数据格式不匹配，导致最终显示为小数而非百分比。

正确解决方案 #

1. 单个写入任务指定格式（推荐，更可靠）

放弃全局选项，直接在writeData调用中通过numFmt参数指定格式，不受全局设置干扰：

writeData(wb, "Sheet_1", df_tmp, startCol = 2, startRow = 16, 
          rowNames = TRUE, numFmt = "0.0%")

注意：确保df_tmp中的数值是小数形式（例如要显示12.0%，数据需为0.12而非12），否则格式会不符合预期。

2. 全局格式设置（需兼容新版逻辑）

如果需要全局生效，可通过两种方式设置：

• 使用Excel自定义格式字符串（需确保数据是小数）：

  options("openxlsx.numFmt" = "0.0%")
  

• 使用openxlsx内置函数生成标准百分比格式（可指定小数位数）：

  options("openxlsx.numFmt" = getNumFmt("PERCENTAGE", decimalPlaces = 1))
  

补充说明 #

当设置options("openxlsx.numFmt" = NULL)时，openxlsx会使用默认数值格式，不会触发错误的格式解析，因此整数型dataframe能正常写入。

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