time2string()
=============

FUNKTION
--------
::

	string time2string( string format, int time )

	

ARGUMENTE
---------
::

	format: String, der das Format der Zeitausgabe festlegt.
	time: Eine Anzahl von Sekunden, die ausgegeben werden soll.

ERGEBNIS
--------
::

	Zeit in String-Form.

BESCHREIBUNG
------------
::

	Der Formatstring wird zurueckgegeben, wobei bestimmte Ersetzungs-
	symbole durch passende Daten, die aus der Zeit berechnet werden,
	ersetzt werden. Die Ersetzungssymbole funktionieren aehnlich
	denen aus 'printf' bekannten Symbolen. Insbesondere kann eine
	Feldbreite mit angegeben werden.

	Folgende Ersetzungssymbole sind erlaubt:
	%%	wird durch ein Prozent (%) ersetzt.
	%n, %w, %d, %h, %m, %s
		  werden durch die Anzahl der Monate, Wochen, Tage, Stunden, Minuten oder
      Sekunden ersetzt. Die Funktion erkennt, welches die groesste benutzte
		  Zeiteinheit ist und rechnet die keineren so um, dass sie zwischen 0 und
      jeweiligen Maximum der Zeiteinheit liegen (59, 23 etc.) liegen.
 	%N	wird durch die Worte 'Woche' oder 'Wochen' ersetzt,
      je nachdem welchen Wertd %n haette.
 	%W	wird durch die Worte 'Woche' oder 'Wochen' ersetzt,
		  je nachdem welchen Wert %w haette.
	%D	wird durch die Worte 'Tag' oder 'Tage' ersetzt,
		  je nachdem welchen Wert %d haette.
	%H,%M,%S
		  werden durch die Worte 'Stunde(n)', 'Minute(n)' bzw. 'Sekunde(n)'
      ersetzt.
	%X	wird durch die groesste Zeiteinheit ersetzt, die nicht Null ist. Wenn
      bei %X die Feldbreite 0 angegeben wird (also %0X), dann wird nicht der
      ausgeschriebene Name, sonder eine Abkuerzung fuer die Zeiteinheit
      ausgegeben. (Das sind dann 'd','h','m' oder 's'.)
	%x	wird durch den numerischen Wert dieser Zeiteinheit
		  ersetzt.

			

BEISPIELE
---------
::

	time2string( "%m %M", 60 ) -> "1 Minute"
	time2string( "%m %M", 120 ) -> "2 Minuten"
	time2string( "%s %S", 125 ) -> "125 Sekunden"
	time2string( "%m %M und %s %S" ) -> "2 Minuten und 5 Sekunden"
	time2string( "%d:%02h:%02m:%02s", 10000 ) -> "0:02:46:40"
	time2string( "%x %X", 3600 ) -> "1 Stunde"
	time2string( "%x %0X", 3600 ) -> "1 h"
	time2string( "%x %X", 360000 ) -> "4 Tage"
	time2string( "%x %0X", 360000 ) -> "4 d"

SIEHE AUCH
----------
::

	sprintf(E)