如何获取Outlook日历指定月份的所有约会（含跨月定期约会）？

你的核心问题在于：直接用Restrict筛选日期范围时，跨月定期约会的主实例可能不在你指定的月份内，导致这些约会的当月实例被遗漏。下面是修正后的实现方案：

关键改进思路 #

1. 开启IncludeRecurrences：让Outlook Items集合包含定期约会的所有实例，而非仅主实例
2. 针对定期约会，用RecurrencePattern.GetOccurrences()直接生成指定日期范围内的所有实例，不管主实例所在月份
3. 区分非定期和定期约会的处理逻辑，避免重复添加无效项

修正后的代码 #

private void GetAllAppointmentsInMonth(DateTime startOfMonth, DateTime endOfMonth)
{
    Outlook.Application outlookApp = new Outlook.Application();
    Outlook.NameSpace outlookNamespace = outlookApp.GetNamespace("MAPI");
    Outlook.MAPIFolder calendarFolder = outlookNamespace.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderCalendar);
    Outlook.Items calendarItems = calendarFolder.Items;
    
    // 按开始时间排序，并启用定期实例包含
    calendarItems.Sort("[Start]", Outlook.OlSortOrder.olAscending);
    calendarItems.IncludeRecurrences = true;

    this.Data.Clear();

    foreach (object item in calendarItems)
    {
        if (item is not Outlook.AppointmentItem appointment) continue;

        if (!appointment.IsRecurring)
        {
            // 非定期约会：直接检查是否在目标月份范围内
            if (appointment.Start >= startOfMonth && appointment.Start <= endOfMonth)
            {
                AddAppointmentToData(appointment);
            }
        }
        else
        {
            try
            {
                Outlook.RecurrencePattern recurrencePattern = appointment.GetRecurrencePattern();
                // 获取指定日期区间内的所有定期约会实例
                Outlook.AppointmentItemCollection occurrences = recurrencePattern.GetOccurrences(startOfMonth, endOfMonth);
                
                foreach (Outlook.AppointmentItem occurrence in occurrences)
                {
                    // 跳过已取消的约会实例
                    if (occurrence?.MeetingStatus != Outlook.OlMeetingStatus.olMeetingCanceled)
                    {
                        AddAppointmentToData(occurrence);
                    }
                }
            }
            catch (Exception ex)
            {
                // 处理无效定期模式等异常
                Console.WriteLine($"处理定期约会失败: {ex.Message}");
            }
        }
    }
}

// 复用添加数据的逻辑
private void AddAppointmentToData(Outlook.AppointmentItem appointment)
{
    DataModel dataModel = new DataModel
    {
        Subject = appointment.Subject,
        StartTime = appointment.Start,
        EndTime = appointment.End
        // 可按需添加更多字段：Location、Body等
    };
    this.Data.Add(dataModel);
}

注意事项 #

• 日期范围要精确：调用时传入startOfMonth应为当月第一天的00:00:00，endOfMonth为当月最后一天的23:59:59，避免遗漏月底的约会
• 异常处理：部分定期约会可能存在无效的重复规则（比如结束日期早于开始日期），需要捕获异常避免程序崩溃
• 性能优化：如果日历项数量极大，可以先通过Restrict过滤掉主实例时间完全在目标区间外的项，减少后续处理量

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