System-Skriptsprache: Allgemeine Funktionen, Funktionen für Datum und Uhrzeit (Date and time functions)

Mithilfe der Funktionen für Datum und Uhrzeit lassen sich CisDate und Zeitpunkte erzeugen und bearbeiten. Zu den Funktionen für Datum und Uhrzeit gehören:

Grundlegende Informationen zu den allgemeinen Funktionen der System-Skriptsprache erhalten Sie im Dokument System-Skriptsprache: Allgemeine Funktionen.

addDays

Name addDays
Beschreibung addDays fügt einem CisDate oder einem Zeitpunkt Tage hinzu.
Signaturen CisDate addDays(CisDate date, Number offset)

Timestamp addDays(Timestamp time, Number offset)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.

offset ist die Anzahl der Tage, die zum Parameter date oder time hinzugefügt werden soll.
Ergebnis Ein CisDate oder Timestamp offset Tage nach dem Parameter date bzw. time.
Fehlerquellen Keine
Beispiele addDays(heute(), 7) gibt ein CisDate in genau einer Woche zurück.

addDays(now(), 7) gibt einen Zeitpunkt in genau einer Woche zurück.

addDays(startOfDay(now()), 1) gibt den Zeitpunkt morgen um 00:00:00.000 zurück.
Kontext ALL
Hinweise Ist offset negativ, dann gibt addDays ein CisDate oder einen Zeitpunkt zurück, der vor date bzw. time liegt.
Siehe auch addHours, addMilliseconds, addMinutes, addSeconds

Folgendes Beispiel aus der Aktivitätsdefinition help.addDays fügt dem aktuellen Tag und dem aktuellen Zeitpunkt Tage hinzu:

function create()
{
var p_offset := parameters.OFFSET;
var r_addDaysDate as CisDate;
var r_addDaysTime as Timestamp;

r_addDaysDate := addDays(today(), p_offset);
r_addDaysTime := addDays(now(), p_offset);

result.VALUE_DATE := dateString(r_addDaysDate);
result.VALUE_TIME := r_addDaysTime;
}

 

addHours

Name addHours
Beschreibung addHours fügt einem CisDate oder einem Zeitpunkt Stunden hinzu.
Signaturen CisDate addHours(CisDate date, Number offset)

Timestamp addHours(Timestamp time, Number offset)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.

offset ist die Anzahl der Stunden, die zum Parameter date oder time hinzugefügt werden soll.
Ergebnis Ein CisDate oder Timestamp offset Stunden nach dem Parameter date bzw. time.
Fehlerquellen Keine
Beispiele addHours(heute(), 24) gibt ein CisDate in genau einem Tag zurück.

addHours(now(), 24) gibt einen Zeitpunkt in genau einem Tag zurück.
Kontext ALL
Hinweise Ist offset negativ, dann gibt addHours ein CisDate oder einen Zeitpunkt zurück, der vor date bzw. time liegt.
Siehe auch addDays, addMilliseconds, addMinutes, addSeconds

Folgendes Beispiel aus der Aktivitätsdefinition help.addHours fügt dem aktuellen Tag und dem aktuellen Zeitpunkt Stunden hinzu:

function create()
{
var p_offset := parameters.OFFSET;
var r_addHoursDate as CisDate;
var r_addHoursTime as Timestamp;

r_addHoursDate := addHours(today(), p_offset);
r_addHoursTime := addHours(now(), p_offset);

result.VALUE_DATE := dateString(r_addHoursDate);
result.VALUE_TIME := r_addHoursTime;
}

 

addMilliseconds

Name addMilliseconds
Beschreibung addMilliseconds fügt einem CisDate oder einem Zeitpunkt Millisekunden hinzu.
Signaturen CisDate addMilliseconds(CisDate date, Number offset)

Timestamp addMilliseconds(Timestamp time, Number offset)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.

offset ist die Anzahl der Millisekunden, die zum Parameter date oder time hinzugefügt werden soll.
Ergebnis Ein CisDate oder Timestamp offset Millisekunden nach dem Parameter date bzw. time.
Fehlerquellen Keine
Beispiele addMilliseconds(heute(), 24*60*60*1000)gibt ein CisDate in genau einem Tag zurück.

addMilliseconds(now(),24*60*60*1000) gibt einen Zeitpunkt in genau einem Tag zurück.

addMilliseconds(endOfDay(now()), 1) gibt den Zeitpunkt morgen um genau eine Millisekunde nach Mitternacht zurück.
Kontext ALL
Hinweise Ist offset negativ, dann gibt addMilliseconds ein CisDate oder einen Zeitpunkt zurück, der vor date bzw. time liegt.
Siehe auch addDays, addHours, addMinutes, addSeconds

Folgendes Beispiel aus der Aktivitätsdefinition help.addMilliseconds fügt dem aktuellen Tag und dem aktuellen Zeitpunkt Millisekunden hinzu:

function create()
{
var p_offset := parameters.OFFSET;
var r_addMillisecondsDate as CisDate;
var r_addMillisecondsTime as Timestamp;

r_addMillisecondsDate := addMilliseconds(today(), p_offset);
r_addMillisecondsTime := addMilliseconds(now(), p_offset);

result.VALUE_DATE := dateString(r_addMillisecondsDate);
result.VALUE_TIME := r_addMillisecondsTime;
}

 

addMinutes

Name addMinutes
Beschreibung addMinutes fügt einem CisDate oder einem Zeitpunkt Minuten hinzu.
Signaturen CisDate addMinutes(CisDate date, Number offset)

Timestamp addMinutes(Timestamp time, Number offset)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.

offset ist die Anzahl der Minuten, die zum Parameter date oder time hinzugefügt werden soll.
Ergebnis Ein CisDate oder Timestamp offset Minuten nach dem Parameter date bzw. time.
Fehlerquellen Keine
Beispiele addMinutes(heute(), 24*60) gibt ein CisDate in genau einem Tag zurück.

addMinutes(now(),24*60) gibt einen Zeitpunkt in genau einem Tag zurück.
Kontext ALL
Hinweise Ist offset negativ, dann gibt addMinutes ein CisDate oder einen Zeitpunkt zurück, der vor date bzw. time liegt.
Siehe auch addDays, addHours, addMilliseconds, addSeconds

Folgendes Beispiel aus der Aktivitätsdefinition help.addMinutes fügt fügt dem aktuellen Tag und dem aktuellen Zeitpunkt Minuten hinzu:

function create()
{
var p_offset := parameters.OFFSET;
var r_addMinutesDate as CisDate;
var r_addMinutesTime as Timestamp;

r_addMinutesDate := addMinutes(today(), p_offset);
r_addMinutesTime := addMinutes(now(), p_offset);

result.VALUE_DATE := dateString(r_addMinutesDate);
result.VALUE_TIME := r_addMinutesTime;
}

 

addSeconds

Name addSeconds
Beschreibung addSeconds fügt einem CisDate oder einem Zeitpunkt Sekunden hinzu.
Signaturen CisDate addSeconds(CisDate date, Number offset)

Timestamp addSeconds(Timestamp time, Number offset)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.

offset ist die Anzahl der Sekunden, die zum Parameter date oder time hinzugefügt werden soll.
Ergebnis Ein CisDate oder Timestamp offset Sekunden nach dem Parameter date bzw. time.
Fehlerquellen Keine
Beispiele addSeconds(heute(), 24*60*60)gibt ein CisDate in genau einem Tag zurück.

addSeconds(now(),24*60*60) gibt einen Zeitpunkt in genau einem Tag zurück.
Kontext ALL
Hinweise Ist offset negativ, dann gibt addSeconds ein CisDate oder einen Zeitpunkt zurück, der vor date bzw. time liegt.
Siehe auch addDays, addHours, addMilliseconds, addMinutes

Folgendes Beispiel aus der Aktivitätsdefinition help.addSeconds fügt dem aktuellen Tag und dem aktuellen Zeitpunkt Sekunden hinzu.

function create()
{
var p_offset := parameters.OFFSET;
var r_addSecondsDate as CisDate;
var r_addSecondsTime as Timestamp;

r_addSecondsDate := addSeconds(today(), p_offset);
r_addSecondsTime := addSeconds(now(), p_offset);

result.VALUE_DATE := dateString(r_addSecondsDate);
result.VALUE_TIME := r_addSecondsTime;
}

 

createCisDate

Name createCisDate
Beschreibung createCisDate erzeugt ein beliebiges CisDate.
Signaturen CisDate createCisDate(Number year)

CisDate createCisDate(Number year, Number month)

CisDate createCisDate(Number year, Number month, Number day)

CisDate createCisDate(Number year, Number month, Number day, Number hour)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute, Number second)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

CisDate createCisDate(String timeZoneId, Number year)

CisDate createCisDate(String timeZoneId, Number year, Number month)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)
Parameter year ist das Jahr.

month ist der Monat.

day ist der Tag.

hour ist die Stunde.

minute ist die Minute.

second ist die Sekunde.

millisecond ist die Millisekunde.

timeZoneId ist die Zeitzone des CisDate.

Alle Parameter außer year sind optional. Fehlende Zeitpartikel werden mit 0 aufgefüllt. Fehlende Datumpartikel werden mit 1 aufgefüllt. Wenn die Zeitzone nicht angegeben wird, so wird die Zeitzone aus dem aktuellen Laufzeitkontext übernommen.
Ergebnis Ein CisDate.
Fehlerquellen Keine
Beispiele createCisDate(year(today()), 1, 1) gibt ein CisDate am Beginn des aktuellen Jahres zurück.

createCisDate(year(today()), 3, -4) gibt ein CisDate 5 Tage vor dem Beginn des 3. Monats im aktuellen Jahr zurück.

createCisDate("GMT", 1980) gibt das CisDate „1980-01-01 GMT“ zurück.

createCisDate("GMT", 1980, 0, 0) gibt das CisDate „1979-11-30 GMT“ zurück
Kontext ALL
Hinweise Sie können die verfügbaren Zeitzonen-Identifikationen in der Anwendung Zeitzonen in der Spalte Identifikation einsehen.
Siehe auch createTimestamp

Folgendes Beispiel aus der Aktivitätsdefinition help.createCisDate erzeugt ein beliebiges CisDate in einer beliebigen Zeitzone:

function create()
{
var p_timezoneId := parameters.TIMEZONE_ID;
var p_year := parameters.YEAR;
var p_month := parameters.MONTH;
var p_day := parameters.DAY;
var p_hour := parameters.HOUR;
var p_minute := parameters.MINUTE;
var p_second := parameters.SECOND;
var p_millisecond := parameters.MILLISECOND;
var r_createCisDate as CisDate;

if (p_timezoneId = "")
r_createCisDate := createCisDate(p_year, p_month, p_day, p_hour, p_minute, p_second, p_millisecond);
else
r_createCisDate := createCisDate(p_timezoneId, p_year, p_month, p_day, p_hour, p_minute, p_second, p_millisecond);

result.VALUE_CISDATE := dateString(r_createCisDate);
result.VALUE_TIMEZONE_ID := timeZoneId(r_createCisDate);
}

 

createTimestamp

Name createTimestamp
Beschreibung createTimestamp erzeugt einen beliebigen Zeitpunkt.
Signaturen Timestamp createTimestamp(Number year)

Timestamp createTimestamp(Number year, Number month)

Timestamp createTimestamp(Number year, Number month, Number day)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute, Number second)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

Timestamp createTimestamp(String timeZoneId, Number year)

Timestamp createTimestamp(String timeZoneId, Number year, Number month)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)
Parameter year ist das Jahr.

month ist der Monat.

day ist der Tag.

hour ist die Stunde.

minute ist die Minute.

second ist die Sekunde.

millisecond ist die Millisekunde.

timeZoneId ist die Zeitzone für die Betrachtung der Zeitpartikel.

Alle Parameter außer year sind optional. Fehlende Zeitpartikel werden mit 0 aufgefüllt. Fehlende Datumpartikel werden mit 1 aufgefüllt
Ergebnis Ein Timestamp in der Zeitzone des Systems.
Fehlerquellen Keine
Beispiele createTimestamp(year(today()), 1, 1) gibt den Zeitpunkt am Beginn des aktuellen Jahres zurück.

createTimestamp(year(today()), 3, -4) gibt den Zeitpunkt 5 Tage vor dem Beginn des 3. Monats im aktuellen Jahr zurück.

createTimestamp("EST", year(today()), 1, 1)gibt den Zeitpunkt zum Jahresbeginn in der angegeben Zeitzone zurück. Je nach Zeitzone des Laufzeitkontexts und aktuellem Datum kann dies z. B. 2019-12-31 14:00:00.000 in der Zeitzone „CES“ sein.

createTimestamp(1980) gibt 1980-01-01 00:00:00.000 in der Zeitzone des aktuellen Laufzeitkontexts zurück.
Kontext ALL
Hinweise
Siehe auch createCisDate

Folgendes Beispiel aus der Aktivitätsdefinition help.createTimestamp erzeugt einen beliebigen Zeitpunkt in der Zeitzone des Systems:

function create()
{
var p_timezoneId := parameters.TIMEZONE_ID;
var p_year := parameters.YEAR;
var p_month := parameters.MONTH;
var p_day := parameters.DAY;
var p_hour := parameters.HOUR;
var p_minute := parameters.MINUTE;
var p_second := parameters.SECOND;
var p_millisecond := parameters.MILLISECOND;
var r_createTimestamp as Timestamp;

if (p_timezoneId = "")
r_createTimestamp := createTimestamp(p_year, p_month, p_day, p_hour, p_minute, p_second, p_millisecond);
else
r_createTimestamp := createTimestamp(p_timezoneId, p_year, p_month, p_day, p_hour, p_minute, p_second, p_millisecond);

result.VALUE_TIMESTAMP := r_createTimestamp;
result.VALUE_TIMEZONE_ID := timeZoneString(r_createTimestamp);
}

 

day

Name day
Beschreibung day gibt für ein CisDate oder einen Zeitpunkt den Tag im Monat als Zahl zurück.
Signaturen Number day(CisDate date)

Number day(Timestamp time)
Parameter date ist ein CisDate, dessen Tag im Monat ermittelt wird.

time ist ein Zeitpunkt, dessen Tag im Monat ermittelt wird.
Ergebnis Der Tag im Monat als Zahl.
Fehlerquellen Keine
Beispiele day(createCisDate(1980, 1, 1) gibt 1 zurück.

day(today()) gibt den heutigen Tag im Monat zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone. So gibt day(createCisDate("EET", 1980, 1, 1)die Zahl 1 zurück unabhängig von der Zeitzone des aktuellen Laufzeitkontexts.

Wird das erzeugte CisDate in einen Zeitpunkt umgewandelt und dessen Jahr ermittelt, dann hängt das Ergebnis von der Zeitzone des aktuellen Laufzeitkontexts ab. So gibt day(toTimestamp(createCisDate("EET", 1980, 1, 1))die Zahl 31 zurück, wenn der aktuelle Laufzeitkontext eine Zeitzone verwendet, die sich westlich von EET befindet.
Siehe auch hour, millisecond, minute, month, second, year

Folgendes Beispiel aus der Aktivitätsdefinition help.day gibt für das aktuelle Datum und den aktuellen Zeitpunkt den Tag im Monat als Zahl zurück:

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := day(p_today);
result.VALUE_TIMESTAMP := day(p_now);
}

 

days

Name days
Beschreibung days bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Tagen.
Signaturen Number days(CisDate from, CisDate to)

Number days(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist die zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Tagen zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Tagen wird 1 Tag. Im Unterschied zu den Funktionen zur Bestimmung der Länge eines Zeitraums in den Zeiteinheiten Stunde, Minute, Sekunde und Millisekunde gibt days einen Wert ungleich 0 zurück, sobald from und to an unterschiedlichen Tagen fallen, auch wenn keine 24 Stunden dazwischen liegen. So gibt days(addSeconds(today(), -1), today())1 und hours(addSeconds(today(), -1), today())0 zurück. Dieses Verhalten ist mit der variablen Länge der Monate sowie den Regelungen zur Sommerzeit und Schaltjahr und Schaltsekunde begründet.
Fehlerquellen Keine
Beispiele days(today(), addDays(today(), 7)) gibt 7 zurück.

days(today(), addHours(today(), 20)) gibt 0 zurück.

days(today(), addHours(today(), 36) gibt 1 zurück.

days(addHours(today(), 36), today()) gibt -1 zurück.

days(addHours(today(), -4), today()) gibt 1 zurück.

days(now(), addDays(now(), 7)) gibt 7 zurück.

days(createCisDate(year(today())), createCisDate(year(today()) + 1)) > 365 ist wahr, wenn das aktuelle Jahr ein Schaltjahr ist.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet. days(createCisDate("NST", 1980), createCisDate("NPT1", 1980))gibt daher -1 zurück, da sich die Zeitzone NST westlich und die Zeitzone NPT1 östlich von GMT+0 befindet. Somit fällt das CisDate to auf den letzten Tag im Jahr 1979 aus der Zeitzone GMT+0 aus betrachtet.
Siehe auch hours, milliseconds, minutes, months, seconds, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.days bestimmt für das aktuelle Datum den Tag im Jahr:

function create()
{
var p_today := today();
var r_dayOfYear := days(createCisDate(year(p_today)), today()) + 1;

result.VALUE := r_dayOfYear;
}

 

dateString

Name dateString
Beschreibung dateString gibt den Datumsteil eines CisDates oder eines Zeitpunkts als Zeichenkette zurück.
Signaturen String dateString(CisDate date)

String dateString(Timestamp time)
Parameter date ist eine Kombination eines Zeitpunkts mit einer Zeitzone.

time ist ein auf Millisekun­den genauer Punkt in der Zeit.
Ergebnis Datumsteil von date oder time. Ist der Parameter ein Zeitpunkt, dann wird der Datumsteil in der Zeitzone des aktuellen Laufzeitkontexts zurückgegeben.
Fehlerquellen Keine
Beispiele dateString(today()) und dateString(now()) geben beiden den Datumteil des heutigen Tages als Zeichenkette zurück.

dateString(MIN_DATE) gibt 1000-01-01 als Zeichenkette gemäß der Formatierung in den Benutzereinstellungen zurück.

dateString(MAX_DATE) gibt 9999-12-31 als Zeichenkette gemäß der Formatierung in den Benutzereinstellungen zurück.

dateString(createCisDate("NPT1", 1980)) gibt 1980-01-01 zurück.

dateString(createTimestamp("NPT1", 1980)) gibt 1979-12-31 zurück, falls sich die Zeitzone des aktuellen Laufzeitkontexts westlich von Katmandu befindet.
Kontext ALL
Hinweise
Siehe auch format, timeString, timeZoneString

Folgendes Beispiel aus der Aktivitätsdefinition help.dateString gibt den Datumsteil des aktuellen Datums und des aktuellen Zeitpunkts als Zeichenkette zurück:

function create()
{
result.VALUE1 := dateString(today());
result.VALUE2 := dateString(now());
}

 

endOfDay

Name endOfDay
Beschreibung endOfDay bestimmt den letzten Zeitpunkt am Ende eines Tages.
Signaturen Timestamp endOfDay(CisDate date)

Timestamp endOfDay(Timestamp time)
Parameter date ist das CisDate, dessen letzter Zeitpunkt am Ende des Tages ermittelt wird.

time ist der Zeitpunkt, dessen letzter Zeitpunkt am Ende des Tages ermittelt wird.
Ergebnis Der letzte Zeitpunkt am Ende des Tages
Fehlerquellen Keine
Beispiele endOfDay(today()) und endOfDay(now()) geben beide den Zeitpunkt um 23:59:59.999 des heutigen Tages zurück.

setActivityWorkDelay(seconds(activity:creationTime, endOfDay(today())) + 1) setzt den Beginnzeitpunkt einer Aktivität zur ersten Sekunde nach Mitternacht des darauf folgenden Tages.
Kontext ALL
Hinweise
Siehe auch startOfDay

Folgendes Beispiel aus der Aktivitätsdefinition help.endOfDay bestimmt den letzten Zeitpunkt am Ende des aktuellen Datums:

function create()
{
var p_now := now();
var r_endOfDay := endOfDay(p_now);

result.VALUE := r_endOfDay;
}

 

hour

Name hour
Beschreibung hour gibt für ein CisDate oder einen Zeitpunkt die Stunde im Tag als Zahl zurück.
Signaturen Number hour(CisDate date)

Number hour(Timestamp time)
Parameter date ist ein CisDate, dessen Stunde ermittelt wird.

time ist ein Zeitpunkt, dessen Stunde ermittelt wird.
Ergebnis Die Stunde im Tag als Zahl.
Fehlerquellen Keine
Beispiele hour(createCisDate(1980, 1, 1) gibt 0 zurück.

hour(createCisDate(1980, 1, 1, 7) gibt 7 zurück.

hour(now()) gibt die aktuelle Stunde im Tag zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone. So gibt hour(createCisDate("EET", 1980, 1, 1, 7)die Zahl 7 zurück, unabhängig von der Zeitzone des aktuellen Laufzeitkontexts.

Wird das erzeugte CisDate in einen Zeitpunkt umgewandelt und dessen Stunde ermittelt, dann hängt das Ergebnis von der Zeitzone des aktuellen Laufzeitkontexts ab. So gibt hour(toTimestamp(createCisDate("EET", 1980, 1, 1))die Zahl 23 zurück, wenn zwischen „EET“ und der Zeitzone des aktuellen Laufzeitkontexts ein Unterschied von einer Stunde besteht.
Siehe auch day, millisecond, minute, month, second, year

Folgendes Beispiel aus der Aktivitätsdefinition help.hour gibt die aktuelle Stunde zurück:

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := hour(p_today);
result.VALUE_TIMESTAMP := hour(p_now);
}

 

hours

Name hours
Beschreibung hours bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Stunden.
Signaturen Number hours(CisDate from, CisDate to)

Number hours(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist die zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Stunden zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Stunden wird 1 Stunde.
Fehlerquellen Keine
Beispiele hours(today(), addHours(today(), 7)) gibt 7 zurück.

hours(today(), addMinutes(today(), 20)) gibt 0 zurück.

hours(today(), addMinutes(today(), 80) gibt 1 zurück.

hours(addMinutes(today(), 80), today()) gibt -1 zurück.

hours(addMinutes(today(), -4), today()) gibt 0 zurück.

hours(now(), addHours(now(), 7)) gibt 7 zurück.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet. hours(createCisDate("NPT1", 1980), createCisDate("NST", 1980))gibt daher 9 zurück, da zwischen den Zeitzonen NPT1 und NST einen Zeitunterschied von 9 Stunden besteht.
Siehe auch days, milliseconds, minutes, months, seconds, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.hours gibt die aktuelle Stunde zurück:

function create()
{
var p_today := today();
var r_hourOfDay := hours(startOfDay(p_today), p_now);

result.VALUE := r_hourOfDay;
}

 

isMaxDate

Name isMaxDate
Beschreibung isMaxDate prüft, ob ein CisDate oder ein Zeitpunkt den größten darstellbaren Wert besitzt.
Signaturen Boolean isMaxDate(CisDate date)

Boolean isMaxDate(Timestamp time)

 
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.
Ergebnis Besitzt date oder time den größten darstellbaren Wert, so ist das Ergebnis der Funktion true.
Fehlerquellen Keine
Beispiele isMaxDate(MAX_DATE) gibt true zurück.

isMaxDate(MIN_DATE) gibt false zurück.
Kontext ALL
Hinweise Der größte darstellbare Wert eines CisDates oder Zeitpunkts (Timestamp) kann z. B. für Gültigkeitsbereiche verwendet werden, die nach oben offen sind.
Siehe auch isMinDate, isUndefinedDate

Folgendes Beispiel aus der Aktivitätsdefinition help.isMaxDate prüft, ob die Konstante MAX_DATE den größten darstellbaren Wert darstellt:

function create()
{
var r_isMaxDate := isMaxDate(MAX_DATE);

result.VALUE := r_isMaxDate;
}

 

isMinDate

Name isMinDate
Beschreibung isMinDate prüft, ob ein CisDate oder ein Zeitpunkt den kleinsten darstellbaren Wert besitzt.
Signaturen Boolean isMinDate(CisDate date)

Boolean isMinDate(Timestamp time)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.
Ergebnis Besitzt date oder time den kleinsten darstellbaren Wert, so ist das Ergebnis der Funktion true.
Fehlerquellen Keine
Beispiele isMinDate(MIN_DATE) gibt true zurück.

isMinDate(MAX_DATE) gibt false zurück.
Kontext ALL
Hinweise Der kleinste darstellbare Wert eines CisDates oder Zeitpunkts (Timestamp) kann z. B. für Gültigkeitsbereiche verwendet werden, die nach unten offen sind.
Siehe auch isMaxDate, isUndefinedDate

Folgendes Beispiel aus der Aktivitätsdefinition help.isMinDate prüft, ob die Konstante MIN_DATE den kleinsten darstellbaren Wert darstellt.

function create()
{
var r_isMinDate := isMinDate(MIN_DATE);

result.VALUE := r_isMinDate;
}

 

isUndefinedDate

Name isUndefinedDate
Beschreibung isUndefinedDate prüft, ob ein CisDate oder ein Zeitpunkt einen nicht darstellbaren Wert besitzt.
Signaturen Boolean isUndefinedDate(CisDate date)

Boolean isUndefinedDate(Timestamp time)
Parameter date ist ein CisDate.

time ist ein Zeitpunkt.
Ergebnis Besitzt date oder time keinen darstellbaren Wert, so ist das Ergebnis der Funktion true.
Fehlerquellen Keine
Beispiele isUndefinedDate(UNEDFINED_DATE) gibt true zurück.

isMinDate(MAX_DATE) gibt false zurück.

isMinDate(MIN_DATE) gibt true zurück.
Kontext ALL
Hinweise Ein undefinierter Wert wird für CisDates und Zeitpunkte verwendet, bevor ein konkreter Wert zugewiesen wurde, wie z. B. der Zeitpunkt der letzten Änderung eines Business Objects (im Attribut updateInfo.updateTime), der seit dem Erfassen nicht mehr geändert wurde.
Siehe auch isMaxDate, isMinDate

Folgendes Beispiel aus der Aktivitätsdefinition help.isUndefinedDate prüft, ob die Konstante UNDEFINED_DATE einen nicht darstellbaren Wert besitzt.

function create()
{
var r_isUndefinedDate := isUndefinedDate(UNDEFINED_DATE);

result.VALUE := r_isUndefinedDate;
}

 

millisecond

Name millisecond
Beschreibung millisecond gibt für ein CisDate oder einen Zeitpunkt die Millisekunde als Zahl zurück.
Signaturen Number millisecond(CisDate date)

Number millisecond(Timestamp time)
Parameter date ist ein CisDate, dessen Millisekunde ermittelt wird.

time ist ein Zeitpunkt, dessen Millisekunde ermittelt wird.
Ergebnis Die Millisekunde als Zahl.
Fehlerquellen Keine
Beispiele millisecond(createCisDate(1980, 1, 1) gibt 0 zurück.

millisecond(createCisDate(1980, 12, 31, 23, 59, 59, 999) gibt 999 zurück.

second(now()) gibt die aktuelle Millisekunde zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone.
Siehe auch day, hour, minute, month, second, year

Folgendes Beispiel aus der Aktivitätsdefinition help.millisecond gibt für das aktuelle Datum und für den aktuellen Zeitpunkt die Millisekunden zurück:

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := millisecond(p_today);
result.VALUE_TIMESTAMP := millisecond(p_now);
}

 

milliseconds

Name milliseconds
Beschreibung milliseconds bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Millisekunden.
Signaturen Number milliseconds(CisDate from, CisDate to)

Number milliseconds(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist das zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Millisekunden zurück.
Fehlerquellen Keine
Beispiele milliseconds(today(), addMilliseconds(today(), 7)) gibt 7 zurück.

milliseconds(today(), addSeconds(today(), 7)) gibt 7000 zurück.

milliseconds(addMilliseconds(today(), -1), today()) gibt 1 zurück.

milliseconds(now(), addMilliseconds(now(), 7)) gibt 7 zurück.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet.
Siehe auch days, hours, minutes, months, seconds, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.milliseconds bestimmt die Anzahl Millisekunden seit Tagesbeginn.

function create()
{
var p_today := today();
var p_now := now();
var r_millisecondOfDay := milliseconds(startOfDay(p_today), p_now);

result.VALUE := r_millisecondOfDay;
}

 

minute

Name minute
Beschreibung minute gibt für ein CisDate oder einen Zeitpunkt die Minute als Zahl zurück.
Signaturen Number minute(CisDate date)

Number minute(Timestamp time)
Parameter date ist ein CisDate, dessen Minute ermittelt wird.

time ist ein Zeitpunkt, dessen Minute ermittelt wird.
Ergebnis Die Minute in der Stunde als Zahl.
Fehlerquellen Keine
Beispiele minute(createCisDate(1980, 1, 1) gibt 0 zurück.

minute(createCisDate(1980, 1, 1, 0, 5) gibt 5 zurück.

minute(now()) gibt die aktuelle Minute in der Stunde zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone. So gibt minute(createCisDate("EET", 1980, 1, 1, 0, 5)die Zahl 5 zurück unabhängig von der Zeitzone des aktuellen Laufzeitkontexts.

Wird das erzeugte CisDate in einen Zeitpunkt umgewandelt und dessen Stunde ermittelt, dann hängt das Ergebnis von der Zeitzone des aktuellen Laufzeitkontexts ab. So gibt minute(toTimestamp(createCisDate("NPT1", 1980, 1, 1, 12))die Zahl 15 zurück, da sich die Zeitzone des aktuellen Laufzeitkontexts („CET“) 4 Stunden und 45 Minuten nach der Zeitzone von Katmandu befindet.
Siehe auch day, hour, millisecond, month, second, year

Folgendes Beispiel aus der Aktivitätsdefinition help.minute gibt für das aktuelle Datum und für den aktuellen Zeitpunkt die Minuten zurück.

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := minute(p_today);
result.VALUE_TIMESTAMP := minute(p_now);
}

 

minutes

Name minutes
Beschreibung minutes bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Minuten.
Signaturen Number minutes(CisDate from, CisDate to)

Number minutes(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist das zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Minuten zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Minuten wird 1 Minute.
Fehlerquellen Keine
Beispiele minutes(today(), addMinutes(today(), 7)) gibt 7 zurück.

minutes(today(), addSeconds(today(), 20)) gibt 0 zurück.

minutes(today(), addSeconds(today(), 80) gibt 1 zurück.

minutes(addSeconds(today(), 80), today()) gibt -1 zurück.

minutes(addSeconds(today(), -1), today()) gibt 0 zurück.

minutes(now(), addMinutes(now(), 7)) gibt 7 zurück.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet. minutes(createCisDate("NPT1", 1980), createCisDate("NST", 1980))gibt daher 555 zurück, da zwischen den Zeitzonen NPT1 und NST ein Zeitunterschied von 555 Minuten besteht.
Siehe auch days, hours, milliseconds, months, seconds, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.minutes bestimmt die Anzahl der Minuten seit Tagesbeginn:

function create()
{
var p_today := today();
var p_now := now();
var r_minuteOfDay := minutes(startOfDay(p_today), p_now);

result.VALUE := r_minuteOfDay;
}

 

month

Name month
Beschreibung month gibt für ein CisDate oder einen Zeitpunkt den Monat im Jahr als Zahl zurück.
Signaturen Number month(CisDate date)

Number month(Timestamp time)
Parameter date ist ein CisDate, dessen Monat im Jahr ermittelt wird.

time ist ein Zeitpunkt, dessen Monat im Jahr ermittelt wird.
Ergebnis Der Monat im Jahr als Zahl.
Fehlerquellen Keine
Beispiele month(createCisDate(1980, 1, 10) gibt 1 zurück.

month(today()) gibt den heutigen Monat im Jahr zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone. So gibt month(createCisDate("EET", 1980, 1, 10)die Zahl 1 zurück, unabhängig von der Zeitzone des aktuellen Laufzeitkontexts.

Wird das erzeugte CisDate in einen Zeitpunkt umgewandelt und dessen Jahr ermittelt, dann hängt das Ergebnis von der Zeitzone des aktuellen Laufzeitkontexts ab. So gibt month(toTimestamp(createCisDate("EET", 1980, 1, 1))die Zahl 12 zurück, wenn der aktuelle Laufzeitkontext eine Zeitzone verwendet, die sich westlich von EET befindet.
Siehe auch day, hour, millisecond, minute, second, year

Folgendes Beispiel aus der Aktivitätsdefinition help.month gibt für das aktuelle Datum und für den aktuellen Zeitpunkt den Monat im Jahr zurück.

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := month(p_today);
result.VALUE_TIMESTAMP := month(p_now);
}

 

months

Name months
Beschreibung months bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Monaten.
Signaturen Number months(CisDate from, CisDate to)

Number months(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist das zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Monaten zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Monaten wird 1 Monat. Im Unterschied zu den Funktionen zur Bestimmung der Länge eines Zeitraums in den Zeiteinheiten Stunde, Minute, Sekunde und Millisekunde gibt months einen Wert ungleich 0 zurück, sobald from und to in unterschiedlichen Monaten fallen. So gibt months(addSeconds(createTimestamp(1980), -1), createTimestamp(1980)) 1 und hours(addSeconds(createTimestamp(1980), -1), createTimestamp(1980))0 zurück. Dieses Verhalten ist mit der variablen Länge der Monate sowie den Regelungen zur Sommerzeit, Schaltjahr und Schaltsekunde begründet.
Fehlerquellen Keine
Beispiele months(today(), addDays(today(), 20)) gibt 0 zurück, falls mehr als 20 Tage bis zum nächsten Monatswechsel verbleiben.

months(addDays(today(), -20), today()) gibt 0 zurück, falls noch keine 20 Tage seit Monatsanfang vergangen sind.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet. months(createCisDate("NST", 1980), createCisDate("NPT1", 1980))gibt daher -1 zurück, da sich die Zeitzone NST westlich und die Zeitzone NPT1 östlich von GMT+0 befindet. Somit fällt das CisDate to auf den letzten Tag im Jahr 1979, von der Zeitzone GMT+0 aus betrachtet.
Siehe auch days, hours, milliseconds, minutes, seconds, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.months bestimmt den Monat im Jahr:

function create()
{
var p_today := today();
var r_monthOfYear := months(createCisDate(year(p_today)), createCisDate(year(p_today), month(p_today))) + 1;

result.VALUE := r_monthOfYear;
}

 

now

Name now
Beschreibung now gibt den aktuellen Zeitpunkt zurück.
Signaturen Timestamp now()
Parameter Keine
Ergebnis Der aktuelle Zeitpunkt, d. h. das aktuelle Datum mit der aktuellen, auf Millise­kunden genauen Zeit.
Fehlerquellen Keine
Beispiele now() gibt den aktuellen Zeitpunkt des Systems zurück.
Kontext ALL
Hinweise
Siehe auch today

Folgendes Beispiel aus der Aktivitätsdefinition help.now gibt den aktuellen Zeitpunkt zurück:

function create()
{
result.VALUE := now();
}

 

second

Name second
Beschreibung second gibt für ein CisDate oder einen Zeitpunkt die Sekunde als Zahl zurück.
Signaturen Number second(CisDate date)

Number second(Timestamp time)
Parameter date ist ein CisDate, dessen Sekunde ermittelt wird.

time ist ein Zeitpunkt, dessen Sekunde ermittelt wird.
Ergebnis Die Sekunde in der Minute als Zahl.
Fehlerquellen Keine
Beispiele second(createCisDate(1980, 1, 1) gibt 0 zurück.

second(createCisDate(1980, 1, 1, 0, 0, 5) gibt 5 zurück.

second(now()) gibt die aktuelle Sekunde in der Minute zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone.
Siehe auch day, hour, millisecond, minute, month, year

Folgendes Beispiel aus der Aktivitätsdefinition help.second gibt für das aktuelle Datum und für den aktuellen Zeitpunkt die Sekunden zurück.

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := second(p_today);
result.VALUE_TIMESTAMP := second(p_now);
}

 

seconds

Name seconds
Beschreibung seconds bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Sekunden.
Signaturen Number seconds(CisDate from, CisDate to)

Number seconds(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist das zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Sekunden zurück. Die Nachkomma­stellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Sekunden wird 1 Sekunde.
Fehlerquellen Keine
Beispiele seconds(today(), addSeconds(today(), 7)) gibt 7 zurück.

seconds(today(), addMilliseconds(today(), 800)) gibt 0 zurück.

seconds(today(), addMilliseconds(today(), 1000) gibt 1 zurück.

seconds(addMilliseconds(today(), -1000), today()) gibt -1 zurück.

seconds(addMilliseconds(today(), -1), today()) gibt 0 zurück.

seconds(now(), addSeconds(now(), 7)) gibt 7 zurück.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet.
Siehe auch days, hours, milliseconds, minutes, months, weeks, years

Folgendes Beispiel aus der Aktivitätsdefinition help.seconds bestimmt die Anzahl Sekunden seit Tagesbeginn.

function create()
{
var p_today := today();
var p_now := now();
var r_secondOfDay := seconds(startOfDay(p_today), p_now);

result.VALUE := r_secondOfDay;
}

 

startOfDay

Name startOfDay
Beschreibung startOfDay bestimmt den ersten Zeitpunkt am Beginn eines Tages.
Signaturen Timestamp startOfDay(CisDate date)

Timestamp startOfDay(Timestamp time)
Parameter date ist das CisDate, dessen erster Zeitpunkt am Beginn des Tages ermittelt wird.

„time“ ist der Zeitpunkt, dessen erster Zeitpunkt am Beginn des Tages ermittelt wird.
Ergebnis Der erste Zeitpunkt am Beginn des Tages
Fehlerquellen
Beispiele startOfDay(today()) und startOfDay(now())geben beide den Zeitpunkt um 00:00:00.000 des heutigen Tages zurück.

setActivityWorkDelay(seconds(activity:creationTime, endOfDay(today()))) setzt den Beginnzeitpunkt einer Aktivität zur letzten Sekunde vor Mitternacht des aktuellen Tages.
Kontext ALL
Hinweise
Siehe auch endOfDay

Folgendes Beispiel aus der Aktivitätsdefinition help.startOfDay bestimmt den ersten Zeitpunkt des aktuellen Tages:

function create()
{
var p_now := now();
var r_startOfDay := startOfDay(p_now);

result.VALUE := r_startOfDay;
}

 

timeString

Name timeString
Beschreibung timeString gibt den Zeitanteil eines CisDates oder eines Zeitpunkts als Zeichenkette zurück.
Signaturen String timeString(CisDate date)

String timeString(Timestamp time)
Parameter date ist ein CisDate, d. h. eine Kombination eines Zeitpunkts mit einer Zeitzone.

time ist ein auf Millisekun­den genauer Zeitpunkt.
Ergebnis Zeitanteil von date oder time.
Fehlerquellen Keine
Beispiele timeString(today()) gibt den Zeitanteil am Beginn des heutigen Tages als Zeichenkette zurück.

timeString(now()) gibt den Zeitanteil des aktuellen Zeitpunkts als Zeichenkette zurück.

timeString(createCisDate("NPT1", 1980)) gibt 00:00 zurück.

timeString(createTimestamp("NPT1", 1980)) gibt 21:15:00 zurück, falls die Differenz zwischen der Zeitzone des aktuellen Laufzeitkontexts und der Zeitzone von Katmandu 2:45 Stunden beträgt.
Kontext ALL
Hinweise
Siehe auch dateString, format, timeZoneId, timeZoneString

Folgendes Beispiel aus der Aktivitätsdefinition help.timeString gibt den Zeitanteil des aktuellen Datums und des aktuellen Zeitpunkts als Zeichenkette zurück:

function create()
{
result.VALUE1 := timeString(today());
result.VALUE2 := timeString(now());
}

 

timeZoneId

Name timeZoneId
Beschreibung timeZoneId gibt die Identifikation der Zeitzone eines CisDates oder Zeitpunkts zurück.
Signaturen String timeZoneId(CisDate date)

String timeZoneId(Timestamp time)
Parameter date ist ein CisDate, dessen Zeitzone bestimmt wird.
Ergebnis Die Identifikation der Zeitzone von date.
Fehlerquellen Keine
Beispiele timeZoneId(today()) gibt die Identifikation der Zeitzone des aktuellen Laufzeitkontexts zurück.

timeZoneId(createCisDate("NPT1", 1980)) gibt NPT1 zurück.

timeZoneId(createTimestamp("NPT1", 1980)) gibt die Identifikation der Zeitzone des aktuellen Laufzeitkontexts zurück.
Kontext ALL
Hinweise Sie können die verfügbaren Zeitzonen-Identifikationen in der Anwendung Zeitzonen in der Spalte Identifikation einsehen.
Siehe auch dateString, timeString, timeZoneString

Folgendes Beispiel aus der Aktivitätsdefinition help.timeZoneId gibt die Identifikation der Zeitzone des aktuellen Datums und des aktuellen Zeitpunkts zurück:

function create()
{
var p_today := today();
var r_timeZoneId := timeZoneId(p_today);

result.VALUE := r_timeZoneId;
}

 

timeZoneString

Name timeZoneString
Beschreibung timeZoneString gibt die Abkürzung der Zeitzone eines CisDates oder eines Zeitpunkts zurück.
Signaturen String timeZoneString(CisDate date)

String timeZoneString(Timestamp time)
Parameter date ist ein CisDate, dessen Zeitzone bestimmt wird.

time ist ein Zeitpunkt, dessen Zeitzone bestimmt wird.
Ergebnis Die Abkürzung der Zeitzone von date bzw. time.
Fehlerquellen Keine
Beispiele timeZoneString(today()) gibt die Abkürzung der Zeitzone des aktuellen Laufzeitkontexts zurück.

timeZoneString(createCisDate("NPT1", 1980)) gibt NPT zurück.

timeZoneString(createTimestamp("NPT1", 1980)) gibt die Abkürzung der Zeitzone des aktuellen Laufzeitkontexts zurück.
Kontext ALL
Hinweise Sie können die verfügbaren Zeitzonen-Identifikationen in der Anwendung Zeitzonen in der Spalte Identifikation einsehen.
Siehe auch dateString, timeString, timeZoneId

Folgendes Beispiel aus der Aktivitätsdefinition help.timeZoneString gibt die Abkürzung der Zeitzone des aktuellen Datums und des aktuellen Zeitpunkts zurück:

function create()
{
result.VALUE1 := timeZoneString(today());
result.VALUE2 := timeZoneString(now());
}

 

today

Name today
Beschreibung today gibt das aktuelle Datum als CisDate ohne Zeitanteil zurück.
Signaturen Timestamp today()

Timestamp (String timeZoneId)
Parameter timeZone Id ist die Identifikation der Zeitzone.
Ergebnis Die Funktion gibt das aktuelle Datum des Systems als ein CisDate zurück, d. h. eine Millise­kunden genauer Zeitpunkt mit Zeitzone.

Wenn eine Zeitzonen-Identifikation angegeben wird, so wird das Datum gemäß der ange­gebenen Zeitzone erzeugt und ausgegeben. Wenn keine Zeitzonen-Identifika­tion angegeben wird, so wird die Zeitzone aus dem aktuellen Laufzeitkontext übernommen.
Fehlerquellen Keine
Beispiele today() gibt das aktuelle Datum des Systems zurück.
Kontext ALL
Hinweise Sie können die verfügbaren Zeitzonen-Identifikationen in der Anwendung Zeitzonen in der Spalte Identifikation einsehen.
Siehe auch now

Folgendes Beispiel aus der Aktivitätsdefinition help.today gibt das aktuelle Datum ohne Zeitanteil zurück:

function create()
{
var p_timeZoneId := parameters.TIMEZONE_ID;
var r_today as CisDate;

if (p_timeZoneId = "")
r_today := today();
else
r_today := today(p_timeZoneId);

result.IS_NULL := isNull(r_today);
result.VALUE := dateString(r_today) + " " + timeString(r_today);
}

 

toTimestamp

Name toTimestamp
Beschreibung toTimestamp wandelt ein CisDate in einen Zeitpunkt um.
Signaturen Timestamp toTimestamp(CisDate date)
Parameter date ist ein CisDate, das in einen Zeitpunkt umgewandelt werden soll.
Ergebnis Der Parameter date als Zeitpunkt
Fehlerquellen Keine
Beispiele toTimestamp(today) gibt den ersten Zeitpunkt des aktuellen Tags zurück.
Kontext ALL
Hinweise
Siehe auch cast, createTimestamp

Folgendes Beispiel aus der Aktivitätsdefinition help.toTimestamp wandelt ein CisDate für das aktuelle Datum in einen Zeitpunkt um:

function create()
{
var p_today := today();
var r_toTimestamp := toTimestamp(p_today);

result.VALUE := toCisDate("", r_toTimestamp);
}

 

weeks

Name weeks
Beschreibung weeks bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Kalenderwochen.
Signaturen Number weeks(CisDate from, CisDate to)

Number weeks(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist die zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Kalenderwochen zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Wochen wird 1 Woche. Im Unterschied zu den Funktionen zur Bestimmung der Länge eines Zeitraums in den Zeiteinheiten Stunde, Minute, Sekunde und Millisekunde gibt „weeks“ einen Wert ungleich 0 zurück, sobald from und to in unterschiedliche Wochen fallen. So gibt weeks(addDays(createCisDate(2020), -1), createCisDate(2020)) 0 zurück, da der 31.12.2019 und der 01.01.2020 beide zu Kalenderwoche 1 im Jahr 2020 gehören. weeks(addDays(createCisDate(2018), -1), createCisDate(2020)) hingegen gibt 1 zurück, da der 31.12.2017 zu Kalenderwoche 52 im Jahr 2017 und der 01.01.2018 zu Kalenderwoche 1 im Jahr 2018 gehört.
Fehlerquellen Keine
Beispiele weeks(createCisDate(year(today())), today()) + 1 gibt die aktuelle Kalenderwoche zurück.

weeks(today(), addDays(today(), 2)) gibt 0 zurück, falls die aktuelle Kalenderwoche noch mindestens 2 Tage hat.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet.

Hinweis
Ist from oder to ein Datum in der letzten oder ersten Kalenderwoche eines Jahres, dann kann die Funktion weeks ein falsches Ergebnis zurückliefern, wenn der letzte Tag im Jahr zur Kalenderwoche 1 des darauffolgenden Jahres gehört oder der erste Tag im Jahr zur letzten Kalenderwoche des vorherigen Jahren gehört.
Siehe auch days, hours, milliseconds, minutes, months, seconds, years

Folgendes Beispiel aus der Aktivitätsdefinition help.weeks bestimmt die Anzahl Kalenderwochen seit Jahresbeginn:

function create()
{
var p_today := today();
var r_weekOfYear := weeks(createCisDate(year(p_today)), p_today) + 1;

result.VALUE := r_weekOfYear;
}

 

year

Name year
Beschreibung year gibt für ein CisDate oder einen Zeitpunkt dessen Jahr als Zahl zurück.
Signaturen Number year(CisDate date)

Number year(Timestamp time)
Parameter date ist ein CisDate, dessen Jahr ermittelt wird.

time ist ein Zeitpunkt, dessen Jahr ermittelt wird.
Ergebnis Das Jahr als Zahl.
Fehlerquellen Keine
Beispiele year(createCisDate(1980, 1, 1) gibt 1980 zurück.

year(today()) gibt das aktuelle Jahr zurück.
Kontext ALL
Hinweise Der Zugriff auf die einzelnen Teile eines CisDates erfolgt mit der im CisDate vermerkten Zeitzone. So gibt year(createCisDate("EET", 1980, 1, 1)die Zahl 1980 zurück, unabhängig von der Zeitzone des aktuellen Laufzeitkontexts.

Wird das erzeugte CisDate in einen Zeitpunkt umgewandelt und dessen Jahr ermittelt, dann hängt das Ergebnis von der Zeitzone des aktuellen Laufzeitkontexts ab. So gibt year(toTimestamp(createCisDate("EET", 1980, 1, 1))die Zahl 1979 zurück, wenn der aktuelle Laufzeitkontext eine Zeitzone verwendet, die sich westlich von EET befindet.
Siehe auch day, hour, millisecond, minute, month, second

Folgendes Beispiel aus der Aktivitätsdefinition help.year gibt für das aktuelle Datum und für den aktuellen Zeitpunkt das Jahr zurück:

function create()
{
var p_today := today();
var p_now := now();

result.VALUE_CISDATE := year(p_today);
result.VALUE_TIMESTAMP := year(p_now);
}

 

years

Name years
Beschreibung years bestimmt die Länge eines Zeitraums zwischen zwei CisDates oder Zeitpunkten in Jahren.
Signaturen Number years(CisDate from, CisDate to)

Number years(Timestamp from, Timestamp to)
Parameter from ist das erste CisDate oder Zeitpunkt.

to ist das zweite CisDate oder Zeitpunkt.
Ergebnis Die Funktion gibt die Länge des Zeitraums zwischen from und to in Jahren zurück. Die Nachkommastellen sind im Ergebnis der Funktion abgeschnitten, d. h. aus 1,9 Jahren wird 1 Jahr. Im Unterschied zu den Funktionen zur Bestimmung der Länge eines Zeitraums in den Zeiteinheiten Stunde, Minute, Sekunde und Millisekunde gibt years einen Wert ungleich 0 zurück, sobald from und to in unterschiedliche Jahre fallen. So gibt years(addSeconds(createTimestamp(1980), -1), createTimestamp(1980))1 und hours(addSeconds(createTimestamp(1980), -1), createTimestamp(1980))0 zurück. Dieses Verhalten ist mit der variablen Länge der Monate sowie den Regelungen zu Sommerzeit, Schaltjahr und Schaltsekunde begründet.
Fehlerquellen Keine
Beispiele years(today(), addDays(today(), 100)) gibt 0 zurück, falls mehr als hundert Tage bis zum nächsten Jahreswechsel verbleiben.

years(addDays(today(), -100), today()) gibt 0 zurück, falls noch keine hundert Tage seit dem Jahresanfang vergangen sind.
Kontext ALL
Hinweise Sind from und to vom Datentyp CisDate, so werden sie für die Berechnung in die Zeitzone GMT+0 umgerechnet. years(createCisDate("NST", 1980), createCisDate("NPT1", 1980))gibt daher -1 zurück, da sich die Zeitzone NST westlich und die Zeitzone NPT1 östlich von GMT+0 befindet. Somit fällt das CisDate to auf den letzten Tag im Jahr 1979 von der Zeitzone GMT+0 aus betrachtet.
Siehe auch days, hours, milliseconds, minutes, months, seconds, weeks

Folgendes Beispiel aus der Aktivitätsdefinition help.years bestimmt mithilfe des Geburtsdatums das Alter einer Person in Jahren:

function create()
{
var p_dateOfBirth := parameters.DATE_OF_BIRTH;
var p_now := now();

result.VALUE := years(p_dateOfBirth, p_now);
}

Czy ten artykuł był pomocny?

Wyślij opnie