ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Your version: XXA250083N

The content of this page has been updated to version 26.  See documentation 26 now.
Help / WLanguage / WLanguage functions / Standard functions / Functions for managing dates and times
  • Coherence between the date and the format
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
Transforms a date in character string format into a date in YYYYMMDD format.
Remark: The transformation performed by StringToDate consists in identifying, in the initial character string, the different components of the date to build the result string.
Example
Res = StringToDate("25/12/2001")  // Res = "20011225"
Res = StringToDate("25-12-2001")  // Res = "20011225"
StringToDate("")                  // Returns ""
Res = StringToDate("12-25-2001", "MM-DD-YYYY")  // Res = "20011225"
Res = StringToDate("12-25-01", "MM-DD-YY")      // Res = "20011225"
Res = StringToDate("12-25-2001", "MM-DD-YY")    // Res = ""
Res = StringToDate("12-25-01", "MM-DD-YY")      // Res = "20011225"
Res = StringToDate("Sun, 25 Nov 2012 12:11:55 +0100", maskDateEmail) // Res = "20121125121155"
Res = StringToDate("Sat, 25 Aug 2012 12:11:55 +0200", maskDateEmail) // Res = "20120825121155"
New in version 25
Res = StringToDate("Sun, 24 Nov 2019 23:00:00 +0000", maskDateEmailUTC) // Res = "20191124230000000"
Res = StringToDate("2019-08-25T00:00:00.000+02:00", maskDateInternet) // Res = "20190825000000000"
Res = StringToDate("2019-08-24T22:00:00.000Z", maskDateInternetUTC) // Res = "20190824220000000"
Syntax
<Result> = StringToDate(<Date> [, <Format>])
<Result>: Character string or Date variable
  • Date in YYYYMMDD format (YYYY corresponds to the year, MM to the month and DD to the day).
  • Empty string ("") if a problem occurred.
<Date>: Character string
Date in the format specified in <Format>.
<Format>: Optional character string or optional constant
Format of the date to convert:
  • in string format:
    In this string, the characters:
    • YYYY represent the year on 4 digits.
    • YY represent the year on 2 digits. The years will be included between 1951 and 2050.
    • M represents the month (no zero is displayed in front of the month number).
    • MM represent the month (the month must be on 2 digits).
    • MMM represent the month spelled out on 3 characters (for example: jan). The case used depends on the linguistic options of project.
      WEBDEV - Browser code This notation is not case sensitive.
    • Mmm represent the month in letters on 3 characters with the first letter forced in uppercase (for example: Jan.
      AndroidAndroid Widget JavaPHP This notation is not available.

      WEBDEV - Browser code This notation is not case sensitive.
    • mmm represent the month in letters on 3 characters with the first letter in lowercase (for example: jan)
      AndroidAndroid Widget JavaPHP This notation is not available.

      WEBDEV - Browser code This notation is not case sensitive.
    • MMMM represent the month entirely spelled out (for example: january). The case used depends on the linguistic options of project.
      AndroidAndroid Widget JavaPHP This notation is not available.
      WEBDEV - Browser code This notation is not case sensitive.
    • Mmmm represent the month in plain letters with the first letter in uppercase (for example: January)
      AndroidAndroid Widget JavaPHP This notation is not available.
      WEBDEV - Browser code This notation is not case sensitive.
    • mmmm represent the month in plain letters with the first letter in lowercase (for example: january)
      AndroidAndroid Widget JavaPHP This notation is not available.
      WEBDEV - Browser code This notation is not case sensitive.
    • D represents the day (no zero is displayed in front of the day number),
    • DD represent the day on 2 digits,
    • DDD represent the day spelled out on 3 characters (for example: mon). The case used depends on the linguistic options of project.
    • Ddd represent the day in letters on 3 characters with the first letter in uppercase (for example: Mon)
      AndroidAndroid Widget JavaPHP This notation is not available.
    • ddd represent the day in letters on 3 characters with the first letter in lowercase (for example: mon)
      AndroidAndroid Widget JavaPHP This notation is not available.
    • DDDD represent the day entirely spelled out (for example: monday). The case used depends on the linguistic options of project.
    • Dddd represent the day entirely spelled out with the first letter in uppercase (for example: Monday)
      AndroidAndroid Widget JavaPHP This notation is not available.
    • dddd represent the day entirely spelled out with the first letter in lowercase (for example: monday)
      AndroidAndroid Widget JavaPHP This notation is not available.
    • M represents the first letter of the day (for example: M,T,W,T,F,S,S)
      AndroidAndroid Widget JavaPHP This notation is not available.
  • via the following constants:
    maskDateEmailThe format used corresponds to the date format of the RFC-5322 standard used to encrypt an email, a RSS stream, ...
    The result is expressed in the local time zone.
    WEBDEV - Browser codeAndroidJavaPHP Not available.
    New in version 25
    maskDateEmailUTC
    The format used corresponds to the date format of the RFC-5322 standard used to encrypt an email, a RSS stream, ...
    The result is expressed in universal time (UTC).
    WEBDEV - Browser codeAndroidJavaPHP Not available.
    New in version 25
    maskDateInternet
    The format used corresponds to the RFC-3339 standard used for international communications.
    The result is expressed in the local time zone.
    New in version 25
    maskDateInternetUTC
    The format used corresponds to the RFC-3339 standard used for international communications.
    The result is expressed in universal time (UTC).
    WEBDEV - Browser code Not available.
    maskDateSystemThe format used corresponds to the format defined in the project description for the current language:
    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).
If this parameter is not specified, the format used by default is DD/MM/YYYY (DD + a specific character + MM + a specific character + YYYY).
Remarks

Coherence between the date and the format

You must check whether the <Date> and the specified <Format> are coherent. Therefore:
  • If <Date> = "The inauguration date of this monument was 10/02 of year 1995", the following format must be used:
    <Format> = "The inauguration date of this monument was DD/MM of year YYYY".
  • If <Date> = "The 03/11/1970", the following format must be used:
    <Format> = "The DD/MM/YYYY".
Related Examples:
The EXIF functions Unit examples (WINDEV): The EXIF functions
[ + ] Using the ImageXXX functions.
These functions are used to access the EXIF information of an image.
The EXIF information is included in the JPEG or TIFF images.
It can be for example the snapshot date, the orientation of the device when taking the photo, the make and model of the camera, a miniature of the image...
Business / UI classification : Neutral code
Component : wd250std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 08/26/2020

Send a report | Local help