/* $DOC$
   $NAME$
      ft_Month()
   $CATEGORY$
      Date/Time
   $ONELINER$
      Return Calendar or Fiscal Month Data
   $SYNTAX$
      ft_Month( [ <dGivenDate> ], [nMonthNum] ) -> aDateInfo
   $ARGUMENTS$
      <dGivenDate> is any valid date in any date format.  Defaults
      to current system date if not supplied.

      <nMonthNum> is a number from 1 to 12 signifying a month.
      Defaults to current month if not supplied.
   $RETURNS$
      A three element array containing the following data:

         aDateInfo[ 1 ] - The year and month as a character string "YYYYMM"
         aDateInfo[ 2 ] - The beginning date of the month
         aDateInfo[ 3 ] - The ending date of the month
   $DESCRIPTION$
      ft_Month() returns an array containing data about the month
      containing the given date.

      Normally the return data will be based on a year beginning
      on January 1st with weeks beginning on Sunday.

      The beginning of year date and/or beginning of week day can be
      changed by using ft_DateCnfg(), which will affect all subsequent
      calls to ft_Month() until another call to ft_DateCnfg().

      The beginning of year date and beginning of week day may be reset
      to January 1 and Sunday by calling ft_DateCnfg() with no
      parameters.
   $EXAMPLES$
      // get info about month containing 1990-09-15
      aDateInfo := ft_Month( hb_SToD( "19900915" ) )
      ? aDateInfo[ 1 ]   //  199009       (9th month)
      ? aDateInfo[ 2 ]   //  1990-09-01   beginning of month 9
      ? aDateInfo[ 3 ]   //  1990-09-30   end of week month 9

      // get info about month 5 in year containing 1990-09-15
      aDateInfo := ft_Month( hb_SToD( "19900915" ), 5 )
      ? aDateInfo[ 1 ]   //  199005
      ? aDateInfo[ 2 ]   //  1990-05-01   beginning of month 5
      ? aDateInfo[ 3 ]   //  1990-05-31   end of month 5

      // get info about month 5 in current year (1991)
      aDateInfo := ft_Month( , 5 )
      ? aDateInfo[ 1 ]   //  199105
      ? aDateInfo[ 2 ]   //  1991-05-01   beginning of month 5
      ? aDateInfo[ 3 ]   //  1991-05-31   end of month 5
   $SEEALSO$
      ft_DateCnfg(), ft_Week(), ft_Qtr(), ft_Year()
   $END$
 */
