Opening Hours
Last updated
Last updated
Please also refer to the .
Implementation of the within the tooling has been accelerated in response to the COVID-19 pandemic. The proposal follows , and so is unlikely to change significantly, however we welcome your contribution to the with any thoughts and feedback from your implementation.
The standard opening hours of a may be described using the openingHoursSpecification
property as documented below. Note this property must not be used to define exceptional hours, such as specific public holidays, closures due to bad weather, or a pandemic-related lockdown.
Excluding the validFrom
and validThrough
properties signifies that the hours are valid year-round. This example shows a business open every day from 6:30am until 21:30pm:
The dayOfWeek
value of https://schema.org/PublicHolidays
is defined as a placeholder for all official public holidays in the location
in which the Place
is located. It can be used to indicate opening hours on public holidays, overriding general opening hours for the day of the week on which a public holiday occurs:
For Places that are open only seasonally (for example an Ice Rink), both the validFrom
and validThrough
may be used. This example shows a business open only during weekends during the winter holidays:
To show a business as open 24 hours a day, set the open
property to "00:00"
and the closes
property to "23:59"
.
To show a business is closed all day, set both opens
and closes
properties to "00:00"
.
This example shows a business open all day Saturday and closed all day Sunday:
For hours past midnight, define opening and closing hours using a single OpeningHoursSpecification
property. This example defines hours from Saturday at 6pm until Sunday at 3am:
For days with multiple hours, these must be provided as separate instances of OpeningHoursSpecification
.
This example defines the following hours:
Use specialOpeningHoursSpecification
combined with validFrom
and validThrough
properties to specify opening hours for specific public holidays. This example shows a business closed on Christmas Day:
Use specialOpeningHoursSpecification
combined with validFrom
and validThrough
properties to specify closure during specific dates. This example shows a business closed completely for all of January:
The specialOpeningHoursSpecification
property of the is used to explicitly override standard opening hours brought in scope by . Note this property must not be used to define standard hours, and should instead describe exceptions such as specific public holidays, closures due to bad weather, or a pandemic-related lockdown.