D002_Date

SbDate : type de donnée

Calendrier

oStorybook offre la possibilité de paramétrer un calendrier spécifique. Ce calendrier permet de déterminer:

• le nombre de jours dans une années,
• le nombre de mois, leurs noms et abréviations, limité à un maximum de 99 mois
• le nombre de jours dans une semaine, leurs noms et abréviations, limité à un maximum de 9 jours
• le nombre d'heures dans une journée
• le nombre de minutes dans une heure
• le nombre de secondes dans une minute
• le jour de la semaine correspondant à la date du 01/01/0000, soit le premier jour de l'année 0. Limité par le nombre de jours dans une semaine.

Le nombre d'heures, de minutes et de secondes est limité à un maximum de 99.

Date

Le format d'une date suit les prescriptions de la norme ISO-8601. À savoir:

• y : l'année, sans cadrage particulier
• y...y : l'année sur n chiffres, selon le nombre de y, avec les zéros non
  significatifs
• M : le mois, sans format précis, c'est le numéro du mois dans l'année.
• MM : le mois sur deux chiffres obligatoirement, donc selon les besoins, avec
  un zéro non significatif.
• MMM : le nom abrégé du mois.
• MMMM : le nom complet du mois.
• d : le numéro du jour dans le mois, sans format particulier.
• dd : le numéro du jour sur deux chiffres.
• ddd : le nom du jour dans la semaine sous forme abrégée
• dddd : le nom du jour de la semane sous forme étendue
• H et HH : la même chose que pour le jour, mais concernant l'heure.
• m et mm : idem pour les minutes.
• s et ss (ou S et SS) : idem pour les secondes.

Il n'y a pas d'élements pour les décomptes sous la seconde. Le séparateur entre la date du jour et l'heure est le T (t majuscule) ou l'espace. La représentation externe d'une date est donc yyyyMMddTHHmmSS. Il est possible d'intégrer tout autre caractère permettant de mieux lire une date, ainsi le format yyyy/MM/ddTHH:mm:ss est tout à fait autorisé.

Remarque:

La gestion des années réelles, avec une fraction de 0,25 jour par an, les années bisextiles, etc... n'est pas assurée.

Note pour les développeurs:

C'est la classe SbDate, couplée avec la classe SbCalendar, qui s'occupe de gérer tout ça. Est à développer le format ddd et dddd, c'est à dire le nom abrégé du jour et le nom complet correspondant.

Dans le fichier XML les dates sont codées sous la forme yyyyMMddTHHmmSS où:

• yyyy représente l'année, le nombre de chiffres est de 4 au minimum mais peut être plus grand.
• MM est le numéro du mois dans l'année.
• dd est le numéro du jour dans le mois
• HH est l'heure
• mm représente les minutes
• SS représente les secondes.

À part l'année, les autres éléments sont obligatoirement sur deux chiffres.

Index des données