Year function (LotusScript® Language)

Returns the year, as a 4-digit integer, for a date/time argument.


Year ( dateExpr )



Any of the following kinds of expressions:

  • A valid date/time string of String or Variant data type.

    For Notes® or Domino®, LotusScript® interprets a 2-digit designation of a year in a date/time string so that 50 through 99 represent the years 1950 through 1999 and 00 through 49 represent the years 2000 through 2049.

    For SmartSuite®, LotusScript® interprets the years differently. For more information, see the Year 2000 item on the Help menu of each SmartSuite® product.

  • A numeric expression whose value is a Variant of DataType 7 (Date/Time).
  • A number within the valid date range: -657434, representing Jan 1, 100 AD, to 2958465, representing Dec 31, 9999 AD.
  • NULL.

Return value

Year returns an integer between 100 and 9999.

The data type of the return value is a Variant of DataType 2 (Integer).

Year(NULL) returns NULL.