Skip to main content

This type is used to express the special operating hours of a store location on a specific date. A specialHours container is needed when the store's opening hours on a specific date are different than the normal operating hours on that particular day of the week.

Types that use SpecialHours

InventoryLocationInventoryLocationFullInventoryLocationResponse

Calls that use SpecialHours

Fields

Field
Type
Description
date
A date value is required for each specific date that the store location has special operating hours or is closed for that date.

The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock.

Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z
Example: 2025-08-04T00:00:00.000Z

This field is returned if set for the store location.
intervals
array of Interval
This array is used to set the operating hours for the date specified in the corresponding date field. These special operating hours on this specific date will override the normal operating hours for that day of the week that is specified through the operatingHours array.

To specify a location as closed on the corresponding date, include the intervals array as empty.

If a location closes for lunch (or any other period during the day) and then reopens, multiple open and close pairs are needed to specify each interval where the location is open.

This container is returned if set for the store location.