Year (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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 Property Year makes it possible 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 Property Year allows to simplify the operations of shifting dates: adding a year, etc.

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

the simple dates "Year - Month - Day" (YYYYMMDD format).
dates and times "Year - Month - Day - Hours - Minutes - Seconds - Thousandths of a second" (format YYYYYMMDDHHmmSSCCC).
the durations "Number of days - Number of hours - Number of minutes - Number of seconds - Number of thousandths of a second" (format +JHHMMSSCCC).

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++ Date
// 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 the Property Year:

++ and --
+= and -=

StartDate is Date = "20011212"
HEX@ Start.Year++ // Add 1 year to HEX@
HEX@ Start.Year+=5 // Add 5 years to HEX@
HEX@ Beginning.Year-=5 // Take 5 years from HEX@

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++ Date
// StartDate is "19970228"

Calculations on dates

The date 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 the WLanguage properties are accurate from January 1st 1583.