问题背景：Excel自动格式转换的困扰
在数据导出场景中，一个常见的问题是，当我们将包含特定格式文本（例如“5/10”表示“10个中的5个”）的表格数据导出为excel或csv文件时，microsoft excel可能会基于其内置的智能识别机制，将其自动解析为日期格式（例如“10-may”）。这种行为往往并非我们所期望，因为它会改变数据的原始含义，导致数据不准确。对于依赖数据精确性的业务场景而言，这是一个必须解决的问题。
解决方案核心：利用 tableExport.jquery.plugin 的 cellFormat
Bootstrap Table的导出功能通常依赖于tableExport.jquery.plugin。这个强大的插件提供了丰富的导出选项，其中cellFormat是解决此类问题的关键。cellFormat允许我们为导出文件中的特定列定义其数据格式，从而覆盖Excel的自动识别行为。通过将相关列的格式明确设置为“文本”，我们可以确保数据以其原始字符串形式呈现，不被误解为日期或其他类型。
实现步骤与代码示例
要防止“Enrolled”列（或其他类似列）在导出时被转换为日期格式，我们需要修改Bootstrap Table的初始化配置，特别是在exportOptions中添加cellFormat属性。
以下是修改后的代码示例：
function loadTable() {
$.ajax({
type: "POST",
url: "admin/oes/getReport",
success: function (dataRaw) {
var data = JSON.parse(dataRaw);
$('#table').bootstrapTable('destroy'); // re-initialize
$('#table').bootstrapTable({
data: data.list,
pageNumber: 1,
pagination: 'client',
pageSize: 50,
pageList: [20, 50, 100, 200],
search: true,
exportTypes: ['csv', 'excel'],
exportOptions: {
fileName: 'geElectiveReport_' + Date.now(),
// 核心解决方案：添加 cellFormat 配置
cellFormat: [
{
// 指定需要防止格式转换的列
// 可以使用列的 field 名称，例如 'numEnrol'
// 或者使用列的索引（从0开始），例如 'Enrolled' 列是第10列，索引为 9
columns: ['numEnrol'], // 假设 'numEnrol' 字段对应 'Enrolled' 列
format: 'text' // 强制设置为文本格式
}
]
},
columns: [{
field: 'sectionId',
title: 'Section ID',
sortable: true
}, {
field: 'programmeType',
title: 'Prog Type',
sortable: true
}, {
field: 'instructor',
title: 'Instructor',
sortable: true
}, {
field: 'module',
title: 'Module',
sortable: true
}, {
field: 'room',
title: 'Room',
sortable: true
}, {
field: 'week',
title: 'Week',
sortable: true
}, {
field: 'time',
title: 'Time',
sortable: true
}, {
field: 'mediumOfInstruction',
title: 'Medium of Instruction',
sortable: true
}, {
field: 'programmeNotAllow',
title: 'Programme not Allow',
sortable: true
}, {
field: 'numEnrol',
title: 'Enrolled',
sortable: true,
formatter: (value, row, index, field) => {
return value + '/' + row.quota
}
},
]
});
},
error: function () {
alert("加载数据失败，请稍后重试。");
}
});
}代码解释
- exportOptions: 这是Bootstrap Table用于配置导出行为的选项对象。
- cellFormat: 这是tableExport.jquery.plugin提供的一个属性，用于定义导出单元格的格式。它接受一个数组，数组中的每个对象定义了一组列的格式。
- columns: ['numEnrol']: 这个属性指定了要应用格式的列。你可以传入一个字符串数组，包含列的field名称（如'numEnrol'），或者传入一个数字数组，包含列的索引（从0开始）。例如，如果“Enrolled”列是表格中的第10列，那么其索引为9，你可以写成columns: [9]。推荐使用field名称，因为它更具可读性和稳定性。
- format: 'text': 这是最重要的部分，它告诉导出插件将指定列的数据视为纯文本。这样，即使内容看起来像日期或数字，Excel也不会尝试进行自动转换。
注意事项
- 确认列名或索引: 在设置columns属性时，请务必确认你指定的field名称或列索引是正确的，以确保格式化应用到目标列。
- 插件依赖: 此解决方案依赖于bootstrap-table-export插件以及其所使用的tableExport.jquery.plugin。请确保这些插件已正确引入到你的项目中。
- 其他导出类型: cellFormat通常适用于Excel和CSV等导出类型。对于其他复杂的导出类型（如PDF），可能需要查阅tableExport.jquery.plugin的官方文档，了解是否有其他特定的格式控制选项。
- Excel自身行为: 尽管此方法能有效控制导出文件的数据格式，但极少数情况下，如果用户在Excel中手动更改了单元格格式，或Excel版本存在特殊行为，仍可能出现意外。在遇到问题时，可以尝试使用文本编辑器打开CSV文件，确认原始数据是否正确，以排除Excel客户端本身的问题。
总结
通过在Bootstrap Table的exportOptions中配置cellFormat属性，并将目标列的format设置为'text'，我们可以有效防止Excel在数据导出时对特定列进行自动日期格式转换。这一简单而强大的配置，确保了数据在导出和后续分析中的准确性和一致性，极大地提升了用户体验和数据可靠性。
