OpeningHoursSpecification¶
OpeningHoursSpecification is used for regular opening hours (openingHoursSpecification) and for special opening hours such as holidays, seasonal changes or closures (specialOpeningHoursSpecification).
The format follows the Google recommendation for opening hours.
Opening hours format¶
| opens | closes | Meaning |
|---|---|---|
00:00 |
23:59 |
Open all day |
00:00 |
00:00 |
Closed all day |
10:00 |
00:00 |
Open until midnight |
18:00 |
02:00 |
Open over midnight, until 02:00 of the next day |
Regular opening hours¶
- Each item describes one time range. A day with several time ranges, for example a lunch break, has several items.
- "Open all day" is returned as
00:00–23:59. Values such as00:00–00:00or00:00–24:00provided by a source are converted to00:00–23:59, because00:00–00:00means "closed all day".
Special opening hours¶
- If
validFrom/validThroughare set, special opening hours override the regular opening hours for this period. - "Closed all day" is returned as
00:00–00:00, usually with adescriptionof the closure. - Items may contain only a
descriptionwithout times, when the source provides the special opening hours as text only.
Properties¶
| Name | Type | Description |
|---|---|---|
| opens | string | The place is open if property is specified, and closed otherwise. |
| validFrom | date-time | |
| dayOfWeek | string | The day of the week. Possible values are: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday. |
| validThrough | date-time | |
| closes | string | |
| typeName | string | Translated name of type. |
| alternateName | string | |
| description | string | Multilingual. It is automatically translated if the description is not provided in all languages. Translated text is trimmed to 9000 symbols. Can contain HTML |
| disambiguatingDescription | string | Multilingual. Can contain HTML |
| image | ImageObjectSimplex | |
| sameAs | string | |
| url | string | URL of the item |
| additionalType | string | Name of the 'real', more descriptive class which has no additional properties. Examples are schema.org/Country, schema.org/State, schema.org/City |
| link | Link[] | Web-links and general links between things |
| potentialAction | Action[] | |
| name | string | Multilingual. Can contain HTML |
| type | string |