
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)