Documentation technique

Accueil / Documentation technique / Flux v1 / Formats des objets (v1) / Périodes d’ouverture (v1)

Périodes d'ouverture (v1)

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
ouvertTouteLAnnee enum

« OUVERT_TOUTE_L_ANNEE » ou rien
Sert principalement pour pour gérer la saisie.

fermeTemporairement enum

« FERME_TEMPORAIREMENT » ou rien
Indique si un établissement est fermé. Les périodes d’ouverture classiques restent disponibles.

periodeEnClair libellé internationalisé la période en clair
indicationsPeriode liste d’éléments de référence Indication sur la saisonnalité. Indication sur des cas particuliers (Fermé le lundi soir, …)
ouverturesComplementaires liste d’éléments de référence Sert entre autre à la génération automatique du libellé en clair (à la demande, ouvert 24h/24, …)
periodesOuvertures liste de périodes d’ouverture Voir la suite
fermeturesExceptionnelles liste de fermetures exceptionnelles Voir 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.
Nom du champTypeContenu
nom libellé internationalisé non utilisé
complementHoraire libellé internationalisé Complément d’informations sur la période d’ouverture
dateDebut  date début de la période, date inclue dans la période.
dateFin date fin de la période, inclus dans la période.
horaireOuverture heure heure d’ouverture, peut être absent.
horaireFermeture heure heure de fermeture ; peut être absent.
type enum Voir liste ci-dessus.
tousLesAns booléen

Indique 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.

ouverturesJournaliere Voir la suite seulement pour les OUVERTURE_SAUF et OUVERTURE_SEMAINE
ouverturesJourDuMois Voir la suite seulement pour les OUVERTURE_MOIS
ouverturesExceptionnelles Voir la suite  

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
jourDuMois enum

Permet de définir quel est le jour du mois concerné (exemple : Lundi et D_1ER = le premier lundi du mois)

  • D_1ER : premier
  • D_2EME : deuxième
  • D_3EME : troisième
  • D_4EME : quatrième
  • D_DERNIER : dernier
jour enum LUNDI, 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
jour enum LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE, TOUS

Fermeture exceptionnelle

Nom du champTypeContenu
dateFermeture date null si dateSpeciale. Sinon la date de fermeture exceptionnelle au format yyyy-mm-dd
dateSpeciale enum

null si dateFermeture présente. Sinon :

  • PREMIER_JANVIER
  • BERCHTOLDSTAG : (suisse) 2 janvier
  • SAINT_JOSEPH : (suisse) 19 mars
  • VENDREDI_SAINT
  • LUNDI_PAQUES
  • ASCENSION
  • LUNDI_PENTECOTE
  • PREMIER_MAI
  • HUIT_MAI
  • QUATORZE_JUILLET
  • FETE_DIEU (suisse)
  • FETE_NATIONALE_SUISSE : (suisse) 1er août
  • QUINZE_AOUT
  • LUNDI_DU_JEUNE_FEDERAL (suisse)
  • PREMIER_NOVEMBRE
  • ONZE_NOVEMBRE
  • IMMACULEE_CONCEPTION : (suisse) 8 décembre
  • VINGT_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
dateOuverture date la date d’ouverture au format yyyy-mm-dd