I’m trying to use relevantDate to refine when the passes for my app are shown.
The relevantDate options I know about are: specify a start and end time on a single day, or specify a single time which seems to show the pass in the lock screen for about a four-hour window in either direction (!), at least for the “generic” pass type.
It seems like there ought to be a way to specify, e.g., for a coupon, that it should be shown on the lock screen when they’re in the store for the next two weeks, at which point it should expire. Is there? If so, what is it?
Sorry, there’s not currently a way to do this.
Relevance is a cooperative effort between you and the system. Your pass gives a point in time (the relevant date) and/or a point in space (the relevant locations). There’s no API to provide a duration or a region. The system decides what radius to use around that location and what window of time to use around the date. There is some documentation for the relevant locations in the Passbook guide but the time window is not documented. In practice, the time window is on the order of 4-8 hours, depending on the pass style.
You should go on Apple’s bug report page and file an enhancement request, describing how it would add value to your coupons to be relevant for multiple days.