Flagdage

Jeg har ikke en flagstang; men ville gerne hejse flaget på min webside. Derfor skrev jeg en PHP-sag, der viser Dannebrog og hvad vi flager for.

Brug dannebrog på din egen webside

Du kan automatisk flage med Dannebrog på din egen webside. Indsæt denne iframe i din websides html:

 <iframe src="https://multimusen.dk/flag/flag.php" style="height=200px;"></iframe>

Du behøver ikke at gøre andet end det. Siden viser kun et flag på en flagdag. Hvis den er blank er det altså forklaringen.

De følgende afsnit forklarer, hvordan PHP-koden virker. Hvis det lyder lidt for nørdet, så drop resten af denne artikel.

Klassen flagdag

Men hvordan fungerer denne PHP-kode så? Først har jeg defineret en klasse, der indeholder de vigtigste funktioner (der er kun to funktioner):

class flagDag
{
	// printer hvis dagen er en flagdag
	public function dag($dato, $maaned, $hvad) {
		$flagstang = "dannebrog.gif"; // stien til billedet af Dannebrog
		// undersøger om det er en flagdag
		if (date('m') == $maaned && date('d') == $dato) {
			echo "<img src='" . $flagstang . "' alt='Dannebrog' width='50' height='38' >"; // kan skaleres efter behov
			echo "<p style='font-size:smaller'>I dag flages for: " . $hvad . "</p>";
		}
	}

	// sådan: plusTid('+3 weeks +5 days');
	function fePaaske($tid, $hvad) {
		// Denne funktion beregner dato for skæve helligdage
		$date = date("Y-m-d", easter_date()); // påskedag
		$newdate = strtotime ( $tid, strtotime ( $date ) ) ; // her plus-minuses
		$newdate = date ( 'd,m' , $newdate ); // datoen formatteres

	 	return $newdate . "," . $hvad; // udskriver resultatet
	}
}

Dannebrog vises ved hjælp af denne funktion:

	public function dag($dato, $maaned, $hvad) {
		$flagstang = "dannebrog.gif"; // stien til billedet af Dannebrog
		// undersøger om det er en flagdag
		if (date('m') == $maaned && date('d') == $dato) {
			echo "<img src='" . $flagstang . "' alt='Dannebrog' width='50' height='38' >"; // kan skaleres efter behov
			echo "<p style='font-size:smaller'>I dag flages for: " . $hvad . "</p>";
		}
	}

Funktionen bruger $dato og $maaned til at definere datoen. $hvad er en kort beskrivelse af begivenheden. Når dagen og måneden indtræffer vises et flag (dannebrog.gif) samt den korte beskrivelse af begivenheden, fx “H.K.H. Prins Joachim”.

Herefter var det kun et spørgsmål om at instantiere klassen:

$ny = new flagDag(); // instantierer klassen

… og om at definere diverse flagdage, som fremgår af kalenderen hos Danmarks-Samfundet. Flagdagen defineres sådan:

$ny->dag(01,01,"Nytårsdag");

Påskeproblemet

De “kalenderfaste” flagdage var relativt simple. Det er straks værre med påsken, der følger en relativt kompleks månekalender. da.wikipedia.org skriver at påsken falder sådan:

Påskedag er den første søndag efter første fuldmåne efter forårsjævndøgn.

Beregning af påskedagene kræver altså viden om jævndøgn, og hvornår det er fuldmåde. Heldigvis har PHP en funktion, der beregner påskedagen, nemlig easter_date().

På nettet fandt jeg en metode til at lægge tid til en dato, en den funktionalitet byggede jeg så ind i denne funktion:

	function fePaaske($tid, $hvad) {
		// Denne funktion beregner dato for skæve helligdage
		$date = date("Y-m-d", easter_date()); // påskedag
		$newdate = strtotime ( $tid, strtotime ( $date ) ) ; // her plus-minuses
		$newdate = date ( 'd,m' , $newdate ); // datoen formatteres

	 	return $newdate . "," . $hvad; // udskriver resultatet
	}

Kirkens påskedag er bestemmende for en hel række helligdage, der falder lidt forskelligt fra år til år. Systemet ser sådan ud:

• Palmesøndag – søndagen før påske (påske minus en uge)
• Skærtorsdag – påske søndag minus 3 dage (Halv stang t. kl. 12:00)
• 1. påskedag – påskesøndagen
• 2. påskedag –  påske søndag + en dag
• Store Bededag – 4. fredag efter påske
• Kristi Himmelfart – 6. torsdag efter skærtorsdag
• 1. pinsedag –  7. søndag efter påske
• 2. pinsedag – pinsedag + 1dag

Julen falder heldigvis på faste datoer, så det er til at have med at gøre…

• 1. juledag – fast dato 25.12.
• 2. juledag – fast dato 26.12.

Ved hjælp af min funktion kan man lægge år, dage, uger og måneder til påskedagen. Og derfor bliver beregningen af fx. 1. pinsedag relativt simpel:

$fPin = $ny->fePaaske("+7 weeks", "1. Pinsedag"); // 1. Pinsedag

Men scriptet returnerer en streng og funktionen, der viser en falgdag kræver to tal og en streng. En streng kan forvandles til et tal med (int); men jeg har kun brug for en del af strengen. Dagen og måneden skal isoleres ved hjælp af substring. Det leder frem til denne magiske formular, der viser flaget på de “skæve” helligdage:

$ny->dag((int)substr($fPin,0,2), // 1. Pinsedag
	(int)substr($fPin,3,4),
	substr($fPin,6)
	);

Den ovenstående kode skulle skrives 8 gange, og det ligner et job for et loop. I en senere version blev denne kode derfor erstattet med et array og et loop. Koden kom til at se sådan ud:

$kadosh = array(
	$ny->fePaaske("-1 weeks", "Palmesøndag"), // Palmesøndag
	$ny->fePaaske("-3 days", "Skærtorsdag"), // Skærtorsdag
	$ny->fePaaske("+0 days", "1. Påskedag"), // 1. Påskedag (fuldmåne efter equinox)
	$ny->fePaaske("+1 days", "2. Påskedag"), // 2. Påskedag
	$ny->fePaaske("+5 days +3 weeks", "Store Bededag"), // Store Bededag
	$ny->fePaaske("-3 days +6 weeks","Kristi Himmelfart"), // Kristi Himmelfart
	$ny->fePaaske("+7 weeks", "1. Pinsedag"), // 1. Pinsedag
	$ny->fePaaske("+7 weeks +1 days", "2. Pinsedag") // 2. Pinsedag
	);

$i = 0; // looper derefter gennem kadosh-arrayet og kombinerer ny->dag med ny->fePaaske

while($i <= count($kadosh))
	{
	$ny->dag(
		(int)substr($kadosh[$i],0,2), // dag substring som integer
		(int)substr($kadosh[$i],3,4), // måned substring som integer
		substr($kadosh[$i],6) // hvad (pladrer strengen ud fra 6. karakter)
		);
	$i++;
	};

 

Tilbage stod at indskrive flagdatoerne i scriptet. Resultatet kan ses her. Måske. Hvis det ikke er flagdag i dag, så er siden altså blank. Og det var netop meningen. Der skal kun være et flag når det er en flagdag.

Debugging

Nu får vi så se, om koden virker. Debugging varer et års tid. Hvis multimusen.dk flager på en flagdag, så virker sagerne jo.

Koden

Herunder er PHP-koden som den så ud i første omgang, inden loopet herover. Det er selvfølgelig den rå betaversion; men den kan bygges ind i et PHP-baseret website. Det forudsættes, at koden ligger i samme mappe som billedet af flaget.

<?php
/* DANSKE FLAGDAGE
Af: Per Thykjaer Jensen
Beskrivelse: Printer danske flagdage til en webside via PHP.

Version: 0.2 Beta - flagdage.

Ændringer:
Version 0.2 - denne version kan beregne kirkelige flagdage baseret på påskedag.
0.11 - Dannebrog som .gif af hensyn til kompabilitet.
Version 0.1 - basal funktionalitet. På flagdage med fast dato vises et flag.

Dato: 20120608
Copyright: GPLv3 - se licensen her: http://www.gnu.org/copyleft/gpl.html
*/
class flagDag
{
	// printer hvis dagen er en flagdag
	public function dag($dato, $maaned, $hvad) {
		$flagstang = "dannebrog.gif"; // stien til billedet af Dannebrog
		// undersøger om det er en flagdag
		if (date('m') == $maaned && date('d') == $dato) {
			echo "<img src='" . $flagstang . "' alt='Dannebrog' width='50' height='38' >"; // kan skaleres efter behov
			echo "<p style='font-size:smaller'>I dag flages for: " . $hvad . "</p>";
		}
	}

	// sådan: plusTid('+3 weeks +5 days');
	function fePaaske($tid, $hvad) {
		// Denne funktion beregner dato for skæve helligdage
		$date = date("Y-m-d", easter_date()); // påskedag
		$newdate = strtotime ( $tid, strtotime ( $date ) ) ; // her plus-minuses
		$newdate = date ( 'd,m' , $newdate ); // datoen formatteres

	 	return $newdate . "," . $hvad; // udskriver resultatet
	}
}

$ny = new flagDag(); // instantierer klassen

// FLAGDAGE
$ny->dag(01,01,"Nytårsdag");
$ny->dag(05,02,"H.K.H. Kronprinsesse Mary");
$ny->dag(06,02,"H.K.H. Prinsesse Marie");
$ny->dag(09,04,"Danmarks besættelse. Der flages på halv stang til kl. 12:00.");
$ny->dag(16,04,"H.K.H. Dronning Margrethe II.");
$ny->dag(29,04,"H.K.H. Prinsesse Benedikte.");
$ny->dag(05,05,"Danmarks befrielse 1945.");
$ny->dag(26,05,"H.K.H. Kronprins Frederik.");
$ny->dag(05,06,"Grundlovsdag (1849).");
$ny->dag(07,06,"H.K.H. Prins Joachim"); // protektor for Danmarks-Samfundet
$ny->dag(11,06,"H.K.H. Prinsgemal Henrik.");
$ny->dag(15,06,"Valdemarsdag og Genforeningen (1920)");
$ny->dag(05,09,"H.K.H. Prins Joachim");
$ny->dag(25,12,"Juledag.");

// FORSVARETS FLAGDAGE
$ny->dag(29,01,"Holmens Hæderstegn.");
$ny->dag(02,02,"Kampen ved Mysunde (1864).");
$ny->dag(11,02,"Stormen på København (1659).");
$ny->dag(02,04,"Slaget på Reden (1801).");
$ny->dag(18,04,"Slaget ved Dybbøl (1864).");
$ny->dag(09,05,"Kampen ved Helgoland (1864).");
$ny->dag(05,06,"Kampen ved Dybbøl (1848).");
$ny->dag(01,07,"Slaget i Køge Bugt (1677).");
$ny->dag(06,07,"Slaget ved Fredericia (1849).");
$ny->dag(25,07,"Slaget ved Isted 1850.");
$ny->dag(04,10,"Stormen på Frederiksstad 1850.");

/* KIRKELIGE FLAGDAGE
De "skæve" kirkelige helligdage følger en månekaldender og falder et antal dage efter en bestemt fuldmåne.
Udgangspunktet for beregningerne er påskedag.

Systemet ser sådan ud:

	Palmesøndag - søndagen før påske (påske minus en uge)
	Skærtorsdag - påske søndag minus 3 dage (Halv stang t. kl. 12:00)
	1. påskedag - påskesøndagen
	2. påskedag -  påske søndag + en dag
	Store Bededag - 4. fredag efter påske
	1. pinsedag -  7. søndag efter påske
	2. pinsedag - pinsedag + 1dag
	Kristi Himmelfart - 6. torsdag efter skærtorsdag
	1. juledag - fast dato 25.12.
	2. juledag - fast dato 26.12.

Eftersom de skæve helligdage afhænger af påsken og månen så er PHPs påskeberegning et udgangspunkt for tidsberegningerne
*/

$palmeS = $ny->fePaaske("-1 weeks", "Palmesøndag"); // Palmesøndag
$skaerT = $ny->fePaaske("-3 days", "Skærtorsdag"); // Skærtorsdag
$PaaD = $ny->fePaaske("+0 days", "1. Påskedag"); // 1. Påskedag (fuldmåne)
$APaaD = $ny->fePaaske("+1 days", "2. Påskedag"); // 2. Påskedag
$stB = $ny->fePaaske("+5 days +3 weeks", "Store Bededag"); // Store Bededag
$KrH = $ny->fePaaske("-3 days +6 weeks","Kristi Himmelfart"); // Kristi Himmelfart
$fPin = $ny->fePaaske("+7 weeks", "1. Pinsedag"); // 1. Pinsedag
$aPin = $ny->fePaaske("+7 weeks +1 days", "2. Pinsedag"); // 2. Pinsedag

$ny->dag(25,12,"1. Juledag."); // helligdage med fast dato
$ny->dag(26,12,"2. Juledag.");

// Et loop gennem et array kunne ha gjort det følgende mere elegant ... næste version ...

$ny->dag((int)substr($palmeS,0,2), // Palmesøndag
	(int)substr($palmeS,3,4),
	substr($palmeS,6)
	);

$ny->dag((int)substr($skaerT,0,2), // Skærtorsdag
	(int)substr($skaerT,3,4),
	substr($skaerT,6)
	);

$ny->dag((int)substr($paaD,0,2), // Påskedag
	(int)substr($paaD,3,4),
	substr($paaD,6)
	);

$ny->dag((int)substr($APaaD,0,2), // 2. Påskedag
	(int)substr($APaaD,3,4),
	substr($APaaD,6)
	);

$ny->dag((int)substr($stB,0,2), // Store Bededag
	(int)substr($xstB,3,4),
	substr($stB,6)
	);

$ny->dag((int)substr($KrH,0,2), // Kristi Himmelfartsdag
	(int)substr($KrH,3,4),
	substr($KrH,6)
	);

$ny->dag((int)substr($fPin,0,2), // 1. Pinsedag
	(int)substr($fPin,3,4),
	substr($fPin,6)
	);

$ny->dag((int)substr($aPin,0,2), // 2. Pinsedag
	(int)substr($aPin,3,4),
	substr($aPin,6)
	);

/* PRIVATE FLAGDAGE
Indfør dine private flagdage herunder
Format: "dd,mm, begivenhed"
eksempel $ny->dag(03,06,"test");
*/

// eksempel
// $ny->dag(27,02,"Pers fødselsdag");

?>

Koden herover kan faktisk bruges til mange ting. Ved få ændring kan den gøres til et WordPress plugin – og det er i denne form at jeg bruger koden nu.