Laravel中Outlook日历API按日期范围查询事件的字段与方法问询

刚好我之前做过类似的Outlook Graph API集成，给你梳理下关键点：

一、日期时间字段说明 #

Outlook Graph API里，事件的开始和结束时间对应的顶层字段是start和end，每个字段都是一个嵌套对象，包含两个核心子字段：

• dateTime：带时区的ISO 8601格式时间字符串（例如 "2024-05-01T00:00:00Z"），这是你做范围筛选时要用到的核心字段
• timeZone：时区标识（例如 "UTC" 或 "China Standard Time"）

所以你要引用具体时间的话，得用start.dateTime和end.dateTime，不是start_time这类简化字段。

二、$filter的使用方式（按月/指定日期范围查询） #

根据你的需求，分两种常用场景给出具体写法：

1. 查询完全落在指定日期范围内的事件 #

比如要获取2024年5月全月的事件（事件的开始和结束都在5月1日到5月31日之间）：

// 注意：结束时间用下月第一天的0点，避免漏掉5月31日23:59结束的事件
$startDate = '2024-05-01T00:00:00Z';
$endDate = '2024-06-01T00:00:00Z';

$eventsQueryParams = array (
    // 只返回需要的字段
    "\$select" => "subject,start,end",
    // 按开始时间升序排序
    "\$orderby" => "start.dateTime asc",
    // 日期范围筛选逻辑
    "\$filter" => "start.dateTime ge '$startDate' and end.dateTime le '$endDate'"
);

2. 查询与指定日期范围有交集的事件（更实用，覆盖跨月事件） #

如果要包含那些开始在5月前但结束在5月内，或者开始在5月内但结束在5月后的跨月事件，用这个筛选逻辑：

$startDate = '2024-05-01T00:00:00Z';
$endDate = '2024-06-01T00:00:00Z';

$eventsQueryParams = array (
    "\$select" => "subject,start,end",
    "\$orderby" => "start.dateTime asc",
    "\$filter" => "start.dateTime lt '$endDate' and end.dateTime gt '$startDate'"
);

三、关键注意事项 #

• 时间字符串必须是UTC时区（带Z后缀），或者明确指定与API一致的时区，否则会出现筛选偏差
• 如果你的应用用的是本地时区，记得先把日期转换为UTC再拼接成ISO格式字符串
• 使用gt（大于）、ge（大于等于）、lt（小于）、le（小于等于）这些运算符时，要注意用单引号包裹时间字符串，确保参数格式正确

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