PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Reminder
  • Default mask
  • The preset masks
  • Additional mask
  • The custom masks
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview

Reminder

WINDEV, WINDEV Mobile and WEBDEV propose two types of masks:
  • the input masks that define the characters that can be typed in the controls found in a window or in a page. Sometimes, these masks can also be used to modify the case (uppercase/lowercase characters) of the values assigned to the window controls or to the page controls by programming.
  • the display masks that define the characters that can be:
    • Versions 17 and later
      WINDEVWINDEV Mobile displayed in the window controls.
      New in version 17
      WINDEVWINDEV Mobile displayed in the window controls.
      WINDEVWINDEV Mobile displayed in the window controls.
    • printed in the report controls.
Default mask
By default, when creating a Date control:
  • the "Date defined by the project" input mask is selected: the information defined in the parameters for managing the dates for the project is automatically taken into account.Reminder: These parameters are defined for each language in the "Languages" tab of the project description ("Project .. Project description"). Reminder: These parameters are defined for each language in the "Languages" tab of project description:
    1. On the "Project" pane, in the "Project" group, click "Description".
    2. Select the "Languages" tab then the "Date" tab.
    3. The format used corresponds to:
      • the parameters of the operating system,
      • the specified parameters (with the defined days and months).
  • Versions 17 and later
    WINDEVWINDEV Mobile the "Same mask as the input" display mask is selected.
    New in version 17
    WINDEVWINDEV Mobile the "Same mask as the input" display mask is selected.
    WINDEVWINDEV Mobile the "Same mask as the input" display mask is selected.
Notes:
  • In a report, when creating a preset Date control, the wizard allows you to select the display format of the control.
  • A list of preset masks is proposed in the description window of the control. You have the ability to:
    • select a preset mask.
    • create a custom mask.
The preset masks
The following masks are proposed (in the order in which they appear in the window editor, page editor or report editor):
  • the date defined by the project. The date defined by the project depends on the date format selected in the parameters of the project language ("Project .. Project description", "Language" tab, linguistic options about the date).
  • 'DD/MM/YYYY' ("01/02/1979" for example)
  • 'DD/MM/YY' ("01/02/79" for example)
  • Versions 16 and later
    'DDD DD' ("Tue 15" for example)
    New in version 16
    'DDD DD' ("Tue 15" for example)
    'DDD DD' ("Tue 15" for example)
  • 'MM/DD/YYYY' ("02/01/1979" for example)
  • 'MM/DD/YY' ("02/01/79" for example)
  • 'YYYY/MM/DD' ("1979/02/01" for example)
  • 'YY/MM/DD' ("79/02/01" for example)
  • 'DD/MM/YYYY HH:mm:SS' ("01/02/1979 21:35:15" for example)
  • 'MM/DD/YYYY HH:mm:SS' ("02/01/1979 21:35:15" for example)
  • 'DD/MM/YYYY HH:mm:SS:CC' ("01/02/1979 21:35:15:10" for example)
  • 'MM/DD/AAAA HH:mm:SS:CC' ("02/01/1979 21:35:15:10" for example)
  • 'DDDD DD MMMM YYYY' ("Thursday 01 february 1979" for example)
  • Versions 16 and later
    'Dddd DD Mmmm YYYY' ("Tuesday 13 June 2000" for example)
    New in version 16
    'Dddd DD Mmmm YYYY' ("Tuesday 13 June 2000" for example)
    'Dddd DD Mmmm YYYY' ("Tuesday 13 June 2000" for example)
  • Versions 16 and later
    'Dddd DD Mmm YYYY' ("Saturday 01 Dec 2001" for example)
    New in version 16
    'Dddd DD Mmm YYYY' ("Saturday 01 Dec 2001" for example)
    'Dddd DD Mmm YYYY' ("Saturday 01 Dec 2001" for example)
Additional masks are available in WINDEV and WEBDEV:
  • Versions 17 and later
    WEBDEV - Server codeWEBDEV - Browser code Date (HTML5)
    New in version 17
    WEBDEV - Server codeWEBDEV - Browser code Date (HTML5)
    WEBDEV - Server codeWEBDEV - Browser code Date (HTML5)
  • Versions 17 and later
    WEBDEV - Server codeWEBDEV - Browser code Date and Time (HTML5)
    New in version 17
    WEBDEV - Server codeWEBDEV - Browser code Date and Time (HTML5)
    WEBDEV - Server codeWEBDEV - Browser code Date and Time (HTML5)
  • Versions 18 and later
    WINDEVWINDEV Mobile Relative duration (yesterday, in 3 days, ...).
    Android This mask is not available.
    New in version 18
    WINDEVWINDEV Mobile Relative duration (yesterday, in 3 days, ...).
    Android This mask is not available.
    WINDEVWINDEV Mobile Relative duration (yesterday, in 3 days, ...).
    Android This mask is not available.
Versions 17 and later
WEBDEV - Server codeWEBDEV - Browser code Additional masks
In WEBDEV, you also have the ability to select HTML 5 input masks. These input masks allow you to use the HTML 5 checks to validate the input.
Caution: These masks are not supported by all browsers and they may behave differently depending on the browser used.
The following HTML 5 input masks are available:
Selected maskPurposeEffects during the input in the control
Date (HTML5)Enter a date in YYYY-MM-DD format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a message asking you to a enter correct value is displayed.
  • Edge 38: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with an arrow used to expand a calendar.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
Date and Time (HTML5)Entering a date and time in YYYY-MM-DDTHH:MM format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Not supported.
  • Edge 38: Not supported.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date and time.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with arrow used to expand a calendar for the date part and a spin used to modify the time part.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
New in version 17
WEBDEV - Server codeWEBDEV - Browser code Additional masks
In WEBDEV, you also have the ability to select HTML 5 input masks. These input masks allow you to use the HTML 5 checks to validate the input.
Caution: These masks are not supported by all browsers and they may behave differently depending on the browser used.
The following HTML 5 input masks are available:
Selected maskPurposeEffects during the input in the control
Date (HTML5)Enter a date in YYYY-MM-DD format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a message asking you to a enter correct value is displayed.
  • Edge 38: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with an arrow used to expand a calendar.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
Date and Time (HTML5)Entering a date and time in YYYY-MM-DDTHH:MM format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Not supported.
  • Edge 38: Not supported.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date and time.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with arrow used to expand a calendar for the date part and a spin used to modify the time part.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
WEBDEV - Server codeWEBDEV - Browser code Additional masks
In WEBDEV, you also have the ability to select HTML 5 input masks. These input masks allow you to use the HTML 5 checks to validate the input.
Caution: These masks are not supported by all browsers and they may behave differently depending on the browser used.
The following HTML 5 input masks are available:
Selected maskPurposeEffects during the input in the control
Date (HTML5)Enter a date in YYYY-MM-DD format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a message asking you to a enter correct value is displayed.
  • Edge 38: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with an arrow used to expand a calendar.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
Date and Time (HTML5)Entering a date and time in YYYY-MM-DDTHH:MM format
  • Internet Explorer 9: Not supported.
  • Internet Explorer 11: Not supported.
  • Edge 38: Not supported.
  • FireFox 5: Not supported.
  • Chrome 12: Control with a spin used to automatically modify the date and time.
    When validating the form, if the entered value is incorrect, a tooltip asking you to enter a correct value is displayed. The focus is set on the control.
  • Opera 11.11: Combo box with arrow used to expand a calendar for the date part and a spin used to modify the time part.
  • Safari 5: When validating the form, if the entered value is incorrect, the focus is set on the control.
Versions 18 and later
WINDEVWINDEV Mobile

Additional mask

In WINDEV and WINDEV Mobile, you have the ability to select an additional display mask: "Relative duration (yesterday, in 3 days, ...)".
This mask is used to express the duration passed (or the future duration) between the date of the day and the date entered in the control. This format is expressed in natural en language.
The different formulations used can be configured in the project description for the current language:
  1. On the "Project" pane, in the "Project" group, click "Description".
  2. In the "Languages" tab:
    • select the language to configure.
    • select the "Date" tab.
  3. Click the "Dates and Times in natural language" button.
  4. Define (if necessary) the custom captions to use. These captions will be used:
    • for the result of DateToString (associated with the maskDateRelativeDuration constant).
    • for the Date edit controls that use the "Relative duration" display mask.
AndroidJava The "Relative duration" mask is not available.
Versions 19 and later
AndroidJava The "Relative duration" mask is now available.
New in version 19
AndroidJava The "Relative duration" mask is now available.
AndroidJava The "Relative duration" mask is now available.
New in version 18
WINDEVWINDEV Mobile

Additional mask

In WINDEV and WINDEV Mobile, you have the ability to select an additional display mask: "Relative duration (yesterday, in 3 days, ...)".
This mask is used to express the duration passed (or the future duration) between the date of the day and the date entered in the control. This format is expressed in natural en language.
The different formulations used can be configured in the project description for the current language:
  1. On the "Project" pane, in the "Project" group, click "Description".
  2. In the "Languages" tab:
    • select the language to configure.
    • select the "Date" tab.
  3. Click the "Dates and Times in natural language" button.
  4. Define (if necessary) the custom captions to use. These captions will be used:
    • for the result of DateToString (associated with the maskDateRelativeDuration constant).
    • for the Date edit controls that use the "Relative duration" display mask.
AndroidJava The "Relative duration" mask is not available.
Versions 19 and later
AndroidJava The "Relative duration" mask is now available.
New in version 19
AndroidJava The "Relative duration" mask is now available.
AndroidJava The "Relative duration" mask is now available.
WINDEVWINDEV Mobile

Additional mask

In WINDEV and WINDEV Mobile, you have the ability to select an additional display mask: "Relative duration (yesterday, in 3 days, ...)".
This mask is used to express the duration passed (or the future duration) between the date of the day and the date entered in the control. This format is expressed in natural en language.
The different formulations used can be configured in the project description for the current language:
  1. On the "Project" pane, in the "Project" group, click "Description".
  2. In the "Languages" tab:
    • select the language to configure.
    • select the "Date" tab.
  3. Click the "Dates and Times in natural language" button.
  4. Define (if necessary) the custom captions to use. These captions will be used:
    • for the result of DateToString (associated with the maskDateRelativeDuration constant).
    • for the Date edit controls that use the "Relative duration" display mask.
AndroidJava The "Relative duration" mask is not available.
Versions 19 and later
AndroidJava The "Relative duration" mask is now available.
New in version 19
AndroidJava The "Relative duration" mask is now available.
AndroidJava The "Relative duration" mask is now available.
The custom masks
The following elements can be used to define a custom mask (case sensitive):
  • 'DDDD' (corresponding day of the week, "Thursday" for example. The case used depends on the linguistic options of project.)
  • Versions 16 and later
    'Dddd' (corresponding day of the week with the first letter in uppercase, for example: Monday)
    Java This notation is not available.
    New in version 16
    'Dddd' (corresponding day of the week with the first letter in uppercase, for example: Monday)
    Java This notation is not available.
    'Dddd' (corresponding day of the week with the first letter in uppercase, for example: Monday)
    Java This notation is not available.
  • Versions 16 and later
    'dddd' (corresponding day of the week with the first letter in lowercase, for example: monday)
    Java This notation is not available.
    New in version 16
    'dddd' (corresponding day of the week with the first letter in lowercase, for example: monday)
    Java This notation is not available.
    'dddd' (corresponding day of the week with the first letter in lowercase, for example: monday)
    Java This notation is not available.
  • 'DDD' (abbreviation of the day of the week, "Thu" for example)
  • Versions 16 and later
    'Ddd' (abbreviation of the day of the week with the first letter in uppercase, for example: Mon)
    Java This notation is not available.
    New in version 16
    'Ddd' (abbreviation of the day of the week with the first letter in uppercase, for example: Mon)
    Java This notation is not available.
    'Ddd' (abbreviation of the day of the week with the first letter in uppercase, for example: Mon)
    Java This notation is not available.
  • Versions 16 and later
    'ddd' (abbreviation of the day of the week with the first letter in lowercase, for example: mon)
    Java This notation is not available.
    New in version 16
    'ddd' (abbreviation of the day of the week with the first letter in lowercase, for example: mon)
    Java This notation is not available.
    'ddd' (abbreviation of the day of the week with the first letter in lowercase, for example: mon)
    Java This notation is not available.
  • 'DD' (date in digits, "25" for example)
  • 'MMMM' (month spelled out, "January" for example. The case used depends on the linguistic options of project.)
  • Versions 16 and later
    'Mmmm' (month spelled out with the first letter in uppercase, for example: January)
    Java This notation is not available.
    New in version 16
    'Mmmm' (month spelled out with the first letter in uppercase, for example: January)
    Java This notation is not available.
    'Mmmm' (month spelled out with the first letter in uppercase, for example: January)
    Java This notation is not available.
  • Versions 16 and later
    'mmmm' (month spelled out with the first letter in lowercase, for example: january)
    Java This notation is not available.
    New in version 16
    'mmmm' (month spelled out with the first letter in lowercase, for example: january)
    Java This notation is not available.
    'mmmm' (month spelled out with the first letter in lowercase, for example: january)
    Java This notation is not available.
  • 'MMM' (abbreviation of the month, "Jan" for example)
  • Versions 16 and later
    'Mmm' (abbreviation of the month with the first letter in uppercase, for example: Jan)
    Java This notation is not available.
    New in version 16
    'Mmm' (abbreviation of the month with the first letter in uppercase, for example: Jan)
    Java This notation is not available.
    'Mmm' (abbreviation of the month with the first letter in uppercase, for example: Jan)
    Java This notation is not available.
  • Versions 16 and later
    'mmm' (abbreviation of the month with the first letter in lowercase, for example: jan)
    Java This notation is not available.
    New in version 16
    'mmm' (abbreviation of the month with the first letter in lowercase, for example: jan)
    Java This notation is not available.
    'mmm' (abbreviation of the month with the first letter in lowercase, for example: jan)
    Java This notation is not available.
  • 'MM' (month in digits, "06" for example)
  • 'YYYY' (year on four digits, "2001" for example)
  • 'YY' (last two digits of the year, "01" for example)
  • 'HH' (hour in digits, "13" for example)
  • 'mm' (minutes in digits, "32" for example)
  • 'SS' (seconds in digits, "46" for example)
These masks can be combined. For example: 'DDD DD MMMM YYYY at HH:mm' will return a result in the following format: "Fri 02 February 1979 at 21:35".
WEBDEV - Server code The custom input masks are managed in read-only: they are not available when the Web user performs an input in the control.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment