Ce réglage permet de définir comment afficher le moment d'un événement. Lorsque vide, le format par défaut sera la date et l'heure de l'événement selon les normes de la langue en vigueur. Toutefois, il peut être important de changer ce format pour un événement. Par exemple si on veut indiquer une durée par exemple de 17h à 20h ou même pour un événement qui dure plus d'une journée (samedi et dimanche 14 et 15 juin 2019). Il est aussi possible que votre activité vende des billets qui sont valides tous les jours de l'été et dans ce cas on ne peut pas indiquer une date précise alors on pourra mettre "Été 2019" par exemple comme texte.


Tous événements d'une activité doivent avoir une date et une heure qui correspond à son entrée dans le calendrier de l'activité. Ce moment correspond généralement à la date de début de l'événement, mais dans le cas d'une vente de billets valides pour une longue période, la date sera la date de fin de la saison par exemple. La billetterie utilise la date des événements pour décider s'ils sont passés ou non afin de les inclure dans la liste disponible. À noter qu'il y a quelques réglages pour contrôler quels événements sont présentés dans la billetterie, mais en général, tous les événements à venir sont inclus. Pour cette raison un événement saisonnier doit utiliser la date de fermeture et non la date d'ouverture, car dès cette date passée, la billetterie ne pourrait plus vendre de billets.


Le réglage Quand est principalement utilisés pour les styles de billetterie "liste d'événements" et "liste de billets", car pour les autres styles "calendrier et liste de jours", c'est vraiment la date et l'heure de l'événement qui servent pour l'affichage dans la billetterie à cause de l'interface usagée spécialisée pour ce genre d'activité très récurrente. Par contre, même dans pour ces styles, le réglage permet de décider comment afficher le moment de l'événement dans la communication avec le client. Pour le style "liste d'événement", chaque événement est affiché individuellement et peut avoir sont propre réglage Quand ce qui est indispensable quand les événements ont divers besoins.


Le réglage Quand permet d'inscrire du texte et d'y combiner la date et l'heure de l'événement dans un format précis. L'usage de codes spéciaux de formatage permet de ne pas devoir inscrire le moment précis de l'événement dans le Quand, mais d'utiliser sa date et heure tel que programmé dans le calendrier. Ainsi on peut changer l'heure par exemple sans devoir changer ce réglage et surtout de pouvoir généraliser la façon de présenter le Quand pour plusieurs événements avec un seul réglage.


Pour insérer des portions de la date et heure il faut utiliser une notion qui utile une syntaxe spéciale:


{when:format} ou {whenCap:format}


C'est le format qui décide quelle portion de la date et heure on veut afficher. La différence entre when et whenCap est simplement que whenCap va mettre la première lettre du texte produit par le format en majuscule. On peut insérer autant de code dans le réglage que requis.


format se compose d’un ou plusieurs codes de format expliqué dans le tableau qui suit. Vous pouvez ajouter du texte littéral entre les codes au besoin, mais il faut mettre ce texte entre "" pour ne pas qu'il soit interprété comme des codes de formatage. Vous pouvez aussi éviter complètement de mettre du texte littéral dans le format et à la place mettre plusieurs sections {when:} et du texte quelconque entre ces codes ce qui est possiblement plus simple.


code de format 
DescriptionExemples et Notes
d
Jour du mois, de 1 à 31

dd
Jour du mois, de 01 à 31

ddd
Nom abrégé du jour de la semaine
lun, mar, mer ...
dddd
Nom complet du jour de la semaine
lundi, mardi, ...
h
Heure, au format de 12 heures, de 1 à 12

hhHeure, au format de 12 heures, de 01 à 12

HHeure, au format de 24 heures, de 0 à 23

HHHeure, au format de 24 heures, de 00 à 23

mMinute, définie entre 0 et 59

mmMinute, définie entre 00 et 59

MMois, de 1 à 12

MMMois, de 01 à 12

MMM
Nom abrégé du mois
jan, fév, mar, ...
MMMMNom complet du mois
janvier, février, ...
sSeconde, de 0 à 59

ssSeconde, de 00 à 59

tPremier caractère de l'indicateur AM/PM
A ou P
ttIndicateur AM/PM
AM ou PM
yAnnée, de 0 à 99, deux derniers chiffres

yyAnnée, de 00 à 99,  deux derniers chiffres

yyyyAnnée, en tant que nombre à quatre chiffres
2019
:Séparateur horaire. Dépends de la langue.
typiquement : mais pourrait être .
/Séparateur de date. Dépends de la langue.
/ - .
"chaîne"
'chaîne'
Délimiteur de chaîne littérale
h "heure" -> donnera 10 heure par exemple
\Délimiteur d'un caractère litéralSimilaire à "" mais sert uniquement pour le prochain caractère



Voici des exemples de réglages pour un événement le 6 juin 2019 à 13h30


Réglage QuandDescriptionExemples et Notes
{when:dddd d MMMM yyyy HH'h'mm}
Version longue d'une date et heure. C'est la valeur par défaut du Quand lorsque non spécifié.mardi 6 juin 2019 13h30
{when:ddd d MMMM yyyy HH'h'mm}
Version courte d'une date et heure
mar. 6 juin 2019 13h30
{when:d MMMM yyyy HH'h'mm}
Version sans le jour de le semaine6 juin 2019 13h30
{when:dddd d MMMM yyyy}
La date uniquementmardi 6 juin 2019
{when:ddd d MMMM yyyy}
La date uniquement en format courtmar. 6 juin 2019
{when:HH'h'mm}
Heure et minutes avec h comme séparateur13h30
{when:HH:mm}
Heure et minutes avec le séparateur propre à la langue courante
13:30 (ou autre selon la langue)



{when:dddd d MMMM yyyy} 5 à 7
Date, mais l'heure est litéralement inscrit, car on ne peut pas l'automatiser avec un code. mardi 6 juin 2019 5 à 7
Fin de semaine du {when:d MMMM yyyy} de 9h à 16hIci la date de l'événement doit être le vendredi ou samedi pour marquer le début de la fin de semaine.
Saison 2019
Été 2019
Hiver 2019
Aucune référence à la date et heure de l'événement. Cas de vente de billets utilisables en tout temps pendant une période de temps.