Périodes d’ouverture

Les ouvertures (champ ouverture) permettent de déterminer quand un objet touristique est accessible aux visiteurs.

Conseils d’utilisation

En fonction des besoins de votre application, plusieurs informations sont disponibles avec des niveaux de complexité d’exploitation différentes. Il est important de déterminer quels sont les besoins à traiter de manière à exploiter le plus judicieusement possible les informations à disposition.

Le champ à favoriser, sauf besoin plus précis, est le champ periodeEnClair. C’est un champ textuel simple (internationalisé).

En cas de besoin de recherche (quel objet est ouvert tel jour), favorisez l’utilisation du champ datesOuverture (disponible dans les API ou exports) ou des recherches API qui vous fournissent l’information de manière simple en interprétant pour vous les périodes d’ouverture.

N’utilisez l’interprétation des périodes d’ouverture que si cela s’avère nécessaire. Simplifiez-vous la vie avec les champs periodeEnClair ou datesOuverture autant que possible.

> Outils pour l’exploitation des ouvertures

Champ ouverture

Nom du champTypeContenu
ouvertTouteLAnneeenum« OUVERT_TOUTE_L_ANNEE » ou rien
Sert principalement pour pour gérer la saisie.
fermeTemporairementenum« FERME_TEMPORAIREMENT » ou rien
Indique si un établissement est fermé. Les périodes d’ouverture classiques restent disponibles.
periodeEnClairlibellé internationaliséla période en clair
indicationsPeriodeliste d’éléments de référenceIndication sur la saisonnalité. Indication sur des cas particuliers (Fermé le lundi soir, …)
Attention : les valeurs été, automne, hiver, printemps sont auto gérées : vous ne pouvez ni les ajouter, ni les supprimer (ignorées silencieusement lors de l’écriture).
ouverturesComplementairesliste d’éléments de référenceSert entre autre à la génération automatique du libellé en clair (à la demande, ouvert 24h/24, …)
periodesOuverturesliste de périodes d’ouvertureVoir la suite
fermeturesExceptionnellesliste de fermetures exceptionnellesVoir la suite. Ces informations sont à combiner avec les périodes pour déterminer les jours d’ouverture

Périodes d’ouverture

Les périodes d’ouverture sont stockées dans le champ ouverture.periodesOuvertures.

Les types de période disponibles sont les suivants :

  • OUVERTURE_TOUS_LES_JOURS : indique que l’objet est ouvert tous les jours sur la période indiquée. Les listes ouverturesJourDuMois et ouverturesJournalieres sont vides.
  • OUVERTURE_SAUF : indique que l’objet est ouvert tous les jours sur la période indiquée sauf les jours de la semaine indiqués dans la liste ouverturesJournalieres. Si aucune ouverturesJournalieres n’est présente, alors il faut considérer une ouverture tous les jours de la semaine.
  • OUVERTURE_SEMAINE : indique que l’objet est ouvert seulement les jours de la semaine indiqués dans ouverturesJournalieres sur la période indiquée.
  • OUVERTURE_MOIS : indique que l’objet est ouvert seulement les jours du mois indiqués dans la liste ouverturesJourDuMois sur la période indiquée.

Si le booléen tousLesAns est à true, les années présentes dans les dates ne doivent pas être prises en compte. Les dates restent valable sur toutes les années, celle en cours, celle à venir, etc.

Nom du champTypeContenu
nomlibellé internationalisénon utilisé
complementHorairelibellé internationaliséComplément d’informations sur la période d’ouverture
dateDebut datedébut de la période, date inclue dans la période.
dateFindatefin de la période, inclus dans la période.
horaireOuvertureheureheure d’ouverture, peut être absent.
horaireFermetureheureheure de fermeture ; peut être absent.
typeenumVoir liste ci-dessus.
tousLesAnsbooléenIndique si la période est à prendre en compte tous les ans.Dans ce cas, l’année indiquée pour les débuts et fins de périodes ne sont pas significatives. Il faut considérer que la période s’applique de manière continuelle.
ouverturesJournaliereVoir la suiteseulement pour les OUVERTURE_SAUF et OUVERTURE_SEMAINE
ouverturesJourDuMoisVoir la suiteseulement pour les OUVERTURE_MOIS
ouverturesExceptionnellesVoir la suite 
identifiantTechnique   entieridentifiant unique correspondant à la version de saisie de la tranche horaire

Ouverture jour du mois

L’ouverture jour du mois permet de définir les jours du mois concernés par une période OUVERTURE_MOIS.

Nom du champTypeContenu
jourDuMoisenumPermet de définir quel est le jour du mois concerné (exemple : Lundi et D_1ER = le premier lundi du mois)D_1ER : premierD_2EME : deuxièmeD_3EME : troisièmeD_4EME : quatrièmeD_DERNIER : dernier
jourenumLUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE

Ouverture journalière

L’ouverture jour du mois permet de définir les jours du mois concernés par une période OUVERTURE_SAUF ou OUVERTURE_SEMAINE.

Nom du champTypeContenu
jourenumLUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE, TOUS

Fermeture exceptionnelle

Nom du champTypeContenu
dateFermeturedatenull si dateSpeciale. Sinon la date de fermeture exceptionnelle au format yyyy-mm-dd
dateSpecialeenumnull si dateFermeture présente. Sinon :PREMIER_JANVIERBERCHTOLDSTAG : (suisse) 2 janvierSAINT_JOSEPH : (suisse) 19 marsVENDREDI_SAINTLUNDI_PAQUESASCENSIONLUNDI_PENTECOTEPREMIER_MAIHUIT_MAIQUATORZE_JUILLETFETE_DIEU (suisse)FETE_NATIONALE_SUISSE : (suisse) 1er aoûtQUINZE_AOUTLUNDI_DU_JEUNE_FEDERAL (suisse)PREMIER_NOVEMBREONZE_NOVEMBREIMMACULEE_CONCEPTION : (suisse) 8 décembreVINGT_CINQ_DECEMBRE

Pour les dates variant chaque année, voici le détail jusqu’en 2025 :

VENDREDI_SAINT (suisse)

  • 3 avril 2015
  • 25 mars 2016
  • 14 avril 2017
  • 30 mars 2018
  • 19 avril 2019
  • 10 avril 2020
  • 2 avril 2021
  • 15 avril 2022
  • 7 avril 2023
  • 29 mars 2024
  • 18 avril 2025

LUNDI_PAQUES

  • 6 avril 2015
  • 28 mars 2016
  • 17 avril 2017
  • 2 avril 2018
  • 22 avril 2019
  • 13 avril 2020
  • 5 avril 2021
  • 18 avril 2022
  • 10 avril 2023
  • 1 avril 2024
  • 21 avril 2025

ASCENSION

  • 14 mai 2015
  • 5 mai 2016
  • 25 mai 2017
  • 10 mai 2018
  • 30 mai 2019
  • 21 mai 2020
  • 13 mai 2021
  • 26 mai 2022
  • 18 mai 2023
  • 9 mai 2024
  • 29 mai 2025

LUNDI_PENTECOTE

  • 25 mai 2015
  • 16 mai 2016
  • 5 juin 2017
  • 21 mai 2018
  • 10 juin 2019
  • 1 juin 2020
  • 24 mai 2021
  • 6 juin 2022
  • 29 mai 2023
  • 20 mai 2024
  • 9 juin 2025

FETE_DIEU (suisse)

  • 4 juin 2015
  • 26 mai 2016
  • 15 juin 2017
  • 31 mai 2018
  • 20 juin 2019
  • 11 juin 2020
  • 03 juin 2021
  • 16 juin 2022
  • 08 juin 2023
  • 30 mai 2024
  • 19 juin 2025

LUNDI_DU_JEUNE_FEDERAL (suisse)

  • 21 septembre 2015
  • 19 septembre 2016
  • 18 septembre 2017
  • 17 septembre 2018
  • 16 septembre 2019
  • 21 septembre 2020
  • 20 septembre 2021
  • 19 septembre 2022
  • 18 septembre 2023
  • 16 septembre 2024
  • 22 septembre 2025

Ouverture exceptionnelle

L’ouverture exceptionnelle s’applique à une période. Elle permet de spécifier un jour d’ouverture de manière individuelle.

Nom du champTypeContenu
dateOuverturedatela date d’ouverture au format yyyy-mm-dd