$FUNCNAME$
  YEAR()
$CATEGORY$
  DATE/TIME
$SUMMARY$
   Convert a date value to the year as a numeric value
$LANG_RU$
           .
$SYNTAX$
     YEAR(<dDate>) --> nYear
$LANG_RU$
     YEAR (<>) --> 
$ARGUMENTS$
     <dDate> is the date value to be converted.
$LANG_RU$
     <> -  .
$RETURNS$
     YEAR() returns the year of the specified date value including the
     century digits as a four-digit numeric value.  The value returned is not
     affected by the current DATE or CENTURY format.  Specifying a null date
     (CTOD("")) returns zero.
$LANG_RU$
     YEAR()   ,     
       .    
        DATE  CENTURY.   
     (CTOD(""))  .
$DESCRIPTION$
     YEAR() is a date conversion function that converts a date value to a
     numeric year value.  Use it in calculations for things like periodic
     reports or for formatting date displays.

     YEAR() is a member of a group of functions that return components of a
     date value as numeric values.  The group includes DAY() and MONTH()
     which return the day and month values as numeric values.
$LANG_RU$
     YEAR() -   ,   
           .  
            .
     YEAR()    ,    
       .       DAY()  MONTH(),
              .
$EXAMPLES$
       These examples illustrate YEAR() using the system date:

	? DATE()                    // Result: 09/20/90
	? YEAR(DATE())              // Result: 1990
	? YEAR(DATE()) + 11         // Result: 2001

       This example creates a user-defined function using YEAR() to
	format a date value in the following form: month day, year.

	? Mdy(DATE())               // Result: September 20, 1990

	FUNCTION Mdy( dDate )
	   RETURN CMONTH(dDate) + " " + ;
		 LTRIM(STR(DAY(dDate)));
	      + "," + STR(YEAR(dDate))
$LANG_RU$
           YEAR().

       ? DATE() // : 09/01/90
       ? YEAR (DATE() ) // : 1990
       ? YEAR (DATE () ) + 11 // : 2001

          ,  
       YEAR()       , , :

       ? Mdy(DATE () ) // ; September 20,1990

       FUNCTION Mdy ( dDate )
	  RETURN Mdy ( dDate ) + " " + LTRIM(STR(DAY(dDate)));
				      + "," + STR(YEAR(dDate))
$SEEALSO$
  DAY(),MONTH()
$END$
