---
title: "Opening hours"
manual: "TYPO3 EXT:thuecat"
version: "main"
permalink: "https://docs.typo3.org/permalink/werkraummedia/thuecat:frontend-output-opening-hours@main"
source: "Integration/FrontendOutput/OpeningHours.rst"
rendered: "2026-10-09T11:47:03+00:00"
---
# Opening hours {#frontend-output-opening-hours}
## Import {#frontend-output-opening-hours-import}
Opening hours are imported as inline database records (one row per weekday and time span, with an
optional validity range). You do not work with those rows directly: the attraction computes
display-ready shapes from them, and the extension ships one partial per shape for direct use or
adaption as needed.
## Display options {#frontend-output-opening-hours-options}
Three display options are available. Pick one for your `TouristAttraction/Show` template; the
shipped stub renders all three side by side so you can compare them against real data.
| Partial | Accessors | Displays |
| --- | --- | --- |
| `OpeningHours/PerDayTable` | `perDayTable`, `specialPerDayTable` | Every weekday on its own line, closed days included. |
| `OpeningHours/MergedByWeekday` | `mergedByWeekday`, `specialMergedByWeekday` | Weekdays with identical hours on one line, listed one by one. |
| `OpeningHours/MergedByWeekdayRanges` | `mergedByWeekday`, `specialMergedByWeekday` | Like `MergedByWeekday`, consecutive days collapsed into ranges. |
Each display has two accessors: the first holds the regular hours, the `special` one the deviating
hours, for example public holidays. Render the partial once for each.
For an attraction open Monday to Friday 10:00–18:00 and Saturday 10:00–14:00, the three displays
show:
**PerDayTable**
```text
Monday: 10:00–18:00
Tuesday: 10:00–18:00
Wednesday: 10:00–18:00
Thursday: 10:00–18:00
Friday: 10:00–18:00
Saturday: 10:00–14:00
Sunday: closed
```
**MergedByWeekday**
```text
Monday, Tuesday, Wednesday, Thursday, Friday: 10:00–18:00
Saturday: 10:00–14:00
```
**MergedByWeekdayRanges**
```text
Monday–Friday: 10:00–18:00
Saturday: 10:00–14:00
```
### PerDayTable {#frontend-output-opening-hours-per-day-table}
```html
```
- All seven weekdays are always listed, Monday first. A day without hours shows as closed.
- A day with several spans lists them all, separated by commas, for example \``08:00–12:00,
13:00–18:00`\`.
- Public holidays appear as a last line only when upstream supplies hours for them.
Choose it when visitors should see at a glance on which days the attraction is closed.
### MergedByWeekday {#frontend-output-opening-hours-merged-by-weekday}
```html
```
- Weekdays sharing exactly the same spans form one line. The days need not be adjacent: \``Monday,
Wednesday, Friday: 08:00–12:00`\` is one line.
- Closed days are left out entirely. Nothing says that the attraction is closed on Sunday; the day
is simply missing.
- Public holidays always form a line of their own, last, even when their hours match a weekday
group.
Choose it for compact output where the hours are regular.
### MergedByWeekdayRanges {#frontend-output-opening-hours-merged-by-weekday-ranges}
```html
```
This partial uses the same accessors and the same grouping as `MergedByWeekday`. The only
difference is how a line names its days: a run of consecutive days is shortened to its first and
last day. `Monday, Tuesday, Wednesday, Thursday,
Friday` becomes `Monday–Friday`; a group of Monday, Tuesday and Thursday becomes
`Monday–Tuesday, Thursday`.
Closed days and public holidays behave as in `MergedByWeekday`. Ranges do not wrap around the
week: Sunday and Monday are never joined.
## What all partials share {#frontend-output-opening-hours-common}
All three partials take the same two arguments:
================== ========================================================== Argument Meaning
================== ========================================================== `openingHours` One
of the accessors listed for that partial. `heading` A translation key for the section heading.
================== ==========================================================
The partials render nothing when there are no hours, so an empty section and its heading never
appear. This is what lets you render the special hours unconditionally.
Opening hours can be limited to a validity range, for example summer and winter hours. Every partial
handles them the same way:
- Each range is rendered as a block of its own, headed by its dates (`01.04.2026 – 31.10.2026`, a
start date alone, or `until 31.10.2026`). Hours without a range get no date line.
- Ranges that have ended are not shown.
- The range covering today comes first. Later ranges follow by start date, each marked
**Upcoming**.
Weekday names, **closed**, **Upcoming** and **until** come from
[`EXT:thuecat/Resources/Private/Language/locallang.xlf`](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ExtensionArchitecture/FileStructure/Resources/Private/Language.html#file-extension-resources-private-language-locallang-xlf), keys `content.openingHour.weekday.*`
and `content.openingHours.*`.
> [!IMPORTANT]
> Which range is current, which ranges have ended, and therefore what the partials show, is decided
> when the page is rendered. The detail page is cached, so the output stays as it was rendered
> until its page cache entry expires or is cleared.
## Writing your own partial {#frontend-output-opening-hours-custom}
Override a partial through `partialRootPaths` as described in [Frontend output](https://docs.typo3.org/permalink/werkraummedia/thuecat:frontend-output@main), keeping its
name, or add one of your own. The accessors provide the following shapes.
`perDayTable` and `specialPerDayTable`:
```text
periods[] validFrom, validThrough (both optional), current
weekDays[] dayOfWeek, closed
timePeriods[] opens, closes
```
`mergedByWeekday` and `specialMergedByWeekday`:
```text
periods[] validFrom, validThrough (both optional), current
weekDayGroups[] daysOfWeek (list of day names)
dayRanges[] firstDay, lastDay, range
timePeriods[] opens, closes
```
`dayOfWeek`, `daysOfWeek`, `firstDay` and `lastDay` hold the English day name (`Monday` …
`Sunday`, `PublicHolidays`), which is the suffix of the weekday translation key. `opens` and
`closes` are date objects; format them with `f:format.date(format: 'H:i')`. `range` is
false for a single day.
> [!NOTE]
> Both shapes also carry `openNow`. It is evaluated in the server's time zone when the page is
> rendered and then cached with the page, so it is not reliable for visitors. Resolve the current
> open or closed state client-side if you need it.