Year (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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:

Retrieve the year from a Date or DateTime variable or item.
Modify the year in a Date or DateTime variable or item.

Remark: The Year property is used to easily change dates (add one day, etc.).: add a year, etc.

Reminder: The Date items and variables are used to manage:

"Year - Month - Day" dates (YYYYMMDD format).
"Year - Month - Day - Hours - Minutes - Seconds - Milliseconds" dates and times (YYYYMMDDHHmmSSCCC format).
"Number of days - Number of hours - Number of minutes - Number of seconds - Number of milliseconds" durations (+DHHMMSSCCC format).

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 20 and later

This property is now available in browser code for the Date or DateTime variables.

New in version 20

This property is now available in browser code for the Date or DateTime variables.

Versions 21 and later

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

Example

StartDate is Date = DateSys()
// Add 1 year to the date
StartDate.Year++
// Modify the years
StartDate.Year = 2003

Syntax

Finding out the year of a Date or DateTime variable or item Hide the details

<Result> = <Date>.Year

<Result>: Integer

Year on 4 digits.

<Date>: Date or DateTime

Name of the Date or DateTime variable or item to be used.
Only the browser Date or DateTime variables can be used.
Only the Date or DateTime variables can be used.

Modifying 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 the browser Date or DateTime variables can be used.
Only the Date or DateTime variables can be used.

<New Year>: Integer or character string

New year in digits (between 1 and 9999). Replaces the year in 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 = "20011212"
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 handles corresponds to February 29 of a leap year, adding or subtracting a year to the date also changes the day. For example:

StartDate is Date = "19960229"
// Add 1 year to the date
StartDate.Year++
// StartDate is "19970228"

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.