Die Zeitfunktionen

Die CPL stellt umfangreiche Funktionen zum Zugriff auf Zeitwerte und Zeitbereiche zur Verfügung. Sowohl Zeitwerte als auch Zeitbereiche verwenden als die Einheit [Tag] und sind vom Datentyp value.

Ein Timewert (Zeitwert) ist eine Gleitkommazahl, welche die Tage und die Tageszeit in Tagen seit dem 30.12.1899 00:00:00 enthält.
Dem Zahlenwert 36525,999988 entspricht somit das Datum 31.12.1999 23:59:59.

Ein Timespanwert (Zeitbereich) ist eine Gleitkommazahl, welche eine Zeitspanne in Tagen enthält.
Dem Zahlenwert 3,5 entspricht somit ein Zeitbereich von 3 Tage und 12 Stunden.

Die Zeit als Gleitkommazahl in Tagen definieren, erlaubt es diese Zahlenwerte mit mathematischen Operationen zu verarbeiten. Subtrahiert man zwei Zeitwerte, so erhält man als Ergebnis einen Zeitbereich. Addiert man einen Zeitbereich zu einem Zeitwert, so erhält man einen neuen Zeitwert.

value timeNext;
value timespanOneHour = 1/24;

timeNext = TimeGetCurrent() + timespanOneHour;

Zeitwert-Funktionen

TimeFormat

TimeGet

TimeGetCurrent

TimeGetCycle

TimeGetDay

TimeGetDayOfWeek

TimeGetDayOfYear

TimeGetHour

TimeGetMicroSecond

TimeGetMilliSecond

TimeGetMinute

TimeGetMonth

TimeGetSecond

TimeGetWeekOfYear

TimeGetYear

TimeIsHoliday

TimeIsLegalHoliday

TimeSetDate

TimeSetHoliday

TimeSetTime

TimeSetWeekOfYear

 

Zeitbereichs-Funktionen

TimeSpanGet

TimeSpanGetDays

TimeSpanGetHours

TimeSpanGetMicroSeconds

TimeSpanGetMilliSeconds

TimeSpanGetMinutes

TimeSpanGetSeconds

TimeSpanGetTotalDays

TimeSpanGetTotalHours

TimeSpanGetTotalMinutes

TimeSpanGetTotalSeconds