Skip to content

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 as 00:00–00:00 or 00:00–24:00 provided by a source are converted to 00:00–23:59, because 00:00–00:00 means "closed all day".

Special opening hours

  • If validFrom/validThrough are set, special opening hours override the regular opening hours for this period.
  • "Closed all day" is returned as 00:00–00:00, usually with a description of the closure.
  • Items may contain only a description without 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