TurboPL Referenz

TimeStr Prozedur

Syntax

TimeStr(DateTime: DateTime [; Precision: Integer]): String
Zeit(Zeitstempel: DateTime [; Genauigkeit: Integer]): String

Kategorie

Basisfunktion

Erklärung

Interpretiert die Zahl als Zeitstempel und wandelt diese in eine Zeichenkette um. Ein etwaiger Datumsanteil wird dabei ignoriert. Der Parameter Genauigkeit bestimmt, wie genau die Zeit angezeigt wird:

2        Stunden und Minuten

3        Stunden bis Sekunden

4        Stunden bis Millisekunden

Das Format richtet sich nach dem letzten Aufruf von SetNumberFormats und kann von den Rechnereinstellungen abhängen. Informationen zur Darstellung von Daten und Zeiten finden Sie in "Datum und Uhrzeit" und in "Datum und Uhrzeit formatieren".

Hinweis

In VDP 3 und früher war das Argument von TimeStr kein Zeitstempel sondern eine reine Zeitangabe, also die Anzahl der Minuten seit Mitternacht als Real-Zahl. Wenn man jetzt TimeStr mit einer Real-Zahl wie 720,0 aufruft, ist das Ergebnis nicht mehr 12:00 sondern 0:00, weil die Zahl als Datum mit Uhrzeit und nicht als Minuten nach Mitternacht interpretiert wird. Den gewünschten Wert erhält man am besten dadurch, dass man eine Zeit-Variable vom Typ Time verwendet. Allerdings ist auch eine Typ-Konvertierung möglich: TimeStr(V as Time).

Beispiel

TimeStr(Now)                        ->  "22:57"
TimeStr(Now, 3)                ->  "10:57:34"
TimeStr(Now, 4)                ->  "10:57:34,120"

Wenn das Format zuvor anders eingestellt wird:

SetNumberFormats(2, 2, 2);
TimeStr(Now)                        ->  "10:57 pm"
TimeStr(Now, 3)                ->  "10:57:34 pm"
TimeStr(Now, 4)                ->  "10:57:34.120 pm"

Siehe auch

DateStr, DateTimeStr, SetNumberFormats, Datum und Uhrzeit