An object that represents the result of calculating the minimum, maximum, average, or sum over a set of samples from the HealthKit store.
- iOS 8.0+
- Mac Catalyst 13.0+
- watchOS 2.0+
HealthKit creates statistic objects using either a statistics query or a statistics collection query. For the statistics query, it performs the specified calculations over all the samples that match the query. For the statistics collection query, it partitions the matching samples into a set of time intervals and performs the calculations over each interval separately.
By default, these queries automatically merge the data from all of your data sources before performing the calculations. If you want to merge the data yourself, you can set the
separate option. You can then request the statistical data for each source separately.
When requesting data from a statistics object, your request must match the options you used when creating the query. For example, if you create a query using the
discrete option, you must access the results using the
For more information on calculating statistical data, see
HKStatistics Class Reference. To calculate the statistics over a series of time intervals, see the
HKStatistics Class Reference.