如何将Duration类型时间差转为ISO8601格式字符串存入数据库？

问题背景 #

需要计算两个DateTime的差值，并以ISO8601格式（如"P3Y6M4DT12H30M17S"）存入数据库，但调用Duration.toIso8601String()时触发错误：

The method 'toIso8601String' isn't defined for the type 'Duration'.

错误原因 #

Dart的Duration类没有内置ISO8601格式转换方法，且Duration仅能表示天、小时、分钟、秒、微秒级的差值，无法直接处理年、月（因为年、月的天数不固定）。

解决方案 #

根据业务需求选择对应实现方式：

1. 仅需天及以下单位（格式如PnDTnHnMnS）

自己实现方法拼接Duration的各时间部分：

String durationToIso8601(Duration duration) {
  final buffer = StringBuffer('P');
  
  // 处理天数
  if (duration.inDays > 0) {
    buffer.write('${duration.inDays}D');
  }
  
  // 处理时间部分（时/分/秒）
  final hasTimePart = duration.inHours.remainder(24) > 0 || 
                      duration.inMinutes.remainder(60) > 0 || 
                      duration.inSeconds.remainder(60) > 0 || 
                      duration.inMicroseconds.remainder(1000000) > 0;
  
  if (hasTimePart) {
    buffer.write('T');
    if (duration.inHours.remainder(24) > 0) {
      buffer.write('${duration.inHours.remainder(24)}H');
    }
    if (duration.inMinutes.remainder(60) > 0) {
      buffer.write('${duration.inMinutes.remainder(60)}M');
    }
    final seconds = duration.inSeconds.remainder(60);
    final microseconds = duration.inMicroseconds.remainder(1000000);
    if (microseconds > 0) {
      buffer.write('${seconds}.${microseconds.toString().padLeft(6, '0')}S');
    } else if (seconds > 0) {
      buffer.write('${seconds}S');
    }
  }
  
  // 处理差值为0的情况
  if (buffer.length == 1) {
    buffer.write('0D');
  }
  
  return buffer.toString();
}

// 使用示例
final birthday = DateTime(1977, 5, 22);
final birthday1 = DateTime(1967, 10, 12);
final difference = birthday.difference(birthday1);
print(durationToIso8601(difference)); // 输出示例：P3470D

2. 需要包含年、月的完整格式（如PnYnMnDT...）

需手动计算年、月、剩余天数，再结合时分秒部分，同时处理借位逻辑：

String dateDifferenceToIso8601(DateTime later, DateTime earlier) {
  final buffer = StringBuffer('P');
  
  int years = later.year - earlier.year;
  int months = later.month - earlier.month;
  int days = later.day - earlier.day;
  
  // 处理天数借位
  if (days < 0) {
    months--;
    final previousMonth = DateTime(later.year, later.month, 0);
    days += previousMonth.day;
  }
  // 处理月份借位
  if (months < 0) {
    years--;
    months += 12;
  }
  
  // 拼接年、月、日部分
  if (years > 0) buffer.write('${years}Y');
  if (months > 0) buffer.write('${months}M');
  if (days > 0) buffer.write('${days}D');
  
  // 计算时分秒差值
  var timeDiff = Duration(
    hours: later.hour - earlier.hour,
    minutes: later.minute - earlier.minute,
    seconds: later.second - earlier.second,
    microseconds: later.microsecond - earlier.microsecond,
  );
  
  // 处理时间部分为负的借位
  if (timeDiff.isNegative) {
    timeDiff += const Duration(days: 1);
    days--;
    if (days < 0) {
      months--;
      if (months < 0) {
        years--;
        months += 12;
      }
      final previousMonth = DateTime(later.year, later.month, 0);
      days += previousMonth.day;
      // 重新拼接日期部分
      buffer.clear();
      buffer.write('P');
      if (years > 0) buffer.write('${years}Y');
      if (months > 0) buffer.write('${months}M');
      if (days > 0) buffer.write('${days}D');
    }
  }
  
  // 拼接时间部分
  final hasTimePart = timeDiff.inHours > 0 || 
                      timeDiff.inMinutes.remainder(60) > 0 || 
                      timeDiff.inSeconds.remainder(60) > 0 || 
                      timeDiff.inMicroseconds > 0;
  
  if (hasTimePart) {
    buffer.write('T');
    if (timeDiff.inHours > 0) buffer.write('${timeDiff.inHours}H');
    if (timeDiff.inMinutes.remainder(60) > 0) buffer.write('${timeDiff.inMinutes.remainder(60)}M');
    final seconds = timeDiff.inSeconds.remainder(60);
    final microseconds = timeDiff.inMicroseconds.remainder(1000000);
    if (microseconds > 0) {
      buffer.write('${seconds}.${microseconds.toString().padLeft(6, '0')}S');
    } else if (seconds > 0) {
      buffer.write('${seconds}S');
    }
  }
  
  // 处理全零差值
  if (buffer.length == 1) buffer.write('0D');
  
  return buffer.toString();
}

// 使用示例
final birthday = DateTime(1977, 5, 22);
final birthday1 = DateTime(1967, 10, 12);
print(dateDifferenceToIso8601(birthday, birthday1)); // 输出：P9Y7M10D

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