Dart中DateTime与相对纪元周索引的互转实现需求

首先要明确两个核心前提：

• 纪元日期：你需要指定一个基准日期（示例中用2000-01-03，即ISO标准2000年第1周的周一）
• 周规则：约定一周的起始日（示例以周一为起始）

以下是C#语言的实现代码：

1. 日期转周索引 #

该方法接收DateTime类型日期，返回相对于纪元日期的周索引（纪元所在周为索引1）

// 自定义纪元日期，可根据需求修改
private static readonly DateTime EpochDate = new DateTime(2000, 1, 3);

public static int DateToWeekIndex(DateTime targetDate)
{
    // 计算目标日期与纪元日期的总天数差
    TimeSpan dateDiff = targetDate - EpochDate;
    int totalDays = (int)dateDiff.TotalDays;

    // 计算周索引：天数差除以7取整，加1让纪元周从1开始计数
    int weekIndex = (totalDays / 7) + 1;

    // 若目标日期早于纪元日期，会返回负数索引，可根据需求调整为0起始或抛出异常
    return weekIndex;
}

2. 周索引转原始日期 #

该方法接收周索引，返回对应周内与纪元日期同星期几的日期

public static DateTime WeekIndexToDate(int weekIndex)
{
    // 计算偏移天数：(索引-1)*7，确保索引1对应纪元日期
    int offsetDays = (weekIndex - 1) * 7;
    return EpochDate.AddDays(offsetDays);
}

进阶：遵循ISO周规则的实现 #

如果需要严格遵循ISO周标准（周起始为周一，每年第1周至少包含4天），可以调整代码如下：

using System.Globalization;

private static readonly DateTime IsoEpochDate = new DateTime(2000, 1, 3); // ISO 2000年第1周的周一

public static int DateToIsoWeekIndex(DateTime targetDate)
{
    Calendar isoCalendar = CultureInfo.InvariantCulture.Calendar;
    var weekRule = CalendarWeekRule.FirstFourDayWeek;
    var weekStart = DayOfWeek.Monday;

    // 获取纪元日期的ISO周数和年份
    int epochWeek = isoCalendar.GetWeekOfYear(IsoEpochDate, weekRule, weekStart);
    int epochYear = IsoEpochDate.Year;

    // 获取目标日期的ISO周数和年份
    int targetWeek = isoCalendar.GetWeekOfYear(targetDate, weekRule, weekStart);
    int targetYear = targetDate.Year;

    // 计算总周数差
    int totalWeeks = (targetYear - epochYear) * 52 + (targetWeek - epochWeek);

    // 处理跨年周特殊情况：12月底的日期可能属于下一年第1周
    if (targetWeek == 1 && targetDate.Month == 12)
    {
        totalWeeks += 52;
    }
    // 处理纪元日期本身是跨年周的情况
    else if (epochWeek == 1 && IsoEpochDate.Month == 12)
    {
        totalWeeks -= 52;
    }

    return totalWeeks + 1; // 索引从1开始
}

public static DateTime IsoWeekIndexToDate(int weekIndex)
{
    // 先计算基准偏移，再调整到对应ISO周的起始日
    int offsetWeeks = weekIndex - 1;
    DateTime baseDate = IsoEpochDate.AddDays(offsetWeeks * 7);
    
    // 确保返回的是对应ISO周的周一（可选，也可返回同星期几的日期）
    Calendar isoCalendar = CultureInfo.InvariantCulture.Calendar;
    var weekStart = DayOfWeek.Monday;
    int daysToMonday = (int)weekStart - (int)baseDate.DayOfWeek;
    if (daysToMonday < 0) daysToMonday += 7;
    
    return baseDate.AddDays(daysToMonday);
}

注意事项 #

• 必须提前明确纪元日期和周规则，不同规则会导致结果完全不同
• 测试时要覆盖边界场景：纪元当天、纪元前一周、跨年周、闰年日期等
• 若不需要支持早于纪元的日期，可在DateToWeekIndex中添加参数校验，抛出ArgumentOutOfRangeException

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