DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Calendrier
  • Présentation
  • Gestion des jours fériés
  • Gestion de la multisélection
  • Récupérer la multisélection
  • Gestion de la sélection d'une période
  • Fonctions WLangage
  • Fonctions de gestion des jours fériés
  • Fonctions de gestion du champ Calendrier
  • Propriétés spécifiques aux champs Calendrier
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
WINDEV, WEBDEV et WINDEV Mobile permettent de manipuler un champ Calendrier directement par programmation. Il suffit d'utiliser directement la variable du champ Calendrier dans le code.
La variable du champ Calendrier correspond à la date sélectionnée (si le champ est multisélections ou avec sélection de période, la variable correspond à la première date sélectionnée). Cette date utilise le format spécifié dans le champ "Format mémorisé " de l'onglet "Général" de la description du champ. Cette variable est de type chaîne.
Le champ Calendrier peut être manipulé par programmation :
Le champ Calendrier est associé à plusieurs traitements WLangage.
Remarques :
  • Il est également possible de manipuler un jour d'un champ Calendrier par programmation. Pour plus de détails, consultez Gestion des jours de calendrier.
  • WINDEV, WEBDEV et WINDEV Mobile gèrent automatiquement le changement de mois ou d'année par l'utilisateur.
Gestion des jours fériés
La gestion des jours fériés est réalisée par programmation. Le WLangage met à votre disposition plusieurs fonctions débutant par JourFériéXXX.
Pour définir les jours fériés affichés dans un champ Calendrier, il faut utiliser la fonction JourFériéAjoute. Cette fonction permet de définir la liste des jours fériés à utiliser. Cette fonction permet de personnaliser les jours fériés en fonction du pays et de la réglementation locale. Cette fonction doit être utilisée au début de l'application car elle a un effet global sur l'application.
Exemple :
// Suppression de tous les jours fériés
JourFériéSupprimeTout()
// Initialisation des 11 jours fériés communs aux départements français et DOM/TOM
JourFériéAjoute("0101") // 1er Janvier
JourFériéAjoute(jfLundiDePâques) // Lundi de Pâques
JourFériéAjoute("0501") // 1er Mai
JourFériéAjoute("0508") // 8 Mai
JourFériéAjoute(jfJeudiDeLAscension) // Jeudi de l'Ascension
JourFériéAjoute(jfLundiDePentecôte) // Lundi de Pentecôte
JourFériéAjoute("0714") // 14 Juillet
JourFériéAjoute("0815") // 15 Août (Assomption)
JourFériéAjoute("1101") // Toussaint
JourFériéAjoute("1111") // 11 Novembre
JourFériéAjoute("1225") // Noël

// Ajout de 2 jours fériés supplémentaires pour la Moselle et l'Alsace
JourFériéAjoute("1226" + RC + jfVendrediSaint)
Gestion de la multisélection
WINDEVUniversal Windows 10 AppAndroidJava

Récupérer la multisélection

Un champ Calendrier peut être multisélection : le champ Calendrier permet alors de sélectionner plusieurs dates. Il suffit pour cela que l'option " Sélection multiple" soit cochée dans l'onglet "Détail" de la fenêtre de description du champ. Il est également possible d'utiliser la propriété Multisélection.
Pour récupérer les différentes dates sélectionnées, il suffit d'utiliser les fonctions CalendrierXXX du WLangage.
Exemple :
// Parcours des dates sélectionnées dans le champ Calendrier
POUR I = 1 _À_ CalendrierSelectOccurrence(CAL_Calendrier1)
Trace(CalendrierSelect(CAL_Calendrier1, I))
FIN
WINDEVUniversal Windows 10 AppAndroidJava

Gestion de la sélection d'une période

Un champ Calendrier peut proposer la sélection d'une période : le champ Calendrier permet alors de sélectionner la date de début et la date de fin de la période. Les jours présents entre ces deux dates sont automatiquement sélectionnés.
Pour permettre la sélection d'une période, il suffit que l'option " Sélection de période" soit cochée dans l'onglet "Détail" de la fenêtre de description du champ.
En exécution, pour sélectionner une période, il suffit de cliquer directement dans le champ Calendrier : le premier clic permet de sélectionner la date de début de la période, le second clic permet de sélectionner la date de fin de la période.

WINDEVUniversal Windows 10 AppAndroidJava Si le bouton "Aujourd'hui" est affiché (onglet "Détail" de la fenêtre de description), le menu contextuel de ce bouton propose des périodes prédéfinies. L'utilisateur peut ainsi simplement sélectionner la période voulue.
Pour récupérer la date de début et la date de fin de la période sélectionnée, il suffit d'utiliser les propriétés DateDébut et DateFin du WLangage.
Exemple :
NbJour est un entier
NbJour = DateDifférence(CAL_Calendrier1.DateDébut, CAL_Calendrier1.DateFin) + 1
Info("Période sélectionnée : du " + DateVersChaîne(CAL_Calendrier1.DateDébut) + ...
" au " + DateVersChaîne(CAL_Calendrier1.DateFin) + ...
" soit " + NbJour + " jour(s)")
Fonctions WLangage

Fonctions de gestion des jours fériés

Les fonctions de gestion des jours fériés sont les suivantes :
JourFériéIndique si un jour est férié ou non.
JourFériéAjouteIndique qu'un jour ou qu'une liste de jours est férié.
JourFériéSupprimeToutVide la liste de tous les jours fériés.

Fonctions de gestion du champ Calendrier

Les fonctions de gestion du champ Calendrier sont les suivantes :
CalendrierPositionRenvoie le mois affiché dans un champ Calendrier.
CalendrierSelectRenvoie la date sélectionnée dans un champ Calendrier.
CalendrierSelectMoinsDésélectionne une date dans un champ Calendrier multisélection.
CalendrierSelectOccurrenceRenvoie le nombre de jours sélectionnés dans un champ Calendrier.
CalendrierSelectPlusSélectionne une date dans un champ Calendrier.
Propriétés spécifiques aux champs Calendrier
Les propriétés suivantes sont spécifiques à la gestion d'un champ Calendrier par programmation.
BorneMaxPermet de connaître et de modifier la borne maximale du champ Calendrier.
BorneMinPermet de connaître et de modifier la borne minimale du champ Calendrier.
DateDébutPermet de connaître et de modifier la date de début d'une période sélectionnée dans un champ Calendrier.
DateFinPermet de connaître et de modifier la date de fin d'une période sélectionnée dans un champ Calendrier.
FormatMémoriséPermet de connaître et de modifier le format de la valeur retournée par le champ Calendrier.
ImagePermet de connaître et de modifier l'image de fond du champ Calendrier.
MultisélectionPermet de connaître et de modifier le mode de sélection d'un champ Calendrier

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Calendrier, consultez Propriétés associées au champ Calendrier.
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale