PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Rappel
  • Masque par défaut
  • Les masques prédéfinis
  • Masque supplémentaire
  • Les masques personnalisés
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation

Rappel

WINDEV, WINDEV Mobile et WEBDEV proposent deux types de masques :
  • les masques de saisie qui définissent les caractères pouvant être saisis dans les champs d'une fenêtre ou d'une page. Parfois, ces masques permettent également de modifier la casse (majuscule / minuscule) des valeurs affectées aux champs d'une fenêtre ou d'une page par programmation.
  • les masques d'affichage qui définissent les caractères pouvant être :
    • Versions 17 et supérieures
      WINDEVWINDEV Mobile affichés dans les champs d'une fenêtre.
      Nouveauté 17
      WINDEVWINDEV Mobile affichés dans les champs d'une fenêtre.
      WINDEVWINDEV Mobile affichés dans les champs d'une fenêtre.
    • imprimés dans les champs d'un état.
Masque par défaut
Par défaut, lors de la création d'un champ de type Date :
  • le masque de saisie "Date définie par le projet" est sélectionné : les informations définies dans les paramètres de gestion des dates pour le projet sont automatiquement pris en compte.Rappel : Ces paramètres sont définis pour chaque langue dans l'onglet "Langues" de la description du projet (option "Projet .. Description du projet"). Rappel : Ces paramètres sont définis pour chaque langue dans l'onglet "Langues" de la description du projet :
    1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    2. Sélectionnez l'onglet "Langues" puis l'onglet "Date".
    3. Le format utilisé correspond :
      • soit aux paramètres du système d'exploitation,
      • soit aux paramètres spécifiés (avec les jours et mois définis).
  • Versions 17 et supérieures
    WINDEVWINDEV Mobile le masque d'affichage "Même masque que la saisie" est sélectionné.
    Nouveauté 17
    WINDEVWINDEV Mobile le masque d'affichage "Même masque que la saisie" est sélectionné.
    WINDEVWINDEV Mobile le masque d'affichage "Même masque que la saisie" est sélectionné.
Remarques :
  • Dans un état, lors de la création d'un champ prédéfini de type Date, l'assistant permet de sélectionner le format d'affichage du champ.
  • Dans la fenêtre de description du champ, une liste de masques prédéfinis est proposée. Vous pouvez au choix :
    • soit sélectionner un masque prédéfini.
    • soit créer un masque personnalisé.
Les masques prédéfinis
Les masques suivants sont proposés (ordre d'apparition sous l'éditeur de fenêtres, de pages et d'états) :
  • la date définie par le projet. La date définie par le projet dépend du format de date sélectionné dans les paramètres de la langue du projet (option "Projet .. Description du projet", onglet "Langues", options linguistiques concernant la date).
  • 'JJ/MM/AAAA' ("01/02/1979" par exemple)
  • 'JJ/MM/AA' ("01/02/79" par exemple)
  • Versions 16 et supérieures
    'JJJ JJ' ("Mar 15" par exemple)
    Nouveauté 16
    'JJJ JJ' ("Mar 15" par exemple)
    'JJJ JJ' ("Mar 15" par exemple)
  • 'MM/JJ/AAAA' ("02/01/1979" par exemple)
  • 'MM/JJ/AA' ("02/01/79" par exemple)
  • 'AAAA/MM/JJ' ("1979/02/01" par exemple)
  • 'AA/MM/JJ' ("79/02/01" par exemple)
  • 'JJ/MM/AAAA HH:mm:SS' ("01/02/1979 21:35:15" par exemple)
  • 'MM/JJ/AAAA HH:mm:SS' ("02/01/1979 21:35:15" par exemple)
  • 'JJ/MM/AAAA HH:mm:SS:CC' ("01/02/1979 21:35:15:10" par exemple)
  • 'MM/JJ/AAAA HH:mm:SS:CC' ("02/01/1979 21:35:15:10" par exemple)
  • 'JJJJ JJ MMMM AAAA' ("Jeudi 01 février 1979" par exemple)
  • Versions 16 et supérieures
    'Jjjj JJ Mmmm AAAA' ("Mardi 13 Juin 2000" par exemple)
    Nouveauté 16
    'Jjjj JJ Mmmm AAAA' ("Mardi 13 Juin 2000" par exemple)
    'Jjjj JJ Mmmm AAAA' ("Mardi 13 Juin 2000" par exemple)
  • Versions 16 et supérieures
    'Jjjj JJ Mmm AAAA' ("Samedi 01 Déc 2001" par exemple)
    Nouveauté 16
    'Jjjj JJ Mmm AAAA' ("Samedi 01 Déc 2001" par exemple)
    'Jjjj JJ Mmm AAAA' ("Samedi 01 Déc 2001" par exemple)
Des masques supplémentaires sont disponibles en WINDEV et WEBDEV :
  • Versions 17 et supérieures
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date (HTML5)
    Nouveauté 17
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date (HTML5)
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date (HTML5)
  • Versions 17 et supérieures
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date et Heure (HTML5)
    Nouveauté 17
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date et Heure (HTML5)
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Date et Heure (HTML5)
  • Versions 18 et supérieures
    WINDEVWINDEV Mobile Durée relative (Hier, dans 3 jours, ...).
    Android Ce masque n'est pas disponible.
    Nouveauté 18
    WINDEVWINDEV Mobile Durée relative (Hier, dans 3 jours, ...).
    Android Ce masque n'est pas disponible.
    WINDEVWINDEV Mobile Durée relative (Hier, dans 3 jours, ...).
    Android Ce masque n'est pas disponible.
Versions 17 et supérieures
WEBDEV - Code ServeurWEBDEV - Code Navigateur Masques supplémentaires
En WEBDEV, il est également possible de sélectionner des masques de saisie HTML 5. Ces masques de saisie permettent d'utiliser les contrôles HTML 5 pour valider la saisie.
Attention : Ces masques ne sont pas gérés par tous les navigateurs et leur fonctionnement peut différer selon le navigateur utilisé.
Les masques de saisie HTML 5 disponibles sont les suivants :
Masque sélectionnéButEffets lors de la saisie dans le champ
Date (HTML5)Saisie d'une date au format AAAA-MM-JJ
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Date et Heure (HTML5)Saisie d'une date et heure au format AAAA-MM-JJTHH:MM
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Non géré.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date et l'heure automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier pour la partie date, et spin permettant de modifier la partie heure.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Nouveauté 17
WEBDEV - Code ServeurWEBDEV - Code Navigateur Masques supplémentaires
En WEBDEV, il est également possible de sélectionner des masques de saisie HTML 5. Ces masques de saisie permettent d'utiliser les contrôles HTML 5 pour valider la saisie.
Attention : Ces masques ne sont pas gérés par tous les navigateurs et leur fonctionnement peut différer selon le navigateur utilisé.
Les masques de saisie HTML 5 disponibles sont les suivants :
Masque sélectionnéButEffets lors de la saisie dans le champ
Date (HTML5)Saisie d'une date au format AAAA-MM-JJ
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Date et Heure (HTML5)Saisie d'une date et heure au format AAAA-MM-JJTHH:MM
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Non géré.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date et l'heure automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier pour la partie date, et spin permettant de modifier la partie heure.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Masques supplémentaires
En WEBDEV, il est également possible de sélectionner des masques de saisie HTML 5. Ces masques de saisie permettent d'utiliser les contrôles HTML 5 pour valider la saisie.
Attention : Ces masques ne sont pas gérés par tous les navigateurs et leur fonctionnement peut différer selon le navigateur utilisé.
Les masques de saisie HTML 5 disponibles sont les suivants :
Masque sélectionnéButEffets lors de la saisie dans le champ
Date (HTML5)Saisie d'une date au format AAAA-MM-JJ
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Date et Heure (HTML5)Saisie d'une date et heure au format AAAA-MM-JJTHH:MM
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Non géré.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date et l'heure automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier pour la partie date, et spin permettant de modifier la partie heure.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Versions 18 et supérieures
WINDEVWINDEV Mobile

Masque supplémentaire

En WINDEV et WINDEV Mobile, il est possible de sélectionner un masque d'affichage supplémentaire : "Durée relative (Hier, dans 3 jours, ...)".
Ce masque permet d'exprimer la durée écoulée (ou à venir) entre la date du jour et la date saisie dans le champ. Ce format est exprimé en langage naturel.
Les différentes formulations utilisées sont configurables dans la description du projet pour la langue en cours :
  1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans l'onglet "Langues" :
    • sélectionnez la langue à configurer.
    • sélectionnez l'onglet "Date".
  3. Cliquez sur le bouton "Dates et Heures en langage naturel".
  4. Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
    • pour le résultat de la fonction DateVersChaîne (utilisée avec la constante maskDateDuréeRelative).
    • pour les champs de saisie de type Date utilisant le masque d'affichage "Durée relative".
AndroidJava Le masque "Durée relative" n'est pas disponible.
Versions 19 et supérieures
AndroidJava Le masque "Durée relative" est désormais disponible.
Nouveauté 19
AndroidJava Le masque "Durée relative" est désormais disponible.
AndroidJava Le masque "Durée relative" est désormais disponible.
Nouveauté 18
WINDEVWINDEV Mobile

Masque supplémentaire

En WINDEV et WINDEV Mobile, il est possible de sélectionner un masque d'affichage supplémentaire : "Durée relative (Hier, dans 3 jours, ...)".
Ce masque permet d'exprimer la durée écoulée (ou à venir) entre la date du jour et la date saisie dans le champ. Ce format est exprimé en langage naturel.
Les différentes formulations utilisées sont configurables dans la description du projet pour la langue en cours :
  1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans l'onglet "Langues" :
    • sélectionnez la langue à configurer.
    • sélectionnez l'onglet "Date".
  3. Cliquez sur le bouton "Dates et Heures en langage naturel".
  4. Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
    • pour le résultat de la fonction DateVersChaîne (utilisée avec la constante maskDateDuréeRelative).
    • pour les champs de saisie de type Date utilisant le masque d'affichage "Durée relative".
AndroidJava Le masque "Durée relative" n'est pas disponible.
Versions 19 et supérieures
AndroidJava Le masque "Durée relative" est désormais disponible.
Nouveauté 19
AndroidJava Le masque "Durée relative" est désormais disponible.
AndroidJava Le masque "Durée relative" est désormais disponible.
WINDEVWINDEV Mobile

Masque supplémentaire

En WINDEV et WINDEV Mobile, il est possible de sélectionner un masque d'affichage supplémentaire : "Durée relative (Hier, dans 3 jours, ...)".
Ce masque permet d'exprimer la durée écoulée (ou à venir) entre la date du jour et la date saisie dans le champ. Ce format est exprimé en langage naturel.
Les différentes formulations utilisées sont configurables dans la description du projet pour la langue en cours :
  1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans l'onglet "Langues" :
    • sélectionnez la langue à configurer.
    • sélectionnez l'onglet "Date".
  3. Cliquez sur le bouton "Dates et Heures en langage naturel".
  4. Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
    • pour le résultat de la fonction DateVersChaîne (utilisée avec la constante maskDateDuréeRelative).
    • pour les champs de saisie de type Date utilisant le masque d'affichage "Durée relative".
AndroidJava Le masque "Durée relative" n'est pas disponible.
Versions 19 et supérieures
AndroidJava Le masque "Durée relative" est désormais disponible.
Nouveauté 19
AndroidJava Le masque "Durée relative" est désormais disponible.
AndroidJava Le masque "Durée relative" est désormais disponible.
Les masques personnalisés
Les éléments suivants peuvent être utilisés pour définir un masque personnalisé (attention, il est nécessaire de respecter la casse) :
  • 'JJJJ' (jour correspondant de la semaine, par exemple "Jeudi". La casse utilisée dépend des options linguistiques du projet.)
  • Versions 16 et supérieures
    'Jjjj' (jour correspondant de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'Jjjj' (jour correspondant de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
    'Jjjj' (jour correspondant de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    'jjjj' (jour correspondant de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'jjjj' (jour correspondant de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
    'jjjj' (jour correspondant de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
  • 'JJJ' (abréviation du jour de la semaine, par exemple "Jeu")
  • Versions 16 et supérieures
    'Jjj' (abréviation du jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lun)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'Jjj' (abréviation du jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lun)
    Java Cette notation n'est pas disponible.
    'Jjj' (abréviation du jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lun)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    'jjj' (abréviation du jour de la semaine avec la première lettre forcée en minuscule, par exemple : lun)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'jjj' (abréviation du jour de la semaine avec la première lettre forcée en minuscule, par exemple : lun)
    Java Cette notation n'est pas disponible.
    'jjj' (abréviation du jour de la semaine avec la première lettre forcée en minuscule, par exemple : lun)
    Java Cette notation n'est pas disponible.
  • 'JJ' (date en chiffres, par exemple "25")
  • 'MMMM' (mois en toutes lettres, par exemple "Janvier". La casse utilisée dépend des options linguistiques du projet.)
  • Versions 16 et supérieures
    'Mmmm' (mois en toutes lettres avec la première lettre forcée en majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'Mmmm' (mois en toutes lettres avec la première lettre forcée en majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
    'Mmmm' (mois en toutes lettres avec la première lettre forcée en majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    'mmmm' (mois en toutes lettres avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'mmmm' (mois en toutes lettres avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
    'mmmm' (mois en toutes lettres avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
  • 'MMM' (abréviation du mois, par exemple "Jan")
  • Versions 16 et supérieures
    'Mmm' (abréviation du mois avec la première lettre forcée en majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'Mmm' (abréviation du mois avec la première lettre forcée en majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
    'Mmm' (abréviation du mois avec la première lettre forcée en majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    'mmm' (abréviation du mois avec la première lettre forcée en minuscule, par exemple : jan)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    'mmm' (abréviation du mois avec la première lettre forcée en minuscule, par exemple : jan)
    Java Cette notation n'est pas disponible.
    'mmm' (abréviation du mois avec la première lettre forcée en minuscule, par exemple : jan)
    Java Cette notation n'est pas disponible.
  • 'MM' (mois en chiffres, par exemple "06")
  • 'AAAA' (l'année sur quatre chiffres, par exemple "2001")
  • 'AA' (deux derniers chiffres de l'année, par exemple "01")
  • 'HH' (heure en chiffres, par exemple "13")
  • 'mm' (minutes en chiffres, par exemple "32")
  • 'SS' (secondes en chiffres, par exemple "46")
Il est possible de combiner ces masques. Par exemple : 'Le JJJ JJ MMMM AAAA à HH:mm' donnera un résultat de la forme "Le Jeu 01 Février 1979 à 21:35".
WEBDEV - Code Serveur Les masques de saisie personnalisés sont gérés uniquement en affichage : ils ne sont pas disponibles lors de la saisie dans le champ par l'internaute.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire