Calendar
La donnée Calendar permet de spécifier un calendrier spécifique pour le Livre.
Liste des données
- nbDays : Nombre de jours dans une année, sur 3 chiffres.
- days : Liste des jours de la semaine, et de ses abrégés, au maximum 10 jours.
- months : Liste des mois dans une année, et de ses abrégés, au maximum 99 mois.
- hours : Nombre d'heures dans une journée, au maximum 99 heures.
- minutes : Nombre de minutes dans une heure, au maximum 99 minutes.
- seconds : Nombre de secondes dans une minutes, au maximum 99 secondes.
- first : Index du jour de la semaine de la date 0001-01-01, soit le premier jour, du premier mois, de la première année. Une année zéro ne peut exister.
Fonctions associées
- month() : Numéro du mois dans l'année
- monthName() : Nom du mois de l'année
- monthShort() : Nom abrégé du mois de l'année
- day() : Numéro du jour de la semaine
- dayName() : Nom du jour de la semaine
- dayShort() : Nom abrégé du jour de la semain
- week() : Numéro de la semaine dans l'année
- diff(SbDate) : Calcul de la différence entre deux dates.
- formatDate() : Traduction d'une date seule en son équivalent littéral.
- formatTime() : Traduction de l'heure seule en son équivalent littéral.
- format() : combinaisonde formatDate et FormatTime pour obtenir l'équivalent littéral d'une date.
- format(String) : Traduction d'une date en son équivalent littéral selon le format spécifié. Le format utilise les éléments de description suivants :
- Y : année sans zéro non significatif
- YY...YY : année avec les zéros non significatifs de manière à obtenir un nombre à n chiffres correspondant au nombre de Y
- M : numéro du mois sur deux chiffres
- MM : nom abrégé du mois
- MMMM : nom complet du mois
- D : numéro du jour dans le mois sur deux chiffres
- DD : nom abrégé du jour dans la semaine
- DDDD : nom complet du jour dans la semaine
- h : heure sur deux chiffres
- m : minute sur deux chiffres
- s : seconde sur deux chiffres
- tout autre caractère est purement et simplement copié dans le résultat. Le format standard est "YYYY-M-D h:m:s". Pour obtenir une date au format traditionnel en français on utilisera "D/M/YYYY". Pour obtenir une date avec les noms du jour et du mois on peut utiliser par exemple le format "DDDD D MMMM YYYY".
- add(String durée) : Calcule d'une date à laquelle on ajoute une durée, la durée respecte le format de base d'une SbDate dans laquelle on peut ommettre l'année, le mois, le jour, l'heure, la minute et la seconde. De plus la durée peut être négative, dans ce cas le première caractère sera le signe moins. Exemple " 0:5:0" ajoute 5 minutes à la date. L'ajout d'une journée se traduira par "0-0-1 ", la présence de l'espcae permet de séparer la date de l'heure. L'ajout d'un mois sera "0-1-0 ". Le séparateur entre année, mois et jour est le tiret, le séparateur entre heure, minute et seconde est le deux-points.
Mémorisation
En interne le calendrier est mémorisé sous forme d'une structure comportant les différents éléments. En externe, le calendrier est enregistré dans une entité BookDetail sous la forme d'une chaine de caractères. Les éléments sont séparés les uns des autres par un point-virgule. Les éléments d'une liste sont séparé par une virgule. Exemple du calendrier standard : "365;lundi,lu,mardi,ma,mercredi,me,jeudi,je,vendredi,ve,samedi,sa,dimanche,di;janvier, jan, février, fev, mars, mar, avril, avr, mai, mai, juin, juin, juillet, juil, août, août, septembre, sept, octobre, oct, novembre, nov, décembre, dec;24;60;60;5"
|
|
|
| 