string | printInterval ( time, format_or_mode, total_fw ) |
string | printInterval ( time, format_or_mode, total_fw, escape_char ) |
time | Bei diesem Parameter handelt es sich um eine Datums- und/oder Zeitangabe. Der Parameter muss vom Typ NONE, INT32, INT64, FLOAT oder STRING sein. Weitere Details zu Zeitangaben sind unter »Zeitangaben« beschrieben. |
format_or_mode | Formatzeichenkette oder Anzahl der Dezimalbruchstellen bei der Sekundenanzeige |
total_fw | Minimale Feldweite der gesamten Ausgabe. Die Ausgabe wird rechtbündig dargestellt und ggf. mit führenden Leerzeichen ausgefüllt. |
escape_char | Escape-Zeichen der Formatanweisung, Normalerweise |
Das Zeitintervall
Eine Steuersequenz beginnt mit dem Zeichen
Für die weitere Beschreibung wird davon ausgegangen, dass
Ein Steuerelement hat grundsätzlich das folgende Format,
wobei Teile in eckigen Klammern
'%' flags [ '{' text '}' ] [field_width] ['.' prec] control.
Kode | Beschreibung |
---|---|
'%' |
Das durch den Parameter |
flags |
Die Flags sind eine beliebige Kombination aus den Zeichen
|
Alternativ kann auch
Anstatt des Zahlenwertes wird der angegebene Text in Abhängigkeit des Wertes ausgegeben.
Der Text wird dabei durch Pipezeichen (
Bei 2 oder mehr Segmenten wird das Segment mit dem des Wertes entsprechenden Index
(Nnullbasiert) ausgegeben. Bei einem Wert
Bei der Interpretation des Textes hat der Backslash (
Beispiel: | |
field_width |
Diese vorzeichenlose Zahl im Dezimalsystem gibt die minimale Feldweite für die
Darstellung eines numerischen Tags an. Sollte die Darstellung der Zahl weniger
als
Werte |
Die vorzeichenlose Zahl
Werte | |
control |
Mit diesem Zeichen wird festgelegt, was dargestellt werden soll.
Hierfür sind alle Buchstaben ( |
Die folgende Tabelle beschreibt alle Flags:
Flag | Beschreibung |
---|---|
'?' |
Es wird nur dann etwas ausgegeben, wenn die zum Tag gehörende Nummer |
'!' |
Es wird nur dann etwas ausgegeben, wenn die zum Tag gehörende Nummer |
' | Die Ziffern von große Zahlen werden in 3-Gruppen zusammengefasst und duch einen Punkt voneinander getrennt. |
'#' |
Wird der Zahlenwert ausgegeben, dann wird ein zusätzliches Zeichen als
Faktorzeichen angehängt. Dieses Zeichen zählt nicht zur Feldweite und ist
eines aus |
'0' | Bei Zahlen wird zum Erreichen der Feldweite der Bereich mit der Ziffer Null anstatt mit dem Leerzeichen aufgefüllt. |
Die folgende Tabelle zeigt alle
Kode | Beschreibung | |
---|---|---|
'n' | 3 |
Die Nanosekunden-Anteile einer Mikrosekunde (Variable #nsec) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'N' | 9 |
Die Nanosekunden-Anteile einer Sekunde (Variable #nsec_of_sec) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'u' | 3 |
Die Mikrosekunden-Anteile einer Millisekunde (Variable #usec) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'U' | 6 |
Die Mikrosekunden-Anteile einer Sekunde (Variable #usec_of_sec) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'i' | 3 |
Die Millisekunden-Anteile einer Sekunde (Variable #msec) werden ausgegeben.
Der Wertebereich ist normalerweise: |
's' | 2 |
Die Sekunden-Anteile einer Minute (Variable #sec) werden ausgegeben.
Der Wertebereich ist normalerweise:
Wurde |
'S' |
Die Gesamtanzahl der ganzen Sekunden (Variable #total_sec) wird ausgegeben.
Wurde | |
'm' | 2 |
Die Minuten-Anteile einer Stunde (Variable #min) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'M' | Die Gesamtanzahl der ganzen Minuten (Variable #total_min) wird ausgegeben. | |
'h' | 2 |
Die Stunde-Anteile eines Tages (Variable #hour) werden ausgegeben.
Der Wertebereich ist normalerweise: |
'H' | Die Gesamtanzahl der ganzen Stunden (Variable #total_hour) wird ausgegeben. | |
'd' |
Die Tages-Anteile einer Woche (Variable #day) werden ausgegeben.
Der Wertebereich ist normalerweise: | |
'D' | Die Gesamtanzahl der ganzen Tage (Variable #total_day) wird ausgegeben. | |
'w' | Die Anzahl der ganzen Wochen (Variable #week) wird ausgegeben. | |
'b' |
Es werden | |
'-' |
Drucke ein | |
'+' |
Drucke ein | |
':' |
Diese Regel gilt für alle Sonderzeichen mit Ausnahme von | |
't' |
Dieses Zeichen ist eine Kurzform und entspricht | |
'T' |
Dieses Zeichen ist eine Kurzform und entspricht | |
'W' |
Dieses Zeichen ist eine Kurzform und entspricht | |
'c' | 5 |
Die Zeitangabe wird kompakt ausgegeben,
d.h. es werden nur die relevanten Zeitfaktoren ausgegeben.
Prinzipiell wird die Zeit im Format
Falls Sekunden angezeigt werden und |
'C' |
Dieses Zeichen ist eine Kurzform und entspricht |
* Wird keine Feldweite für ein Feld angegeben und sind bereits Zeichen ausgegeben worden, dann wird:
Als Funktionsergebnis wird der erzeugte Text geliefert.
Datum & Zeit | |
---|---|
Funktion | Kurzinfo |
Zeitangabe in das Datumsformat (INT32) wandeln. | |
— | |
Berechne den Ostersonntag einen gegebenen Jahres. | |
Berechne den Ostersonntag einen gegebenen Jahres und liefere den März-Tag. | |
— | |
Relative Zeit in Millisekunden zu einem nicht weiter definiertem Startpunkt. | |
Relative Zeit in Nanosekunden zu einem nicht weiter definiertem Startpunkt. | |
textausgabe eines Zeitintervalles | |
Formatierte Ausgabe einer Datums- und Zeitangabe. | |
— | |
— | |
Relative Zeit in Sekunden zu einem nicht weiter definiertem Startpunkt. | |
Eine einzelne Komponenten (von Sekundenbruchteil bis Jahr) einer Zeitangabe errechnen. | |
Die einzelnen Komponenten (von Sekundenbruchteile bis Jahr) einer Zeitangabe errechnen. | |
Zeitangabe in das Zeitformat (INT64) wandeln. | |
Eine Zeitangabe im Unix-Format in eine Zeitangabe im Datumsformat wandeln. | |
Eine Zeitangabe im Unix-Format in eine 64-Bit-Zeitangabe wandeln. | |
Zeitangabe in das Unix-Zeitformat (INT32) wandeln. | |
Relative Zeit in Mikrosekunden zu einem nicht weiter definiertem Startpunkt. | |
Formatierte Ausgabe | |
Funktion | Kurzinfo |
Eine Zeichenkette als Hex-Dump ausgeben. | |
Einen formatierten Text erzeugen. | |
Ein Bitfeld in eine textuelle Darstellung überführen. | |
— | |
textausgabe eines Zeitintervalles | |
Ganzzahl in römischer Schreibweise ausgeben. | |
Formatierte Ausgabe einer Datums- und Zeitangabe. | |
— |