Year (Property)

ONLINE HELP
FOR 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

..Year 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.

Note: ..Year is used to simplify the operations performed on the dates: adding a year, etc.

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

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

Versions 16 and later

This property is now available for the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the 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 use.
Only the browser 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 use.
Only the browser 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 ..Year:

++ 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 storage format allows you to store dates from 01/01/0001 to 12/31/9999.

The calculations performed on dates by the WLanguage functions or by the WLanguage properties are accurate from January 1st 1583.