<?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.<br> Die prinzipielle Vorgangsweise der Funktion:<br> 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&ouml;glichkeit, dieses mit den angegebenen K&uuml;rzeln im Parameter RESTORE.FORMAT selbst zu bestimmen.<br> 2. Rechenoperationen - wenn gew&uuml;nscht. Siehe *.ADD Parameter<br> 3. Ausgabe (au&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<br> 1. Read the starting date. Can be also read from user given elements (RESTORE.ELEMENT)<br> 2. Do the calculations if some .*ADD params has been given<br> 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):<br> <b>U</b> : 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.<br> <b>X</b> : Date will be read as YYYYMMDD<br> <b>x</b> : Date will be read as DD.MM.YYYY<br> <b>x</b>[aSingleChar] : DD[aSingleChar]MM[aSingleChar]YYYY. YYYY is optional<br> <b>t</b> : HHMMSS<br> <b>t</b>[aSingleChar] : HH[aSingleChar]MM[aSingleChar]SS. SS is optional<br></DESCRIPT> <DESCRIPT lang="de">Format des einzulesenden Datums (Ausgangsdatum) :<br> <b>U</b> : Datum liegt als Unix-Timestamp vor. Ausnahme : Ist das Datum ein String der L&auml;nge 10 und ist das Trennzeichen . (Punkt) vorhanden, so wird ein RESTORE.FORMAT =x angenommen<br> <b>X</b> : Datum liegt im Format YYYYMMDD vor<br> <b>x</b> : Datum liegt im Format DD.MM.YYYY vor <br> <b>x</b>[aSingleChar] : DD[aSingleChar]MM[aSingleChar]YYYY. YYYY ist optional<br> <b>t</b> : HHMMSS<br> <b>t</b>[aSingleChar] : HH[aSingleChar]MM[aSingleChar]SS. SS ist optional<br></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&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&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&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&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&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&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&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&auml;fix<BR> Wenn man vor der Ausgabe dieser Funktion noch etwas anzeigen m&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<BR> 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<BR> Wenn man nach der Ausgabe dieser Funktion noch etwas anzeigen m&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 <BR> 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<br>SILENT : Keine HTML-Ausgabe</DESCRIPT> <DESCRIPT lang="en">Defines the operation mode<br>SILENT : No HTML-Output</DESCRIPT> <VALUE>SILENT</VALUE> </PARAM> </FUNCTION> </NA_FUNCTION_DESCRIPT>