如何按日期获取Apple Health数据？HKStatisticsCollectionQuery计数异常问题

嘿，我来帮你搞定这个步数统计和Health app对不上的问题～你的思路是对的，用HKStatisticsCollectionQuery确实是官方推荐的按日期聚合数据的方式，现在数据不一致主要是几个小细节没处理好，咱们一步步调整：

问题分析 #

你的现有代码主要缺了两个关键设置：

1. 没有排除用户手动输入的步数数据——Health应用默认展示的是设备自动记录的步数，不会包含手动录入的部分
2. anchorDate的设置不够严谨，导致统计区间可能和Health app的日期划分不匹配

修改后的完整代码 #

import HealthKit

// 先确认设备支持HealthKit
guard HKHealthStore.isHealthDataAvailable() else {
    fatalError("HealthKit is not available on this device")
}

let healthStore = HKHealthStore()
let last10Day = Calendar.current.date(byAdding: .day, value: -10, to: Date())!

// 1. 创建排除手动输入数据的谓词
let excludeUserEnteredPredicate = HKQuery.predicateForObjects(
    withMetadataKey: HKMetadataKeyWasUserEntered,
    operatorType: .notEqualTo,
    value: true
)

// 2. 正确设置anchorDate：确保统计从每天凌晨0点开始，时区和本地一致
var calendar = Calendar.current
calendar.timeZone = NSTimeZone.local as TimeZone
let anchorDate = calendar.startOfDay(for: last10Day)

// 3. 设置统计区间为1天
var interval = DateComponents()
interval.day = 1

// 4. 获取步数类型
guard let quantityType = HKQuantityType.quantityType(forIdentifier: .stepCount) else {
    fatalError("Step count type is not available")
}

// 5. 创建修正后的统计查询
let query = HKStatisticsCollectionQuery(
    quantityType: quantityType,
    quantitySamplePredicate: excludeUserEnteredPredicate, // 加入排除手动输入的谓词
    options: .cumulativeSum,
    anchorDate: anchorDate,
    intervalComponents: interval
)

// 6. 处理查询结果
query.initialResultsHandler = { query, results, error in
    guard let statsCollection = results else {
        fatalError("Error calculating statistics: \(error?.localizedDescription ?? "Unknown error")")
    }
    
    let endDate = Date()
    statsCollection.enumerateStatistics(from: last10Day, to: endDate) { statistics, stop in
        if let sumQuantity = statistics.sumQuantity() {
            let date = statistics.startDate
            let stepCount = sumQuantity.doubleValue(for: HKUnit.count())
            print("日期: \(date.formatted(date: .long, time: .omitted))，步数: \(Int(stepCount))")
        }
    }
}

// 执行查询
healthStore.execute(query)

额外注意事项 #

如果调整后数据还是有差异，可以检查这几点：

• 数据源过滤：Health app可能只展示Apple Watch/iPhone的步数，如果你想匹配这个逻辑，可以添加数据源谓词，只包含苹果官方设备的数据源：

  // 只包含Apple Watch和iPhone的数据源
  let appleSourcesPredicate = HKQuery.predicateForObjects(from: [HKSource.default()])
  // 组合谓词
  let finalPredicate = NSCompoundPredicate(andPredicateWithSubpredicates: [excludeUserEnteredPredicate, appleSourcesPredicate])
  

• 权限验证：确保你的app已经成功请求了HKQuantityTypeIdentifier.stepCount的读取权限，否则会获取不到完整数据
• 时区一致性：一定要使用本地时区，不然统计的日期会出现偏移（比如跨零点的统计错误）

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