HolidayCalendars          package:fCalendar          R Documentation

_H_o_l_i_d_a_y _C_a_l_e_n_d_a_r_s _a_n_d _U_t_i_l_i_t_i_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     A collection and description of functions and  methods dealing
     with holiday dates and holiday calendars.  

     The functions for the generation of holiday calendars are: 

       'holiday'        Returns a holiday date of G7 and CH as 'sdate',
       'holidayNYSE'    Computes 'timeDate' object for full-day NYSE holidays,
       'holidayZURICH'  Computes 'timeDate' object for Zurich holidays.

_U_s_a_g_e:

     holiday(year, Holiday = Easter)
     holidayNYSE(year = currentYear)
     holidayZURICH(year = currentYear)

_A_r_g_u_m_e_n_t_s:

 Holiday: the unquoted function name of an ecclestial or public holiday
           in the G7 countries or Switzerland, see the list below. 

    year: an integer vector of years, [CCYY]. [day.of.week] - cr vector
          of integer year numbers. 

_D_e_t_a_i_l_s:

     *Holiday Calendar:* 

      Easter is the central ecclestial holiday. Many other holidays are
     related to this feast. The function 'easter' computes the dates of
     easter and related ecclestial holidays for the  requested year
     vector. 'holiday' calculates the dates of  ecclestial or publich
     holidays in the G7 countries, e.g.  'holiday(2003, "GoodFriday")'.
     'holidays.db' is our  Data Base of World Wide Holidays. The
     database contains holiday  functions automatically loaded by the
     'fBasics' library at  startup time. The user can add additional
     holiday functions to  this data base. The information for the
     holiday data base were  collected from several web pages about
     holiday calendars. The following ecclestial and public '[HOLIDAY]'
     functions  in the G7 countries and Switzerland are available:  

     _Holidays Related to Easter:_  
      Septuagesima, Quinquagesima, AshWednesday, PalmSunday,
     GoodFriday,  EasterSunday, Easter, EasterMonday,  RogationSunday,
     Ascension, Pentecost, PentecostMonday,  TrinitySunday
     CorpusChristi. 

     _Holidays Related to Christmas:_  
      ChristTheKing, Advent1st, Advent1st, Advent3rd,  Advent4th,
     ChristmasEve, ChristmasDay, BoxingDay,  NewYearsDay. 

     _Other Ecclestical Feasts:_  
      SolemnityOfMary, Epiphany, PresentationOfLord,  Annunciation,
     TransfigurationOfLord, AssumptionOfMary,  AssumptionOfMary,
     BirthOfVirginMary, CelebrationOfHolyCross,  MassOfArchangels,
     AllSaints, AllSouls. 

     _CHZurich - Public Holidays:_  
      CHBerchtoldsDay, CHSechselaeuten, CHAscension, 
     CHConfederationDay, CHKnabenschiessen. 

     _GBLondon - Public Holidays:_  
      GBMayDay, GBBankHoliday, GBSummerBankHoliday,  GBNewYearsEve.

     _DEFrankfurt - Public Holidays:_  
      DEAscension, DECorpusChristi, DEGermanUnity, DEChristmasEve,
     DENewYearsEve. 

     _FRParis - Public Holidays:_  
      FRFetDeLaVictoire1945, FRAscension, FRBastilleDay, 
     FRAssumptionVirginMary, FRAllSaints, FRArmisticeDay. 

     _ITMilano - Public Holidays:_  
      ITEpiphany, ITLiberationDay, ITRepublicAnniversary, 
     ITAssumptionOfVirginMary, ITAllSaints, ITWWIVictoryAnniversary, 
     ITStAmrose, ITImmaculateConception. 

     _USNewYork/USChicago - Public Holidays:_  
      USNewYearsDay, USInaugurationDay, USMLKingsBirthday, 
     USLincolnsBirthday, USWashingtonsBirthday, USMemorialDay, 
     USIndependenceDay, USLaborDay,  USColumbusDay, USElectionDay, 
     USVeteransDay, USThanksgivingDay, USChristmasDay, 
     USCPulaskisBirthday, USGoodFriday. 

     _CAToronto/CAMontreal - Public Holidays:_  
      CAVictoriaDay, CACanadaDay, CACivicProvincialHoliday, 
     CALabourDay, CAThanksgivingDay, CaRemembranceDay. 

     _JPTokyo/JPOsaka - Public Holidays:_  
      JPNewYearsDay, JPGantan, JPBankHolidayJan2, JPBankHolidayJan3,
     JPComingOfAgeDay, JPSeijinNoHi, JPNatFoundationDay,
     JPKenkokuKinenNoHi, JPGreeneryDay, JPMidoriNoHi, 
     JPConstitutionDay, JPKenpouKinenBi, JPNationHoliday, 
     JPKokuminNoKyujitu, JPChildrensDay, JPKodomoNoHi,  JPMarineDay,
     JPUmiNoHi, JPRespectForTheAgedDay, JPKeirouNoHi,
     JPAutumnalEquinox, JPShuubun-no-hi,  JPHealthandSportsDay,
     JPTaiikuNoHi, JPNationalCultureDay,  JPBunkaNoHi,
     JPThanksgivingDay, JPKinrouKanshaNohi,  JPKinrou-kansha-no-hi,
     JPEmperorsBirthday, JPTennou-tanjyou-bi, JPTennou-tanjyou-bi. 

     All the holiday functions are listed in the data file
     'holidays.R'. Additional holidays, which are not yet available
     there, can be added to this data base file.

_V_a_l_u_e:

     'holiday'
      'holidayNYSE' 'holidayZURICH' 
      return an ISO-8601 formatted calendar date 'CCYYMMDD', an object
     of class '"sdate"' which represents an integer value or vector.

_A_u_t_h_o_r(_s):

     Diethelm Wuertz for the Rmetrics R-port.

_R_e_f_e_r_e_n_c_e_s:

     ISO-8601 (1988);  _Data Elements and Interchange Formats -
     Information Interchange, Representation of Dates and Time_,
     International Organization for Standardization, Reference Number
     ISO 8601, 14 pages.

_E_x_a_m_p_l_e_s:

     ## SOURCE("fCalendar.5B-HolidayCalendars")

     ## easter -
        # Dates for GoodFriday from 2000 until 2010:                     
        holiday(2000:2010, "GoodFriday")                  
        
     ## holidays -   
        Easter(2000:2010)                                
        GoodFriday(2000:2010)
       
     ## holidayNYSE -
        holidayNYSE(currentYear)
        

