Documentation de GénéGraphe

Formatage des dates

Principes - Variables - Numéro du jour - Nom du jour - Numéro du mois - Nom du mois - Année - Précision - Conversion - Exemples

Dans les modèles d'étiquettes pour les personnes ou les familles, certaines variables concernent des dates. Vous pouvez définir la façon dont cette date s'affiche, c'est le formatage de la date.

Principes retour

Les variables concernant des dates admettent un paramètre qui est le format utilisé pour l'affichage de la date. Ce paramètre se place entre les parenthèses qui suivent le nom de la variable. Comme le paramètre est du texte, il est placé entre guillemets. Exemple : dateNais("<j4> le <j1> <m4> de l'année <a4>").

Ce code dit qu'on utilise la variable dateNais avec, comme paramètre, le texte <j4> le <j4> <m4> de l'année <a4>.

Vous voyez que le paramètre de format contient du texte (de l'année), des espaces et des variables (<j4>,<j1> ,<m4> ou <a4>). Ces variables disent quelle partie de la date est utilisée.

Généamania permet de saisir une date au format grégorien ou républicain. GénéGraphe sait dans quel format a été saisie la date et respecte cette saisie.

Si vous ne voulez pas définir de format, l'utilisation de la variable date sans format fera afficher la date avec un format standard. Par exemple le code suivant <dateNais("")> affichera la date du genre 01/01/2011.

Il est possible de demander une conversion de date entre les calendriers républicain et grégorien. Voir le paragraphe à ce sujet.

Variables retour

Les variables permettent d'afficher une partie de la date suivant une certaine mise en forme. Elles sont :.

Variable Description
<j1> Numéro du jour
<j2> Numéro du jour sur 2 chiffres
<j3> Nom du jour format court
<j4> Nom du jour complet
<m1> Numéro du mois
<m2> Numéro du mois sur 2 chiffres
<m3> Nom du mois format court
<m4> Nom du mois complet
<a2> Année sur 2 chiffres
<a4> Année complète
<p1> Précision format court
<p2> Précision format long
<conversion> Conversion vers/de républicain
<finConversion> Fin de conversion vers/de républicain

Numéro du jour retour

Format court : c'est le numéro du jour sans mise en forme.
Format long : le numéro du jour est formaté sur 2 chiffres.
Exemples :

Date Format court Format long
01/01/2011 1 01
15/01/2011 15 15
6 floréal an V 6 06
16 floréal an V 16 16

Nom du jour retour

Format court : c'est le nom du jour en abrégé.
Pour les dates du calendrier grégorien, les noms sont : « lu », « ma », « me », « je », « ve », « sa », « di ».
Pour les dates au format républicain, les noms sont : « pri. », « duo. », « tri. », « quar. », « quin. », « sex. », « sep. », « oc. », « no. », « dé. ». Les noms des jours du 13e mois républicain sont « j. vertu », « j. génie », « j. travail », « j. opinion », « j. récom. », « j. révo. ».

Format long : le nom du jour est écrit en totalité.
Pour les dates du calendrier grégorien, les noms sont : « lundi », « mardi », « mercredi », « jeudi », « vendredi », « samedi », « dimanche ».
Pour les dates au format républicain, les noms sont : « primidi », « duodi », « tridi », « quartidi », « quintidi », « sextidi », « septidi », « octidi », « nonidi », « décadi ». Les noms des jours du 13e mois républicain sont « jour de la vertu », « jour du génie », « jour du travail », « jour de l'opinion », « jour des récompenses », « jour de la révolution ».

Exemples :

Date Format court Format long
01/01/2011 sa samedi
6 floréal an V sex. sextidi

Numéro du mois retour

Format court : c'est le numéro du mois sans mise en forme.
Format long : le numéro du mois est formaté sur 2 chiffres.
Exemples :

Date Format court Format long
01/01/2011 1 01
15/11/2011 11 11
6 floréal an V 8 08
1er thermidor an VIII 11 11

Attention, le calendrier républicain comprend 13 mois et le 13e mois a 5 ou 6 jours, suivant que l'année est bisextile ou non.

Nom du mois retour

Format court : c'est le nom du mois en version courte.
Dans le calendrier grégorien, les mois sont : « jan. », « févr. », « mars », « avr. », « mai », « juin », « juil. », « août », « sept. », « oct. », « nov. », « déc. ».
Dans le calendrier républicain, les mois sont : « ven », « bru », « fri », « niv », « plu », « ven », « ger », « flo », « pra », « mes », « the », « fru », « san ».

Format long : utilisation du nom du mois complet.
Dans le calendrier grégorien, il s'agit de « janvier », « février », « mars », « avril », « mai », « juin », « juillet », « août », « septembre », « octobre », « novembre », « décembre ».
Dans le calendrier républicain, ce sont : « vendémiaire », « brumaire », « frimaire », « nivôse », « pluviôse », « ventôse », « germinal », « floréal », « prairial », « messidor », « thermidor », « fructidor », « sanculottides ».

Exemples :

Date Format court Format long
01/01/2011 jan. janvier
6 floréal an V flo floréal

Attention, le calendrier républicain comprend 13 mois.

Année retour

Format court : pour le calendrier grégorien, on utilise les 2 derniers chiffres de l'année. Pour le calendrier républicain, on utilise une forme courte (voir exemple).

Format long : pour le calendrier grégorien, on utilise l'année en totalité. Pour le calendrier républicain, on utilise une forme longue (voir exemple).

Exemples :

Date Format court Format long
01/01/2011 11 2011
6 floréal an V an V de l'an V

Précision retour

C'est la précision qui est indiquée quand on saisit une date dans Généamania.

Exemples :

Précision Format court Format long
Le le le
Environ ca environ
Avant av. avant le
Après ap. après le

Pour les précisions « avant » et après », le format long met l'article « le » si la date est supposée exacte (le jour et le mois sont différents de 1). Sinon, la date est supposée approximative et l'article n'est pas utilisé.

Conversion retour

Si la date saisie dans Généamania est au format républicain, la conversion affichera sa correspondance dans le calendrier grégorien.
Si la date saisie est au format grégorien et qu'elle correspond à la période d'utilisation du calendrier républicain qui va du 22 septembre 1792 (1er vendémiaire an I) au 30 septembre 1805 (8 vendémiaire an XIV), la conversion affichera la correspondance dans le calendrier républicain.
Si la date ne correspond pas aux cas énoncés ci-dessus, tout ce qui est mis entre les codes <conversion> et <finConversion> ne sera pas pris en compte.

Le code <finConversion> n'est pas obligatoire. La conversion se fait jusqu'à la fin du format de la date. Ce code existe si vous voulez arrêter la conversion pour reprendre l'utilisation du calendrier par défaut (exemple fourni avec les exemples de modèles d'étiquettes).

Exemples retour

Date Format Affichage
01/01/2011 <j1>/<m1>/<a4> 01/01/2011
01/01/2011 <p1> <j4> <j1> <m4> <a4> le samedi 1 janvier 2011
01/01/2011 <j1>/<m1>/<a4><conversion><j1>/<m1>/<a4><finConversion> 01/01/2011
10 vendémiaire an V <j1>/<m1>/<a2> 1/1/an V
10 vendémiaire 'an V <conversion><j1>/<m1>/<a2><j1>/<m1>/<a2><finConversion> 22/9/96
22 septembre 1796 <j1> <m4> <a4><conversion> (<j1> <m4> <a4>)<finConversion> 22 septembre 1796 (1 vendémiaire de l'an V)
6 sanculottides an III <j1> <m4> <a4><conversion> (<j1> <m4> <a4>)<finConversion> 6 sanculottides de l'an III (22 septembre 1795)

D'autres exemples sont donnés dans les exemples de modèles d'étiquettes.