Location: PHPKode > projects > Netautor Professional > netautor/napro4/include/npf_lib/npf_date.xml
<?xml version = '1.0' encoding = 'UTF-8' standalone = 'no' ?>
<NA_FUNCTION_DESCRIPT>
	<FUNCTION name="npf_date" call="npf_date" context="date / time" date="2001-06-27" depricated="0" internal="1" tail="0">
		<AUTHOR>
			<COMPANY>/digiconcept/</COMPANY>
			<NAME>Stefan Rottensteiner</NAME>
			<EMAIL>hide@address.com</EMAIL>
		</AUTHOR>
		<DESCRIPT lang="de">
			Allgemeine Funktion zum Ausgeben und Rechnen mit Datumswerten und / oder Umformatieren.&lt;br&gt;
			Die prinzipielle Vorgangsweise der Funktion:&lt;br&gt;
			1. Ausgangsdatum festlegen. Kann vom Benutzer bestimmt werden (z.B. via RESTORE.ELEMENT), ansonst gilt die 
			aktuelle Server Zeit. Das darin enthaltene Format wird zumeist automatisch erkannt.
			Es gibt jedoch auch die M&amp;ouml;glichkeit, dieses mit den angegebenen K&amp;uuml;rzeln im Parameter RESTORE.FORMAT selbst zu bestimmen.&lt;br&gt;
			2. Rechenoperationen - wenn gew&amp;uuml;nscht. Siehe *.ADD Parameter&lt;br&gt;
			3. Ausgabe (au&amp;szlig;er MODE=SILENT) und / oder speichern in ein via STORE.ELEMENT angegebenes Element (Kann weiter via STORE.FORMAT spezifiziert werden).
		</DESCRIPT>
		<DESCRIPT lang="en">
		Common function to deal with date values. The function operates in 2 steps&lt;br&gt;
		1. Read the starting date. Can be also read from user given elements (RESTORE.ELEMENT)&lt;br&gt;
		2. Do the calculations if some .*ADD params has been given&lt;br&gt;
		3. Output (can be formated via VALUE.FORMAT) and / or store into new element (STORE.ELEMENT), even with its own STORE.FORMAT format.
		</DESCRIPT>
		<PARAM name="date" new_name="timestamp" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-06-27"><DEFAULT/><DESCRIPT/><VALUE/></PARAM>
		<PARAM name="timestamp" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Das Ausgangsdatum als Unix-Timestamp</DESCRIPT>
			<DESCRIPT lang="en">Startdate as Unix-Timestamp</DESCRIPT>
		</PARAM>
		<PARAM name="dependon" new_name="dependon.element" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-06-27"><DEFAULT/><DESCRIPT/></PARAM>
		<PARAM name="dependon.value" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Wert gegen den geprueft werden soll</DESCRIPT>
			<DESCRIPT lang="en">Value to check on</DESCRIPT>
		</PARAM>
		<PARAM name="dependon.element" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Element welches zu pruefen ist</DESCRIPT>
			<DESCRIPT lang="en">Element to check</DESCRIPT>
		</PARAM>
		<PARAM name="dependon.operator" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Operator der zur Pruefung benutzt wird</DESCRIPT>
			<DESCRIPT lang="en">Operator for the check</DESCRIPT>
			<VALUE>EQ</VALUE>
			<VALUE>GT</VALUE>
			<VALUE>LT</VALUE>
			<VALUE>LE</VALUE>
			<VALUE>GE</VALUE>
			<VALUE>NE</VALUE>
			<VALUE>EMPTY</VALUE>
			<VALUE>NONEMPTY</VALUE>
			<VALUE>LK</VALUE>
		</PARAM>
		<PARAM name="dependon.context" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>THIS</DEFAULT>
			<DESCRIPT lang="de">Legt fest aus welchem Context das Vergleichselement genommen wird</DESCRIPT>
			<DESCRIPT lang="en">Sets the Context of the Element</DESCRIPT>
			<VALUE>THIS</VALUE>
			<VALUE>GLOBALS</VALUE>
			<VALUE>FEATURE</VALUE>
			<VALUE>USER</VALUE>
			<VALUE>PARENT</VALUE>
			<VALUE>SESSION</VALUE>
			<VALUE>GET</VALUE>
			<VALUE>POST</VALUE>
		</PARAM>
		<PARAM name="format_restore" new_name="restore.format" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-06-27"><DEFAULT>U</DEFAULT><DESCRIPT/><VALUE>U</VALUE></PARAM>
		<PARAM name="restore.format" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-06-27">
			<DEFAULT>U</DEFAULT>
			<DESCRIPT lang="en">Format of startdate (format of date to be read):&lt;br&gt;
&lt;b&gt;U&lt;/b&gt; : Date will be read as Unix-Timestamp. Exception : If the time is a string of length 10 and there is a . (dot) within, RESTORE.FORMAT=x will be assumed.&lt;br&gt;
&lt;b&gt;X&lt;/b&gt; : Date will be read as YYYYMMDD&lt;br&gt;
&lt;b&gt;x&lt;/b&gt; : Date will be read as DD.MM.YYYY&lt;br&gt;
&lt;b&gt;x&lt;/b&gt;[aSingleChar] : DD[aSingleChar]MM[aSingleChar]YYYY. YYYY is optional&lt;br&gt;
&lt;b&gt;t&lt;/b&gt; : HHMMSS&lt;br&gt;
&lt;b&gt;t&lt;/b&gt;[aSingleChar] : HH[aSingleChar]MM[aSingleChar]SS. SS is optional&lt;br&gt;</DESCRIPT>
			<DESCRIPT lang="de">Format des einzulesenden Datums (Ausgangsdatum) :&lt;br&gt;
&lt;b&gt;U&lt;/b&gt; : Datum liegt als Unix-Timestamp vor. Ausnahme : Ist das Datum ein String der L&amp;auml;nge 10 und ist das Trennzeichen . (Punkt) vorhanden, so wird ein RESTORE.FORMAT 
=x angenommen&lt;br&gt;
&lt;b&gt;X&lt;/b&gt; : Datum liegt im Format YYYYMMDD vor&lt;br&gt;
&lt;b&gt;x&lt;/b&gt; : Datum liegt im Format DD.MM.YYYY vor &lt;br&gt;
&lt;b&gt;x&lt;/b&gt;[aSingleChar] : DD[aSingleChar]MM[aSingleChar]YYYY. YYYY ist optional&lt;br&gt;
&lt;b&gt;t&lt;/b&gt; : HHMMSS&lt;br&gt;
&lt;b&gt;t&lt;/b&gt;[aSingleChar] : HH[aSingleChar]MM[aSingleChar]SS. SS ist optional&lt;br&gt;</DESCRIPT>
			<VALUE>U</VALUE>
		</PARAM>
		<PARAM name="store_native" new_name="" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-10" date="2001-11-06">
			<DEFAULT/>
			<DESCRIPT lang="de">Name einer lokalen Variable welche das errechnete Datum als Unix-Timestamp aufnehmen soll</DESCRIPT>
			<DESCRIPT lang="en">Name of local variable storing calculated date as Unix-Timestamp</DESCRIPT>
		</PARAM>
		<PARAM name="store.format" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-11-06">
			<DEFAULT>U</DEFAULT>
			<DESCRIPT lang="de">Format des zu speichernden Datumswertes.</DESCRIPT>
			<DESCRIPT lang="en">Format of saved date value</DESCRIPT>
		</PARAM>
		<PARAM name="store" new_name="store.element" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-06-27"><DEFAULT/><DESCRIPT/><VALUE/></PARAM>
		<PARAM name="store.element" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Element zur Aufnamhe des errechneten Datumswertes</DESCRIPT>
			<DESCRIPT lang="en">Selects the element in which the calculated date value is stored</DESCRIPT>
		</PARAM>
		<PARAM name="store.context" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>THIS</DEFAULT>
			<DESCRIPT lang="de">Auswahl des Kontext zur Aufnahme des errechneten Datumswertes</DESCRIPT>
			<DESCRIPT lang="en">Selects the context in which the calculated date value is stored</DESCRIPT>
			<VALUE>THIS</VALUE>		<VALUE>GLOBALS</VALUE>
			<VALUE>FEATURE</VALUE>	<VALUE>USER</VALUE>
			<VALUE>PARENT</VALUE>	<VALUE>SESSION</VALUE>
		</PARAM>
		<PARAM name="restore" new_name="restore.element" 	magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-10" date="2001-06-27"><DEFAULT/><DESCRIPT/></PARAM>
		<PARAM name="restore.element" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Elemente in die die Werte gespeichert werden</DESCRIPT>
			<DESCRIPT lang="en">Selects the elements in which the data is stored</DESCRIPT>
		</PARAM>
		<PARAM name="restore.context" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>THIS</DEFAULT>
			<DESCRIPT lang="de">Auswahl des Kontext aus dem der Wert geholt wird</DESCRIPT>
			<DESCRIPT lang="en">Selects the elements from which the data is taken</DESCRIPT>
			<VALUE>THIS</VALUE>		<VALUE>GLOBALS</VALUE>
			<VALUE>FEATURE</VALUE>	<VALUE>USER</VALUE>
			<VALUE>PARENT</VALUE>	<VALUE>SESSION</VALUE>
		</PARAM>
		<PARAM name="format" new_name="value.format" magic="1" quote="0" flag="0" explizit="0" depricated="2002-01-25" date="2001-06-27"><DEFAULT>d.m.Y H:i:s</DEFAULT><DESCRIPT/><VALUE/></PARAM>
		<PARAM name="value.format" magic="1" quote="0" flag="0" explizit="0" depricated="0" date="2001-06-27">
			<DEFAULT>d.m.Y H:i:s</DEFAULT>
			<DESCRIPT lang="de">Format der Ausgabe</DESCRIPT>
			<DESCRIPT lang="en">Format of calculated date</DESCRIPT>
		</PARAM>
		<PARAM name="day" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Tag des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this day</DESCRIPT>
		</PARAM>
		<PARAM name="month" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Monat des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this month</DESCRIPT>
		</PARAM>
		<PARAM name="year" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Jahr des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this year</DESCRIPT>
		</PARAM>
		<PARAM name="hour" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Stunde des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this hour</DESCRIPT>
		</PARAM>
		<PARAM name="min" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Minute des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this minute</DESCRIPT>
		</PARAM>
		<PARAM name="sec" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT/>
			<DESCRIPT lang="de">Sekunde des Ausgangsdatums</DESCRIPT>
			<DESCRIPT lang="en">Set this second</DESCRIPT>
		</PARAM>
		<PARAM name="add_day" new_name="day.add" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="day.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zum Tag des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of days (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_month" new_name="month.add" magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="month.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zum Monat des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of months (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_year" new_name="year.add"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="year.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zum Jahr des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of years (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_sec" new_name="sec.add"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="sec.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zur Sekunde des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of seconds (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_min" new_name="min.add"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="min.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-07-02">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zur Minute des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of minutes (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_hour" new_name="hour.add"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="hour.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Wird zur Stunde des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of hours (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="add_week" new_name="week.add"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT>0</DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="week.add" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">Wird zur Kalenderwoche des Ausgangsdatums hinzugez&amp;auml;hlt (kann + und - sein)</DESCRIPT>
			<DESCRIPT lang="en">Add this amount of weeks (can be + or -)</DESCRIPT>
		</PARAM>
		<PARAM name="pre" 	new_name="pre.outer"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT></DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="pre.outer" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">
				HTML-Pr&amp;auml;fix&lt;BR&gt;
				Wenn man vor der Ausgabe dieser Funktion noch etwas anzeigen m&amp;ouml;chte, jedoch nur wenn die Funktion eine Ausgabe liefert,
				kann dieser Text im Parameter "pre.outer" gesetzt werden. 
			</DESCRIPT>
			<DESCRIPT lang="en">
				HTML-Prefix&lt;BR&gt;
				If text should be displayed before the output of this function only if the function returns output,
				this text can be specified using the "pre.outer" parameter.
			</DESCRIPT>
		</PARAM>
		<PARAM name="post" 	new_name="post.outer"  magic="0" quote="0" flag="0" explizit="0" depricated="2001-12-12" date="2001-07-02"><DEFAULT></DEFAULT><DESCRIPT/></PARAM>
		<PARAM name="post.outer" magic="0" quote="0" flag="0" explizit="0" depricated="0" date="2001-12-12">
			<DEFAULT/>
			<DESCRIPT lang="de">
				HTML-Postfix&lt;BR&gt;
				Wenn man nach der Ausgabe dieser Funktion noch etwas anzeigen m&amp;ouml;chte, jedoch nur wenn die Funktion eine Ausgabe liefert,
				kann dieser Text im Parameter "post.outer" gesetzt werden.
			</DESCRIPT>
			<DESCRIPT lang="en">
				HTML-Postfix &lt;BR&gt;
				If text should be displayed before the output of this function only if the function returns output,
				this text can be specified using the "pre.outer" parameter.
			</DESCRIPT>
		</PARAM>
		<PARAM name="silent" magic="0" quote="0" flag="1" explizit="0" depricated="2002-01-25" date="2001-07-02">
			<DEFAULT>0</DEFAULT>
			<DESCRIPT lang="de">Errechnet Datum aber ergibt keinen HTML-Output. Ab nun als MODE=SILENT!</DESCRIPT>
			<DESCRIPT lang="en">Calculate date but do no HTML-output. From now, please use MODE=SILENT!</DESCRIPT>
		</PARAM>
		<PARAM name="mode" magic="0" quote="3" flag="0" explizit="0" depricated="0" date="2002-01-25">
			<DEFAULT></DEFAULT>
			<DESCRIPT lang="de">Definiert den Operationsmodus&lt;br&gt;SILENT : Keine HTML-Ausgabe</DESCRIPT>
			<DESCRIPT lang="en">Defines the operation mode&lt;br&gt;SILENT : No HTML-Output</DESCRIPT>
			<VALUE>SILENT</VALUE>
			</PARAM>
	</FUNCTION>
</NA_FUNCTION_DESCRIPT>
Return current item: Netautor Professional