jours-feries-france
TypeScript icon, indicating that this package has built-in type declarations

1.2.0 • Public • Published

jours-feries-france

Bibliothèque JavaScript/TypeScript pour gérer les jours fériés en France.

Installation

npm install jours-feries-france

Utilisation

import { estJourFerie, isHoliday, getJourFerie, getJoursFeriesAnnee } from 'jours-feries-france';

// Vérifier si une date est un jour férié (avec logs)
console.log(estJourFerie('2025-05-01')); // true
console.log(estJourFerie('01/05/2025')); // true (format français)
console.log(estJourFerie(new Date('2025-05-01'))); // true

// Vérifier si une date est un jour férié (sans logs)
console.log(isHoliday('2025-12-25')); // true
console.log(isHoliday('14/07/2025')); // true
console.log(isHoliday(new Date(2025, 0, 1))); // true

// Obtenir les informations d'un jour férié
const jourFerie = getJourFerie('2025-05-01');
console.log(jourFerie);
// {
//   date: 2025-05-01T00:00:00.000Z,
//   nom: 'Fête du Travail',
//   isRegional: false
// }

// Obtenir tous les jours fériés d'une année
const joursFeries = getJoursFeriesAnnee(2025);
console.log(joursFeries);
// [
//   { date: '2025-01-01', nom: "Jour de l'an", isRegional: false },
//   { date: '2025-04-21', nom: 'Lundi de Pâques', isRegional: false },
//   ...
// ]

// Inclure les jours fériés régionaux (Alsace-Moselle)
const joursRegionaux = getJoursFeriesAnnee(2025, { 
  includeRegional: true, 
  region: 'Alsace-Moselle' 
});

Fonctionnalités

  • Supporte les formats de date ISO (YYYY-MM-DD) et français (DD/MM/YYYY)
  • Supporte les objets JavaScript Date
  • Gère les jours fériés fixes et mobiles
  • Supporte les jours fériés spécifiques à l'Alsace-Moselle
  • Entièrement typé avec TypeScript
  • Zéro dépendance
  • Option pour vérifier les jours fériés sans logs de debug

Jours fériés supportés

Jours fériés nationaux

  • 1er janvier - Jour de l'an
  • Lundi de Pâques (mobile)
  • 1er mai - Fête du Travail
  • 8 mai - Victoire 1945
  • Ascension (mobile)
  • Lundi de Pentecôte (mobile)
  • 14 juillet - Fête nationale
  • 15 août - Assomption
  • 1er novembre - Toussaint
  • 11 novembre - Armistice
  • 25 décembre - Noël

Jours fériés Alsace-Moselle

  • Vendredi Saint (mobile)
  • 26 décembre - Saint-Étienne

Licence

MIT

Package Sidebar

Install

npm i jours-feries-france

Weekly Downloads

9

Version

1.2.0

License

MIT

Unpacked Size

15.8 kB

Total Files

8

Last publish

Collaborators

  • mohamedbenhariz