PHP Holidays Library for Germany, Austria and Switzerland: Get the holiday dates of specific countries

Recommend this page to a friend!
  Info   Example   View files (7)   Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2020-03-20 (4 months ago) Not yet rated by the usersTotal: 10 All time: 10,014 This week: 254
Version License PHP version Categories
stateinfo 1.0.0Freely Distributable5XML, PHP 5, Time and Date, Geography
Description Author

This class can be used to get the holiday dates of specific countries.

It can parse a XML file and extract the list of holiday dates for specific countries and their states like Germany, Austria and Switzerland.

The class can also return the dates of holidays that depend on the year like for instance the date of Easter.

Picture of Stefan Kientzler
  Performance   Level  
Name: Stefan Kientzler is available for providing paid consulting. Contact Stefan Kientzler .
Classes: 11 packages by
Country: Germany Germany
Age: 52
All time rank: 2162137 in Germany Germany
Week rank: 6 1 in Germany Germany
Innovation award
Innovation award
Nominee: 6x

Winner: 3x

This class provides some information for federal states of
 - germany
 - austria
 - switzerland ('federal states' -> 'cantons')
and the public holidays applicable to the individual federal states. For
moving public holidays (not on a fixed date, e.g. Easter), a calculation 
of the date for any calendar year is included.
Since there are sometimes several number ranges per state, the main issue 
of this class is the relationship between the postcode and the state to 
which the respective place belongs.
This information is often required to determine state-specific regulations 
(e.g. public holidays, school holidays, laws ...)
The class provides a list of all federal states and the corresponding 
Conversely, a corresponding SQL WHERE condition can be created in order 
to find all addresses in a database in a particular state. (usually the 
address data do not contain the correct state information)
Since this information normally do not change, an XML file was chosen for 
data storage, which allows easily access with XPath.

1.Notes to the reverse search of federal state from postcode
Since the backward search is based on areas from-to, it does not  necessarily
mean that the postcode that is being searched for actually exists - the 
validation of a postcode should be carried out via a database or an 
appropriate (web) service.

Due to the fact that some postcodes in Austria and Switzerland include a 
cross-federal state area, it is possible that in this case a comma-separated 
list of the affected federal states (or abbreviations) will be returned as a 

2. Notes about public holidays
2.a  Germany
     In Germany there are a few public holidays that are only partially 
	 valid within a federal state - here you should then query directly 
	 via the postcode.
2.b  Austria / Switzerland
	In the case, that a given postcode belongs to multiple states
	it does not make sense to query the valid public holidays using the 
	postcode, since no clear state can be assigned.

File Role Description
lib (2 directories)
readme.txt Doc. readme
StatesInfoTestAT.php Example Testscript for Austria
StatesInfoTestCH.php Example Testscript for Switzerland
StatesInfoTestDE.php Example Testscript for Germany

  Files  /  lib  
File Role Description
Helper (1 file)
StatesInfo (2 files)

  Files  /  lib  /  Helper  
File Role Description
   ExtDOMDocument.php Aux. Helper class for easier XML access

  Files  /  lib  /  StatesInfo  
File Role Description
   StatesInfo.php Class class to get infos for federal states
   StatesInfoData.xml Data XML-Data file

 Version Control Unique User Downloads Download Rankings  
This week:0
All time:10,014
This week:254

For more information send a message to info at phpclasses dot org.