Year (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Time and date management properties

Operators available for the years
Leap years
Calculations on dates

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Year (Property)

In french: Année

Available only with these kinds of connection

The Year property is used to:

Get the year from a variable or item of type Date or DateTime.
Change the year in a variable of type Date or DateTime.

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.
Only Date or DateTime variables declared in browser code can be used.
Only Date or DateTime variables can be used.

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

<Date>: Date or DateTime

Name of the Date or DateTime variable or item to be used
Only Date or DateTime variables declared in browser code can be used.
Only Date or DateTime variables 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.