使用SpreadsheetLight导出Excel时如何处理TimeSpan类型值？

嘿，我刚好熟悉SpreadsheetLight的这个小坑！它确实不直接支持把TimeSpan类型的值直接写入单元格，但咱们有两种简单有效的办法来解决这个问题，帮你把字符串格式的时间转成Excel能正确显示的时间跨度～

核心原理先搞懂 #

Excel本身并没有专门的TimeSpan类型，它的所有时间/时长值本质上都是小数：1代表一整天，0.5就是12小时，以此类推。SpreadsheetLight只接受Excel兼容的数据类型（比如double、DateTime），所以直接传TimeSpan会报错，我们得先把它转成Excel能识别的数值。

方法一：把TimeSpan转成Excel时间数值（推荐） #

这个方法最直接，专门针对时间跨度场景，支持显示超过24小时的时长：

1. 先把你的字符串时间解析成TimeSpan
2. 将TimeSpan转换成总天数的小数（因为Excel用这个数值来表示时间）
3. 设置单元格的格式代码为适合时间跨度的样式（比如[h]:mm:ss，方括号能让Excel正确显示超过24小时的小时数）

修改你的代码如下：

// 创建适合时间跨度的单元格样式
var timeSpanStyle = Document.CreateStyle();
timeSpanStyle.Alignment.Horizontal = HorizontalAlignmentValues.Right;
// 格式代码：[h]表示允许超过24小时的小时数，mm是分钟，ss是秒
timeSpanStyle.FormatCode = "[h]:mm:ss";

for (int i = 0; i < shiftStatus.Count; i++)
{
    Document.SetCellStyle(i + 2, 7, timeSpanStyle);
    
    // 尝试解析字符串为TimeSpan
    if (TimeSpan.TryParse(shiftStatus[i].PreperationTime, out var prepTime))
    {
        // 转换为Excel兼容的时间数值（总天数）
        double excelTimeValue = prepTime.TotalDays;
        Document.SetCellValue(i + 2, 7, excelTimeValue);
    }
    else
    {
        // 处理解析失败的情况，比如设置提示文本
        Document.SetCellValue(i + 2, 7, "无效时间");
    }
}

方法二：基于基准日期转成DateTime（适合短跨度） #

如果你的时间跨度不会太大，也可以把TimeSpan加到一个基准日期（比如1900-01-01）上，转成DateTime，然后设置格式只显示时间部分：

var dateTimeStyle = Document.CreateStyle();
dateTimeStyle.Alignment.Horizontal = HorizontalAlignmentValues.Right;
// 使用时间格式，比如你原来的LongTimePattern
dateTimeStyle.FormatCode = CultureInfo.CurrentCulture.DateTimeFormat.LongTimePattern;

for (int i = 0; i < shiftStatus.Count; i++)
{
    Document.SetCellStyle(i + 2, 7, dateTimeStyle);
    
    if (TimeSpan.TryParse(shiftStatus[i].PreperationTime, out var prepTime))
    {
        // 基于1900-01-01创建DateTime
        var baseDate = new DateTime(1900, 1, 1);
        DateTime excelDateTime = baseDate.Add(prepTime);
        Document.SetCellValue(i + 2, 7, excelDateTime);
    }
    else
    {
        Document.SetCellValue(i + 2, 7, "无效时间");
    }
}

不过这个方法有个小问题：如果时间跨度超过24小时，Excel会显示成第二天的时间，而不是累计的小时数，所以更适合短时长的场景。

额外提示：非标准字符串格式的解析 #

如果你的时间字符串不是.NET默认能识别的格式（比如自定义的"HH:mm:ss"），可以用TimeSpan.TryParseExact来指定格式：

// 假设字符串格式是"hh:mm:ss"
if (TimeSpan.TryParseExact(shiftStatus[i].PreperationTime, "hh:mm:ss", CultureInfo.CurrentCulture, TimeSpanStyles.None, out var prepTime))
{
    // 后续处理同上
}

内容的提问来源于stack exchange，提问作者Uğur Can