ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Time and date management properties
  • Operators available for the years
  • Leap years
  • Calculations on dates
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The Year property is used to:
Remark: The Year property is used to easily change dates: add a year, etc.
Reminder: Date items and variables are used to manage:
  • simple dates: "Year - Month - Day" (YYYYMMDD format).
  • dates and times: "Year - Month - Day - Hours - Minutes - Seconds - Milliseconds" (YYYYMMDDHHmmSSCCC format).
  • durations: "Number of days - Number of hours - Number of minutes - Number of seconds - Number of milliseconds" (+DHHMMSSCCC format).
Example
StartDate is Date = DateSys()
// Add 1 year to the date
StartDate.Year++
// Modify the years
StartDate.Year = 2003
Syntax

Getting the year of a Date or DateTime variable or item Hide the details

<Result> = <Date>.Year
<Result>: Integer
4-digit year.
<Date>: Date or DateTime
Name of the Date or DateTime variable or item to be used.
WEBDEV - Browser codePHP Only Date or DateTime variables declared in browser code can be used.

Changing the year of a Date or DateTime variable or item Hide the details

<Date>.Year = <New year>
<Date>: Date or DateTime
Name of the Date or DateTime variable or item to be used
WEBDEV - Browser codePHP Only Date or DateTime variables declared in browser code can be used.
<New year>: Integer or character string
New year in digits (between 1 and 9999). Replaces the year of the specified date.
Remarks

Operators available for the years

The following arithmetic operators can be used with the Year property:
  • ++ and --
  • += and -=
StartDate is Date = "20231212"
StartDate.Year++  // Add 1 year to the date
StartDate.Year+=5 // Add 5 years to the date
StartDate.Year-=5 // Subtract 5 years to the date

Leap years

If the date handled corresponds to February 29 of a leap year, adding or subtracting a year also changes the day. For example:
StartDate is Date = "20230229"
// Add 1 year to the date
StartDate.Year++ 
// StartDate is "20240228"

Calculations on dates

The date storage format allows you to store dates from 01/01/0001 to 12/31/9999.
WLanguage functions and WLanguage properties make accurate calculations on dates from January 1st, 1583.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/06/2024

Send a report | Local help