如何使用JDA实现按指定日期统计Discord频道消息数量的功能

• 命令解析：捕获!stat前缀的命令，提取后续日期参数，将输入的MM/dd/yy格式日期转换为对应时间区间
• 消息拉取：调用JDA消息历史接口分页拉取当前频道的历史消息，直到拉取到的消息早于目标日期区间的起始时间停止
• 计数统计：遍历所有拉取到的消息，筛选出发送时间落在目标区间内的消息累加计数，返回最终结果

// 仅为核心逻辑示例，省略异常捕获、参数合法性校验逻辑
// 命令触发回调
@Override
public void onMessageReceived(MessageReceivedEvent event) {
    if (!event.isFromGuild() || event.getAuthor().isBot()) return;
    String content = event.getMessage().getContentRaw();
    
    // 匹配!stat命令
    if (content.startsWith("!stat ")) {
        String[] args = content.split(" ");
        if (args.length < 2) {
            event.getChannel().sendMessage("命令格式错误，示例：`!stat 11/18/21`").queue();
            return;
        }
        
        // 解析输入日期为UTC时区的时间区间，可按需替换为对应服务器时区
        DateTimeFormatter inputFormatter = DateTimeFormatter.ofPattern("MM/dd/yy");
        LocalDate targetDate = LocalDate.parse(args[1], inputFormatter);
        OffsetDateTime rangeStart = targetDate.atStartOfDay().atOffset(ZoneOffset.UTC);
        OffsetDateTime rangeEnd = targetDate.plusDays(1).atStartOfDay().atOffset(ZoneOffset.UTC);
        
        TextChannel channel = event.getChannel().asTextChannel();
        int count = 0;
        MessageHistory history = channel.getHistory();
        boolean hasMore = true;
        
        // 分页拉取消息，单次最多拉取100条
        while (hasMore) {
            List<Message> batch = history.retrievePast(100).complete();
            if (batch.isEmpty()) break;
            
            for (Message msg : batch) {
                OffsetDateTime createTime = msg.getTimeCreated();
                // 消息早于区间起始时间，终止拉取
                if (createTime.isBefore(rangeStart)) {
                    hasMore = false;
                    break;
                }
                // 消息落在目标区间内，计数+1
                if (createTime.isAfter(rangeStart) && createTime.isBefore(rangeEnd)) {
                    count++;
                }
            }
        }
        event.getChannel().sendMessage("指定日期频道内共发送了 " + count + " 条消息").queue();
    }
}

• JDA的Message#getTimeCreated()返回的是UTC时区的OffsetDateTime对象，无需额外转换即可直接做时间比较
• 如果需要按服务器所在地时区统计，只需要替换代码中的ZoneOffset.UTC为对应时区参数即可
• 若频道消息量较大，建议提前同步消息数据到本地数据库，查询时直接查库可大幅提升响应速度
• 批量拉取消息时JDA会自动处理速率限制，无需额外加延迟，若出现限流报错可适当增加拉取间隔

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