Webdriver.io 中 xlsx 库日期写入如何解决日期被识别为文本问题？

2024-08-09 17:59:50

Webdriver.io 中 xlsx 库日期格式写入难题，如何破？

在 Webdriver.io 自动化测试中，读取和写入 Excel 文件是家常便饭。然而，看似简单的日期格式却常常成为绊脚石，令开发者们头疼不已。本文将聚焦于 Webdriver.io 项目中使用 xlsx 库写入日期格式时遭遇的“日期被识别为文本”这一普遍问题，为你提供清晰的解决方案和实用的代码示例，助你轻松化解日期格式写入的困扰。

问题现象：说好的日期，怎么就变成文本了？

你是否也曾遇到过这种情况：满心欢喜地使用 xlsx 库将日期写入 Excel 文件，结果却发现日期数据被无情地识别为“常规”格式，而非我们想要的“日期”格式？

举个例子，我们想将 2024-04-23 这个日期以 mm/dd/yyyy 的格式写入 Excel 文件的 A2 单元格。为此，我们尝试了各种方法，比如：

const date = $('xpath').getValue();  //  2024-04-23    //yyyy-mm-dd 
const [year, month, date] = date.split("-"); 
const newFormat = `${month}/${date}/${year}`;

worksheet[cellAddress]:{t:'s',v:newFormat,d:'mm/dd/yyyy'};

我们甚至尝试将 t 属性修改为 d 或 n，并尝试使用 serialNumber，然而日期依然固执地以“常规”格式显示，例如 04/25/2024，与预期相去甚远。

问题根源：xlsx 库眼中的日期，只是个字符串

这一切的根源在于，xlsx 库在写入日期时，默认将日期视为普通的文本字符串。因此，即使我们煞费苦心地将单元格格式设置为“日期”，Excel 依然我行我素地将其识别为文本。

解决方案：让 xlsx 库明白，这真的是日期！

想要解决这个问题，我们需要将日期数据转换为 Excel 能够理解的数值格式。在 Excel 的世界里，日期实际上是以数值形式存储的，从 1900 年 1 月 1 日开始计算。例如，1900 年 1 月 1 日 对应数值 1，1900 年 1 月 2 日 对应数值 2，以此类推。

所以，我们需要将日期字符串转换为对应的数值，然后将其写入 Excel 文件。

以下是一种可行的解决方案：

安装 moment.js 库，日期处理的好帮手:
```
npm install moment
```
导入 moment.js 库，准备大显身手:
```
const moment = require('moment');
```

将日期字符串转换为 Excel 数值，化繁为简:

const date = $('xpath').getValue();  //  2024-04-23
const excelDate = moment(date, 'YYYY-MM-DD').format('MM/DD/YYYY');
const dateNumber = moment(excelDate,'MM/DD/YYYY').date(1).diff(moment([1900,0,1]), 'days') + 2;

将数值写入 Excel 文件，大功告成:
```
worksheet[cellAddress] = {
    t: 'n', // 设置单元格类型为数值
    v: dateNumber // 写入日期数值
};
```
在这个例子中，我们首先使用 moment 库将日期字符串转换为目标格式 MM/DD/YYYY，然后将其转换为 Excel 日期数值。最后，将单元格类型设置为 n，并将日期数值写入单元格。

代码示例：眼见为实，实践出真知

以下是一个完整的代码示例，演示了如何使用 xlsx 库和 moment.js 库将日期格式正确写入 Excel 文件：

const xlsx = require('xlsx');
const moment = require('moment');

// 读取 Excel 文件
const workbook = xlsx.readFile('your_file.xlsx');
const worksheet = workbook.Sheets['Sheet1'];

// 获取日期数据
const date = $('xpath').getValue();  // 假设获取到的日期为 '2024-04-23'

// 将日期字符串转换为 Excel 数值
const excelDate = moment(date, 'YYYY-MM-DD').format('MM/DD/YYYY');
const dateNumber = moment(excelDate,'MM/DD/YYYY').date(1).diff(moment([1900,0,1]), 'days') + 2; 

// 将日期数值写入 A2 单元格
worksheet['A2'] = {
  t: 'n',
  v: dateNumber
};

// 保存 Excel 文件
xlsx.writeFile(workbook, 'your_file.xlsx');

常见问题解答：为你答疑解惑

问：为什么需要使用 moment.js 库？

答：moment.js 库是一个功能强大的日期处理库，可以方便地进行日期格式转换、计算等操作。在本例中，我们使用 moment.js 将日期字符串转换为 Excel 能够识别的数值格式。
问：dateNumber 的计算公式是什么？

答：dateNumber 的计算公式为 moment(excelDate,'MM/DD/YYYY').date(1).diff(moment([1900,0,1]), 'days') + 2，其中：
- moment(excelDate,'MM/DD/YYYY') 将目标格式的日期字符串转换为 moment 对象。
- .date(1) 将日期设置为每月的第一天，避免日期转换误差。
- .diff(moment([1900,0,1]), 'days') 计算目标日期与 1900 年 1 月 1 日 之间的相差天数。
- + 2 是因为 Excel 中 1900 年 1 月 1 日 对应数值 1，且 1900 年 被错误地认为是闰年，需要加 2 进行修正。
问：除了使用 moment.js 库，还有其他方法吗？

答：是的，你也可以使用 JavaScript 自带的 Date 对象进行日期计算。但 moment.js 提供了更简洁、易用的 API，能够简化代码，提高开发效率。
问：如果我的日期格式不是 YYYY-MM-DD，该怎么办？

答：你需要根据实际情况修改 moment(date, 'YYYY-MM-DD') 中的日期格式字符串。例如，如果你的日期格式为 DD/MM/YYYY，则应将其修改为 moment(date, 'DD/MM/YYYY')。
问：我还有其他关于 xlsx 库使用的问题，在哪里可以找到更多信息？

答：你可以查阅 xlsx 库的官方文档：https://www.npmjs.com/package/xlsx。