Timecode (TimeBundle)

De SOS Paris
Aller à : navigation, rechercher
Time.png
Module Time
Nom Timecode
Version 2.0
Github https://github.com/AriiPortal/TimeBundle

Timecode est un module de calcul de dates complexes. Il s'appuie sur un système de règles original dont le but principal est de calculer des dates ou des fréquences à partir d'une formule.

Objets

Zones

Une zone est un espace géographique dans lequel s'applique les règles, elle est liée à un pays pour regrouper les règles étendues sur plusieurs fuseaux horaires ou pour les pays qui contiennent des zones avec des jours fériés différents (Etats américains, cantons suisses, etc...).

Dans le cas de la France, on considérera les territoires et départements d'outre-mer mais aussi les départements comme l’Alsace disposant de jours fériés particuliers.

Règles

La règle est le code qui va définir un jour particulier.

Par exemple:

  • 0101: 1er Janvier (jour et mois fixes tous les ans)
  • BM1: Premier jour ouvré du mois
  • @E: Dimanche de pâques
  • @E+39D: Ascension (Pâques + 39 jours)

Références

Les références sont un ensemble de règles, elles servent de bases de calcul aux code.

Par exemple, FR est l'ensemble des jours fériés français, cette référence contiendra les jours suivants:

  • Jour de l'an (0101)
  • Lundi de Pâques (@E+1D)
  • Fête du travail (0501)
  • 8 Mai 1945 (0508)
  • Jeudi de l'ascension (@E+39D)
  • Lundi de Pentecôte (@E+49D)
  • Fête Nationale (0714)
  • Assomption (0815)
  • La Toussaint (1101)
  • Armistice (1111)
  • Noël (1225)

Cette référence servira à calculer le premier jour ouvré du mois en France: FR+BM1