Gathers and returns historical step count data for the specified time period.
SDKs
- iOS 7.0–8.0Deprecated
- Mac Catalyst 13.0–13.0Deprecated
Framework
- Core Motion
Declaration
- (void)queryStepCountStartingFrom:(NSDate *)start to:(NSDate *)end toQueue:(NSOperation Queue *)queue withHandler:(CMStep Query Handler)handler;
Parameters
start
The start time to use when gathering step count data. This parameter must not be
nil
.end
The end time to use when gathering step count data. This parameter must not be
nil
.queue
The operation queue on which to execute the specified
handler
block. You can specify a custom queue or use the operation queue associated with your app’s main thread. This parameter must not benil
.handler
The block to execute with the results. For information about the parameters of this block, see
CMStep
. This parameter must not beQuery Handler nil
.
Discussion
This method runs asynchronously, returning immediately and delivering the results to the specified handler
block. The system stores only the last seven days worth of step data at most. If there are no samples for the specified range of time, a value of 0 is passed to the handler
block.