YEAR Function (VisioShapeSheet)

Returns an integer that represents the Gregorian year in datetime or expression, formatted according to the short date style set by the system's current Region and Language settings.

Syntax

YEAR(" datetime "| expression [, lcid ])

Parameters

Name Required/Optional Data Type Description
datetime Required String Any string commonly recognized as a date and time or a reference to a cell containing a date and time.
expression Required Varies Any expression that yields a date and time.
lcid Optional Numeric The locale identifier to be used in evaluating a nonlocal datetime. The locale identifier is a number described in the system header files.

Return value

Integer

Remarks

The time component in datetime or expression is discarded.

No rounding is done. If datetime is missing or cannot be interpreted as a valid date or time, YEAR returns an error.

The YEAR function also accepts a single number value for expression where the integer portion of the result represents the number of days since December 30, 1899.

Example 1

YEAR("10/27/2007 13:45:24")

Returns 2007.

Example 2

YEAR(DATEVALUE("Dec. 25, 2006") + 7 ed.)

Returns 2007.

Example 3

YEAR(35580.6337)

Returns 1997.