Aller au contenu

businessHours

Les heures d’ouverture d’un lieu : grisées en dehors dans la grille horaire, et ce à quoi rules peut tenir les gestes.

TypeBusinessHoursInput — boolean | BusinessHoursRule | readonly BusinessHoursRule[]
Par défautnon défini
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/kernel.ts

Trois formes :

  • true : du lundi au vendredi, de 09:00 à 17:00 ; false : aucune.
  • Une règle : { daysOfWeek: [1, 2, 3, 4, 5], start: '08:30', end: '18:00' }.
  • Plusieurs règles, pour une pause de midi ou un samedi différent : [{ daysOfWeek: [1, 2, 3, 4, 5], start: '08:30', end: '12:30' }, { daysOfWeek: [1, 2, 3, 4, 5], start: '14:00', end: '18:00' }].

daysOfWeek sont des jours ISO (1 lundi … 7 dimanche). start et end sont des heures d’horloge ; '24:00' est le minuit suivant, et une fin à ou avant le début passe minuit (22:00–06:00, une garde de nuit). Une règle se lit dans le fuseau du calendrier, ou dans son propre timeZone : une clinique d’Alger garde ses heures sur un calendrier affiché à Paris. Le jour du changement d’heure, une garde a sa vraie durée.

En dehors de ces heures, la grille horaire est grisée, et une grille de jours marque les jours qui n’en ont aucune. Avec rules: { constraint: 'businessHours' }, un déplacement ou un redimensionnement en dehors est refusé.

import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
businessHours: [
{ daysOfWeek: [1, 2, 3, 4, 5], start: '08:30', end: '12:30' },
{ daysOfWeek: [1, 2, 3, 4, 5], start: '14:00', end: '18:00' },
],
editable: true,
// A drag or a resize outside the hours is refused.
rules: { constraint: 'businessHours' },
});
// Later: the default hours (Monday to Friday, 9:00–17:00).
calendar.update({ businessHours: true });

Dans les frameworks, c’est une entrée : businessHours en Angular, businessHours en React, business-hours en Vue.

En semaine, ouvert 08:30–12:30 et 14:00–18:00 ; le reste est grisé.

  • timeZone — le fuseau où se lisent les règles, sauf si elles nomment le leur.
  • weekends — les jours montrés.
  • Glisser-déposer — les gestes tenus aux heures.