CnvAC

Diese Funktion wandelt einen Wert vom Typ caltime in einen Wert vom Typ alpha. Die angegebenen Formatoptionen (int2) entscheiden über das genaue Format.

Als Optionen (int2) können folgende Konstanten angegeben werden:

• _FmtCaltimeRFC Darstellung nach RFC 2822
• _FmtCaltimeISO Darstellung nach ISO 8601
• _FmtCaltimeDHMS Darstellung als Tage, Stunden, Minuten, Sekunden und Millisekunden als Zeitdifferenz zum 01.01.1601 00: 00: 00. 000
• _FmtCaltimeUTC Umwandlung nach UTC
• _FmtCaltimeDate Konvertierung des Datums mit 'T' als Trenner zwischen Datum und Zeit
• _FmtCaltimeDateBlank Konvertierung des Datums mit Leerzeichen als Trenner zwischen Datum und Zeit
• _FmtCaltimeTimeHMS Konvertierung der Zeit im Format "HH:mm:ss"
• _FmtCaltimeTimeHM Konvertierung der Zeit im Format "HH:mm"
• _FmtCaltimeTimeFull Konvertierung der Zeit im Format "HH:mm:ss.nnnnnnn"
• _FmtCaltimeTZ Umwandlung mit Anzeige der Zeitzone

Bei der Option _FmtCaltimeISO werden die Bestandteile des formatierten Wertes durch die Kombination mit den Optionen _FmtCaltimeDate(...) und _FmtCaltimeTime... definiert. Aus jeder dieser zwei Gruppen kann nur eine Option mit _FmtCaltimeISO kombiniert werden. Zusätzlich kann mit _FmtCaltimeTZ die Zeitzone hinzugefügt werden.

Die Option _FmtCaltimeUTC kann nur in der Kombination mit einer der Konstanten _FmtCaltimeRFC bzw. _FmtCaltimeISO angegeben werden. Ohne die Option _FmtCaltimeUTC wird die angegebene Zeitzonenabweichung (siehe vpBiasMinutes) beachtet.

Beispiele:

tCaltime->vpBiasMinutes # 120;
tCaltime->vpDate # 08.05.2009;
tCaltime->vpTime # 16:52:23;
CnvAC(tCaltime, _FmtCaltimeRFC)  // 'Fri, 08 May 2009 16:52:23 +0200'
CnvAC(tCaltime, _FmtCaltimeRFC | _FmtCaltimeUTC)  // 'Fri, 08 May 2009 14:52:23 +0000'

CnvAC(tCaltime, _FmtCaltimeISO | _FmtCaltimeDate)  // '2009-05-08'
CnvAC(tCaltime, _FmtCaltimeISO | _FmtCaltimeDate | _FmtCaltimeTimeHMS | _FmtCaltimeTZ)  // '2009-05-08T16:52:23+02:00'
CnvAC(tCaltime, _FmtCaltimeISO | _FmtCaltimeDate | _FmtCaltimeTimeHM | _FmtCaltimeUTC)  // '2009-05-08T14:52'
CnvAC(tCaltime, _FmtCaltimeISO | _FmtCaltimeDateBlank | _FmtCaltimeTimeFull)  // '2009-05-08 16:52:23.0000000'

CnvAC(tCaltime, _FmtCaltimeDHMS)  // '149146d 16h 52m 23s'

tCaltime->vpDate # 03.01.1601;
tCaltime->vpTime # 11:20:07;
CnvAC(tCaltime, _FmtCaltimeDHMS)  // '2d 11h 20m 07s'

Mögliche Laufzeitfehler:

• _ErrValueInvalid: Es wurde eine falsche Formatoption in (int2) angegeben.