REDCap API：日期过滤功能技术咨询

嗨，我完全懂你的需求——你想要拿到REDCap数据库在某个特定日期的「快照状态」，也就是只保留到该日期为止的所有数据原貌，之后的任何修改都不纳入，包括字段被更新后的新值对吧？

你提到用dateRangeEnd没达到预期，这其实是这个参数的设计局限：它只会筛选记录创建或最后修改时间在指定日期之前的记录，但不会回溯字段在那个日期时的原始值，默认返回的还是每个字段的最新值，哪怕这个更新是在你目标日期之后发生的。

给你几个可行的解决方案，按推荐程度排序：

• 开启版本历史并导出变更记录
  这是最靠谱的方法，前提是你的REDCap项目已经开启了「版本历史」功能（在项目设置的「数据管理」板块里可以确认）。通过API导出时，你可以在exportRecords请求里加上这几个关键参数：

  • exportChanges=true：让API返回每个字段的所有修改历史，而非仅最新值
  • dateRangeEnd=YYYY-MM-DD：指定你想要的快照日期
    这样导出的结果会包含到目标日期为止，每个字段的所有修改记录，你可以从中提取每个字段在该日期时的最后一次修改值，也就是当时的真实状态。

  举个curl请求的例子：

  curl -X POST "https://你的REDCap实例地址/api/" \
    -d "token=你的API令牌" \
    -d "content=record" \
    -d "action=export" \
    -d "format=json" \
    -d "exportChanges=true" \
    -d "dateRangeEnd=2024-05-01" \
    -d "returnFormat=json"
  

• 使用项目数据快照
  如果你的机构的REDCap实例支持创建数据快照（部分企业版或定制化实例有这个功能），那直接找到对应日期的快照导出即可——这是最省心的方式，相当于直接拿到当时的完整数据库备份。

• 手动处理修改日志（备选方案）
  如果没法开启版本历史，你可以通过export_log API方法导出所有记录的操作日志，然后自己编写脚本回溯每个字段在目标日期时的状态。不过这种方法比较繁琐，适合数据量不大的场景。

另外要注意，dateRangeEnd的日期格式必须是YYYY-MM-DD或者带时间的YYYY-MM-DD HH:MM:SS，否则参数可能不会生效哦。

备注：内容来源于stack exchange，提问作者Selenite