Project-Funktionen für benutzerdefinierte Felder in Project Desktop

Diese Funktionen werden innerhalb von Formeln zum Berechnen der Werte für benutzerdefinierte Felder verwendet.

Übersicht über Project-Funktionen

Bei der Verwendung von Microsoft Project müssen Sie möglicherweise mit Werten arbeiten, die sich nicht direkt im jeweiligen Feld befinden. Mithilfe von Formeln können Sie mit Feldern arbeiten, um diese neuen Werte zu erstellen.

Die folgenden Beispiele verdeutlichen, wie Formeln für benutzerdefinierte Felder verwendet werden können:

• Wird die folgende Formel in ein benutzerdefiniertes Zahlenfeld eingegeben, wird ein numerischer Wert zurückgegeben, der die Anzahl von Tagen zwischen dem aktuellen Datum und dem Endtermin der Vorgänge in Ihrem Terminplan angibt:

DateDiff("d",NOW(),[Finish])

• Wird die folgende Formel einem benutzerdefinierten Textfeld hinzugefügt, wird einer der Werte "Kein Basisplan", "Kostenrahmen um 20 % oder mehr überschritten" oder "Kostenrahmen unterschritten" zurückgegeben:

  Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
   The CStr function in the above formula works only if the [Baseline Finish] field is defined.
  

Konvertierungsfunktionen

Asc

Gibt einen Wert des Typs Integer zurück, der den Zeichencode darstellt, der dem ersten Buchstaben in einer Zeichenfolge entspricht.

Syntax

Asc(Zeichenfolge)

Zeichenfolge  Ein beliebiger gültiger Zeichenfolgenausdruck.

CBool

Erzwingt einen Ausdruck des Datentyps Boolean.

Syntax

CBool(Ausdruck)

Ausdruck  Beliebiger gültiger Zeichenfolgen- (string) oder numerischer Ausdruck.

CByte

Erzwingt einen Ausdruck des Datentyps Byte.

Syntax

CByte(Ausdruck)

Ausdruck  Beliebige ganze Zahl zwischen 0 und 255.

CCur

Erzwingt einen Ausdruck des Datentyps Currency.

Syntax

CCur(Ausdruck)

Ausdruck  Ein beliebiger numerischer Ausdruck von -922.337.203.685.477.5808 bis 922.337.203.685.477.5807.

CDate

Erzwingt einen Ausdruck des Datentyps Date.

Syntax

CDate(Ausdruck)

Ausdruck  Beliebiger gültiger Datumsausdruck.

CDbl

Erzwingt einen Ausdruck des Datentyps Double.

Syntax

CDbl(Ausdruck)

Ausdruck  Beliebiger numerischer Ausdruck von -1,79769313486232E308 bis -4,94065645841247E-324 für negative Werte; 4,94065645841247E-324 bis 1,79769313486232E308 für positive Werte.

CDec

Erzwingt einen Ausdruck des Datentyps Decimal.

Syntax

CDec(Ausdruck)

Ausdruck  Ein beliebiger numerischer Ausdruck von +/-79,228,162,514,264,337,593,543,950,335 für Zahlen ohne Dezimalstellen. Bei Zahlen mit 28 Dezimalstellen ist der Bereich +/-7,92281625142643375935439503335. Die kleinstmögliche Zahl mit Dezimalstellen ist 0,0000000000000000000000000001.

Chr

Gibt eine Zeichenfolge zurück, die das Zeichen enthält, das dem angegebenen Zeichencode zugeordnet ist.

Syntax

Chr(Zeichencode)

Charcode  Ein Long-Wert , der ein Zeichen identifiziert.

CInt

Erzwingt einen Ausdruck des Datentyps Integer.

Syntax

CInt(Ausdruck)

Ausdruck  Beliebiger numerischer Ausdruck von -32.768 bis 32.767; Bruchzahlen werden gerundet.

CLng

Erzwingt einen Ausdruck des Datentyps Long.

Syntax

CLng(Ausdruck)

Ausdruck  Beliebiger numerischer Ausdruck von -2.147.483.648 bis 2.147.483.647; Bruchzahlen werden gerundet.

CSng

Erzwingt einen Ausdruck des Datentyps Single.

Syntax

CSng(Ausdruck)

Ausdruck  Beliebiger numerischer Ausdruck -3,402823E38 bis -1,401298E-45 für negative Werte; 1,401298E-45 bis 3,402823E38 für positive Werte.

CStr

Erzwingt einen Ausdruck des Datentyps String.

Syntax

CStr(Ausdruck)

Ausdruck  Beliebiger gültiger Zeichenfolgen- (string) oder numerischer Ausdruck.

CVar

Erzwingt einen Ausdruck des Datentyps Variant.

Syntax

CVar(Ausdruck)

Ausdruck  Derselbe Bereich wie für den Datentyp Double für numerische Werte. Derselbe Bereich wie für den Datentyp String für nicht numerische Werte.

DateSerial

Gibt einen Wert des Typs Variant (Date) für ein angegebenes Jahr, einen Monat und einen Tag zurück.

Syntax

DateSerial(Jahr; Monat; Tag)

Jahr  Erforderlich; Ganze Zahl. Zahl zwischen 100 und 9999 (einschließlich) oder ein numerischer Ausdruck.

Monat  Erforderlich; Ganze Zahl. Ein beliebiger numerischer Ausdruck.

Tag  Erforderlich; Ganze Zahl. Ein beliebiger numerischer Ausdruck.

DateValue

Gibt einen Wert des Typs Variant (Date) zurück.

Syntax

DateValue(Datum)

Datum  Erforderlich; normalerweise ein Zeichenfolgenausdruck, der ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. Date kann jedoch auch ein beliebiger Ausdruck sein, der ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit in diesem Bereich darstellen kann.

Day

Gibt einen Wert des Typs Variant (Integer) zurück, der eine Ganzzahl zwischen 1 und 31 (einschließlich) als Tag des Monats darstellt.

Syntax

Day(Datum)

Datum  Erforderlich; beliebiger Variant-, numerischer Ausdrucks- oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

Hex

Gibt einen Wert des Typs String zurück, der einen Hexadezimalwert einer Zahl darstellt.

Syntax

Hex(Zahl)

Zahl  Erforderlich; alle gültigen Zeichenfolgen oder numerischen Ausdrücke.

Hour

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 23 (einschließlich) angibt, die die Stunde des Tages darstellt.

Syntax

Hour(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Minute

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 59 (einschließlich) angibt und die Minute der Stunde darstellt.

Syntax

Minute(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Month

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 1 und 12 (einschließlich) angibt, die den Monat eines Jahres darstellt.

Syntax

Month(Datum)

Datum  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Wenn dateNull enthält, wird Null zurückgegeben.

Oct

Gibt einen Wert des Typs Variant (String) zurück, der den Oktalwert einer Zahl darstellt.

Syntax

Oct(Zahl)

Zahl  Erforderlich; alle gültigen Zeichenfolgen oder numerischen Ausdrücke.

ProjDateConv

Konvertiert einen Wert in ein Datum.

Syntax

ProjDateConv(Ausdruck; Datumsformat)

Ausdruck  Erforderlich; Variante. Der Ausdruck, der in ein Datum konvertiert werden soll.

Dateformat  Optional; Lang. Das Datumsformat ist standardmäßig pjDateDefault, aber Sie können eine der folgenden pjDateFormat-Konstanten ersetzen (Datumsformat angewendet 25.09.07 um 12:33 Uhr):

• pjDateDefault: Das Standardformat. Wird im Dialogfeld Optionen auf der Registerkarte Ansicht (im Menü Extras) festgelegt.

• pjDate_dd_mm_yy_hh_mm: 25.09.07 12:33

• pjDate_dd_mm_yy: 25.09.07

• pjDate_dd_mm_yyyy: 25.09.2007

• pjDate_dd_mmmm_yyyy_hh_mm: 25. September 2007 12:33

• pjDate_dd_mmmm_yyyy: 25. September 2007

• pjDate_dd_mmm_hh_mm: 25. Sep 12:33

• pjDate_dd_mmm_yyy: 25. Sep '07

• pjDate_dd_mmmm: 25. September

• pjDate_dd_mmm: 25. Sep 25

• pjDate_ddd_dd_mm_yy_hh_mm: Di 25.9.07 12:33

• pjDate_ddd_dd_mm_yy: Di 25.09.07

• pjDate_ddd_dd_mmm_yyy: Di 25. Sep '07

• pjDate_ddd_hh_mm: Di 12:33

• pjDate_dd_mm: 25.09

• pjDate_dd: 25

• pjDate_hh_mm: 12:33

• pjDate_ddd_dd_mmm: Di 25. Sep

• pjDate_ddd_dd_mm: Di 25.09.

• pjDate_ddd_dd: Di 25

• pjDate_Www_dd: 39.KW/2

• pjDate_Www_dd_yy_hh_mm: 39.KW/2/07 12:33

ProjDurConv

Konvertiert einen Ausdruck in einen Wert für die Dauer in den angegebenen Einheiten.

Syntax

ProjDurConv(Ausdruck, EinheitenDerDauer)

Ausdruck  Erforderlich; Variante. Der Ausdruck, der in eine Dauer konvertiert werden soll.

durationunits  Optional; Lang. Die Einheiten, die zum Ausdrücken der Dauer verwendet werden. Wenn durationunits nicht angegeben ist, ist der Standardwert der Typ der Einheiten, die in der Option Dauer wird eingegeben in auf der Registerkarte Zeitplan des Dialogfelds Optionen (Menü Extras ) angegeben ist. Die durationunits können eine der folgenden pjFormatUnit-Konstanten sein:

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

Second

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 59 (einschließlich) angibt und die Sekunde der Minute darstellt.

Syntax

Second(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Str

Gibt einen Wert des Typs Variant (String) zurück, der eine Zahl darstellt.

Syntax

Str(Zahl)

Zahl  Erforderlich; Long mit einem gültigen numerischen Ausdruck.

StrConv

Gibt einen Wert des Typs Variant (String) zurück, der wie angegeben konvertiert wird.

Syntax

StrConv(Zeichenfolge; Konvertierung; LCID)

Zeichenfolge  Erforderlich; Zeichenfolgenausdruck, der konvertiert werden soll.

Konvertierung  Erforderlich; Ganze Zahl. Die Summe der Werte, die den auszuführenden Konvertierungstyp angeben.

LCID  Optional; Die LocaleID, wenn sie von der LocaleID des Systems abweicht. (Standardmäßig wird das Gebietsschema des Systems verwendet.)

TimeSerial

Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit für eine bestimmte Stunde, Minute und Sekunde enthält.

Syntax

TimeSerial(Stunde; Minute; Sekunde)

Stunde  Erforderlich; Variant (Integer). Zahl zwischen 0 (12:00 Uhr) und 23 (23:00 Uhr), einschließlich, oder ein numerischer Ausdruck.

Minute  Erforderlich; Variant (Integer). Ein beliebiger numerischer Ausdruck.

Sekunde  Erforderlich; Variant (Integer). Ein beliebiger numerischer Ausdruck.

TimeValue

Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit enthält.

Syntax

TimeValue(Zeit)

Zeit  Erforderlich; normalerweise ein Zeichenfolgenausdruck, der eine Zeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 (23:59:59 Uhr) darstellt. Time kann jedoch auch ein beliebiger Ausdruck sein, der eine Zeit in diesem Bereich darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Val

Gibt die Zahlen zurück, die in einer Zeichenfolge als numerischer Wert des entsprechenden Typs enthalten sind.

Syntax

Val(Zeichenfolge)

Zeichenfolge  Erforderlich; jeder gültige Zeichenfolgenausdruck.

Weekday

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die den Tag der Woche darstellt.

Syntax

Weekday(Datum; [ErsterTagDerWoche])

Datum  Erforderlich; Variant, numerischer Ausdruck, Zeichenfolgenausdruck einer beliebigen Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

ErsterTagDerWoche  Optional; eine Konstante, die den ersten Tag der Woche angibt. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt.

Year

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die das Jahr darstellt.

Syntax

Year(Datum)

Datum  Erforderlich; beliebiger Variant-, numerischer Ausdrucks- oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

Funktionen für Datum/Uhrzeit

CDate

Erzwingt einen Ausdruck des Datentyps Date.

Syntax

CDate(Ausdruck)

Ausdruck  Beliebiger gültiger Datumsausdruck.

Date

Gibt einen Wert des Typs Variant (Date) zurück, der das aktuelle Systemdatum enthält.

Syntax

Date

DateAdd

Gibt einen Wert des Typs Variant (Date) mit einem Datum zurück, dem ein angegebenes Zeitintervall hinzugefügt wurde.

Syntax

DateAdd(Intervall; Zahl; Datum)

Intervall  Erforderlich; Zeichenfolgenausdruck, der dem Zeitintervall entspricht, das Sie hinzufügen möchten, z. B. "m" oder "d".

Zahl  Erforderlich; numerischer Ausdruck, der die Anzahl der hinzuzufügenden Intervalle darstellt. Er kann positiv (zum Abrufen von Datumswerten in der Zukunft) oder negativ (zum Abrufen von Datumswerten in der Vergangenheit) sein.

Datum  Erforderlich; Variant (Date) oder Literal, das das Datum darstellt, zu dem das Intervall hinzugefügt wird.

DateDiff

Gibt einen Wert des Typs Variant (Long) zurück, der die Anzahl der Zeitintervalle zwischen zwei angegebenen Datumswerten angibt.

Syntax

DateDiff(Intervall; Datum1; Datum2; [ErsterTagDerWoche; [ErsteWocheDesJahres]])

Intervall  Erforderlich; Zeichenfolgenausdruck, der das Zeitintervall darstellt, das Sie zum Berechnen der Differenz zwischen date1 und date2 verwenden.

date1, date2  Erforderlich; Variant (Date). Zwei Datumsangaben, die Sie in der Berechnung verwenden möchten.

ErsterTagDerWoche  Optional; eine Konstante, die den ersten Tag der Woche angibt. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt.

ErsteWocheDesJahres  Optional; eine Konstante, die die erste Woche des Jahres angibt. Wenn nicht angegeben, wird davon ausgegangen, dass die erste Woche die Woche ist, in der der 1. Januar stattfindet.

DatePart

Gibt einen Wert des Typs Variant (Integer) zurück, der den angegebenen Teil eines bestimmten Datums enthält.

Syntax

DatePart(Intervall; Datum; [ErsterTagDerWoche; [ErsteWocheDesJahres]])

Intervall  Erforderlich; Zeichenfolgenausdruck, der das Zeitintervall ist, das Sie zurückgeben möchten.

Datum  Erforderlich; Variant (Date)-Wert, den Sie auswerten möchten.

ErsterTagDerWoche  Optional; eine Konstante, die den ersten Tag der Woche angibt. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt.

ErsteWocheDesJahres  Optional; eine Konstante, die die erste Woche des Jahres angibt. Wenn nicht angegeben, wird davon ausgegangen, dass die erste Woche in der Woche liegt, in der der 1. Januar eintritt.

DateSerial

Gibt einen Wert des Typs Variant (Date) für ein angegebenes Jahr, einen Monat und einen Tag zurück.

Syntax

DateSerial(Jahr; Monat; Tag)

Jahr  Erforderlich; Ganze Zahl. Zahl zwischen 100 und 9999 (einschließlich) oder ein numerischer Ausdruck.

Monat  Erforderlich; Ganze Zahl. Ein beliebiger numerischer Ausdruck.

Tag  Erforderlich; Ganze Zahl. Ein beliebiger numerischer Ausdruck.

DateValue

Gibt einen Wert des Typs Variant (Date) zurück.

Syntax

DateValue(Datum)

Datum  Erforderlich; normalerweise ein Zeichenfolgenausdruck, der ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. Date kann jedoch auch ein beliebiger Ausdruck sein, der ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit in diesem Bereich darstellen kann.

Day

Gibt einen Wert des Typs Variant (Integer) zurück, der eine Ganzzahl zwischen 1 und 31 (einschließlich) als Tag des Monats darstellt.

Syntax

Day(Datum)

Datum  Erforderlich; beliebiger Variant-, numerischer Ausdrucks- oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

Hour

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 23 (einschließlich) angibt, die die Stunde des Tages darstellt.

Syntax

Hour(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

IsDate

Gibt einen Wert des Typs Boolean zurück, der angibt, ob ein Ausdruck in ein Datum umgewandelt werden kann.

Syntax

IsDate(Ausdruck)

Ausdruck  Erforderlich; jeder Variant-Wert , der einen Datums- oder Zeichenfolgenausdruck enthält, der als Datum oder Uhrzeit erkennbar ist.

Minute

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 59 (einschließlich) angibt und die Minute der Stunde darstellt.

Syntax

Minute(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Month

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 1 und 12 (einschließlich) angibt, die den Monat eines Jahres darstellt.

Syntax

Month(Datum)

Datum  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Wenn dateNull enthält, wird Null zurückgegeben.

Now

Gibt einen Wert des Typs Variant (Date) zurück, der das aktuelle Datum und die aktuelle Uhrzeit nach dem Systemdatum und der Systemzeit des Computers angibt.

Syntax

Now

ProjDateAdd

Fügt einem Datum eine Dauer hinzu, um ein neues Datum zurückzugeben.

Syntax

ProjDateAdd(Datum; "Dauer"; "Kalender")

Datum  Erforderlich; Variante. Das ursprüngliche Datum, zu dem die Dauer hinzugefügt wird.

Dauer  Erforderlich; Variante. Die Dauer, die dem Datum hinzugefügt werden soll.

Kalender  Kalender, der beim Berechnen des neuen Datum verwendet werden soll. Wird der Kalender nicht angegeben, wird standardmäßig für die aktuelle Ressource der Ressourcenkalender oder für den aktuellen Vorgang der Vorgangskalender bzw. der Standardkalender verwendet, wenn es keinen Vorgangskalender gibt. Bei Project Server wird immer der Standardkalender verwendet, und zwar ungeachtet des Kalenders, der in der Zeichenfolge Kalender angegeben ist. Wenn Sie diese Funktion in einer in Project Web App erstellten Formel verwenden und diese mit derselben Formel vergleichen, die in Project Professional erstellt wurde, sollten Sie sich anhand von Tests vergewissern, dass Sie die gewünschten Ergebnisse erzielen.

ProjDateConv

Konvertiert einen Wert in ein Datum.

Syntax

ProjDateConv(Ausdruck; Datumsformat)

Ausdruck  Erforderlich; Variante. Der Ausdruck, der in ein Datum konvertiert werden soll.

Dateformat  Optional; Lang. Das Datumsformat ist standardmäßig pjDateDefault, aber Sie können eine der folgenden pjDateFormat-Konstanten ersetzen (Datumsformat angewendet 25.09.07 um 12:33 Uhr):

• pjDateDefault: Das Standardformat. Wird im Dialogfeld Optionen auf der Registerkarte Ansicht (im Menü Extras) festgelegt.

• pjDate_dd_mm_yy_hh_mm: 25.09.07 12:33

• pjDate_dd_mm_yy: 25.09.07

• pjDate_dd_mm_yyyy: 25.09.2007

• pjDate_dd_mmmm_yyyy_hh_mm: 25. September 2007 12:33

• pjDate_dd_mmmm_yyyy: 25. September 2007

• pjDate_dd_mmm_hh_mm: 25. Sep 12:33

• pjDate_dd_mmm_yyy: 25. Sep '07

• pjDate_dd_mmmm: 25. September

• pjDate_dd_mmm: 25. Sep 25

• pjDate_ddd_dd_mm_yy_hh_mm: Di 25.9.07 12:33

• pjDate_ddd_dd_mm_yy: Di 25.09.03

• pjDate_ddd_dd_mmm_yyy: Di 25. Sep '07

• pjDate_ddd_hh_mm: Di 12:33

• pjDate_dd_mm: 25.09

• pjDate_dd: 25

• pjDate_hh_mm: 12:33

• pjDate_ddd_dd_mmm: Di 25. Sep

• pjDate_ddd_dd_mm: Di 25.09.

• pjDate_ddd_dd: Di 25

• pjDate_Www_dd: 39.KW/2

• pjDate_Www_dd_yy_hh_mm: 39.KW/2/07 12:33

ProjDateDiff

Gibt die Dauer zwischen zwei Datumswerten in Minuten zurück.

Syntax

ProjDateDiff(Datum1; Datum2; Kalender)

date1  Erforderlich; Variante. Das Datum, das als Anfang der Dauer verwendet wird.

date2  Erforderlich; Variante. Das Datum, das als Ende der Dauer verwendet wird.

Kalender  Kalender, der beim Berechnen der Datumsdifferenz verwendet werden soll. Der Kalender, der bei der Berechnung der Dauer verwendet werden soll. Wenn kalender nicht angegeben ist, ist der Standard für die aktuelle Ressource der Ressourcenkalender oder für den aktuellen Vorgang, der Vorgangskalender (oder der Standardkalender, wenn kein Vorgangskalender für Project Server vorhanden ist, wird der Standardkalender verwendet, unabhängig davon, welcher Kalender in der Kalenderzeichenfolge angegeben ist. Wenn Sie diese Funktion in einer in Project Web App erstellten Formel verwenden und diese mit derselben Formel vergleichen, die in Project Professional erstellt wurde, sollten Sie sich anhand von Tests vergewissern, dass Sie die gewünschten Ergebnisse erzielen.

ProjDateSub

Gibt das Datum zurück, das um eine bestimmte Dauer vor einem anderen Datum liegt.

Syntax

ProjDateSub(Datum; Dauer; Kalender)

Datum  Erforderlich; Variante. Das ursprüngliche Datum, von dem die Dauer subtrahiert wird.

Dauer  Erforderlich; Variante. Die Dauer, die vom Datum subtrahiert werden soll.

Kalender  Kalender, der beim Berechnen der Datumsdifferenz verwendet werden soll. Wird der Kalender nicht angegeben, wird standardmäßig für die aktuelle Ressource der Ressourcenkalender oder für den aktuellen Vorgang der Vorgangskalender bzw. der Standardkalender verwendet, wenn es keinen Vorgangskalender gibt. Bei Project Server wird immer der Standardkalender verwendet, und zwar ungeachtet des Kalenders, der in der Zeichenfolge Kalender angegeben ist. Wenn Sie diese Funktion in einer in Project Web App erstellten Formel verwenden und diese mit derselben Formel vergleichen, die in Project Professional erstellt wurde, sollten Sie sich anhand von Tests vergewissern, dass Sie die gewünschten Ergebnisse erzielen.

ProjDateValue

Gibt den Datumswert eines Ausdrucks zurück.

Syntax

ProjDateValue(Ausdruck)

Ausdruck  Erforderlich; Variante. Der Ausdruck, der als Datum dargestellt werden soll.

ProjDurConv

Konvertiert einen Ausdruck in einen Wert für die Dauer in den angegebenen Einheiten.

Syntax

ProjDurConv(Ausdruck, EinheitenDerDauer)

Ausdruck  Erforderlich; Variante. Der Ausdruck, der in eine Dauer konvertiert werden soll.

durationunits  Optional; Lang. Die Einheiten, die zum Ausdrücken der Dauer verwendet werden. Wenn durationunits nicht angegeben ist, ist der Standardwert der Typ der Einheiten, die in der Option Dauer wird eingegeben in auf der Registerkarte Zeitplan des Dialogfelds Optionen (Menü Extras ) angegeben ist. Die durationunits können eine der folgenden pjFormatUnit-Konstanten sein:

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Gibt die Anzahl der Minuten in einer Dauer zurück.

Syntax

ProjDurValue(Dauer)

Dauer  Erforderlich; Variante. Die Dauer, die in Minuten ausgedrückt werden soll.

Second

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl zwischen 0 und 59 (einschließlich) angibt und die Sekunde der Minute darstellt.

Syntax

Second(Zeit)

Zeit  Erforderlich; beliebiger Wert des Typs Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder beliebige Kombination, der/die eine Uhrzeit darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Time

Gibt einen Wert des Typs Variant (Date) zurück, der die aktuelle Systemzeit angibt.

Syntax

Time

Timer

Gibt einen Wert des Typs Single zurück, der die Anzahl der Sekunden darstellt, die seit Mitternacht verstrichen sind.

Syntax

Timer

TimeSerial

Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit für eine bestimmte Stunde, Minute und Sekunde enthält.

Syntax

TimeSerial(Stunde; Minute; Sekunde)

Stunde  Erforderlich; Variant (Integer). Zahl zwischen 0 (12:00 Uhr) und 23 (23:00 Uhr), einschließlich, oder ein numerischer Ausdruck.

Minute  Erforderlich; Variant (Integer). Ein beliebiger numerischer Ausdruck.

Sekunde  Erforderlich; Variant (Integer). Ein beliebiger numerischer Ausdruck.

TimeValue

Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit enthält.

Syntax

TimeValue(Zeit)

Zeit  Erforderlich; normalerweise ein Zeichenfolgenausdruck, der eine Zeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 (23:59:59 Uhr) darstellt. Time kann jedoch auch ein beliebiger Ausdruck sein, der eine Zeit in diesem Bereich darstellt. Enthält die Zeit den Wert Null, wird Null zurückgegeben.

Weekday

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die den Tag der Woche darstellt.

Syntax

Weekday(Datum; [ErsterTagDerWoche])

Datum  Erforderlich; Variant, numerischer Ausdruck, Zeichenfolgenausdruck einer beliebigen Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

ErsterTagDerWoche  Optional; eine Konstante, die den ersten Tag der Woche angibt. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt.

Year

Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die das Jahr darstellt.

Syntax

Year(Datum)

Datum  Erforderlich; beliebiger Variant-, numerischer Ausdrucks- oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn dateNull enthält, wird Null zurückgegeben.

Allgemeine Funktionen

Choose

Wählt einen Wert aus einer Liste mit Argumenten aus und gibt ihn zurück.

Syntax

Choose(Index; Ausdruck1; [Ausdruck2; ... ; [Ausdruck-n]])

Index  Erforderlich; numerischer Ausdruck oder Feld, der zu einem Wert zwischen 1 und der Anzahl der verfügbaren Optionen führt.

Wahl  Erforderlich; Variant-Ausdruck , der eine der möglichen Optionen enthält.

IIf

Gibt in Abhängigkeit von der Auswertung eines Ausdrucks einen von zwei Teilen zurück.

Syntax

IIf(Ausdruck; True-Teil; False-Teil)

Ausdruck  Erforderlich; Variant-Ausdruck , den Sie auswerten möchten.

True-Teil  Erforderlich; Wert oder Ausdruck, der zurückgegeben werden soll, wenn der entsprechende Ausdruck True ist.

False-Teil  Erforderlich; Wert oder Ausdruck, der zurückgegeben werden soll, wenn der entsprechende AusdruckFalse ist.

IsNumeric

Gibt einen Wert des Typs Boolean zurück, der angibt, ob ein Ausdruck als Zahl ausgewertet werden kann.

Syntax

IsNumeric(Ausdruck)

Ausdruck  Erforderlich; Variante , die einen numerischen Ausdruck oder einen Zeichenfolgenausdruck enthält.

IsNull

Gibt einen Wert vom Typ Boolean zurück, der angibt, dass ein Ausdruck keine gültigen Daten (Null) enthält.

Syntax

IsNull(Ausdruck)

Ausdruck  Erforderlich; Variante , die einen numerischen Ausdruck oder einen Zeichenfolgenausdruck enthält.

Switch

Wertet eine Liste von Ausdrücken aus und gibt einen Wert des Typs Variant oder einen Ausdruck zurück, der dem ersten Ausdruck in der Liste zugeordnet ist, für den True gilt.

Syntax

Switch(Ausdruck1; Wert1; [Ausdruck2; Wert2; ... ; [Ausdruck-n;Wert-n]])

Mathematische Funktionen

Abs

Gibt einen Wert desselben Typs zurück, der zum Angeben des absoluten Werts einer Zahl weitergegeben wird.

Syntax

Abs(Zahl)

Zahl  Erforderlich; ein gültiger numerischer Ausdruck. Wenn numberNull enthält, wird Null zurückgegeben. Wenn es sich um eine nicht initialisierte Variable handelt, wird null zurückgegeben.

Atn

Gibt einen Wert des Typs Double zurück, der den Arkustangens einer Zahl angibt.

Syntax

Atn(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck.

Cos

Gibt einen Wert des Typs Double zurück, der den Kosinus eines Winkels angibt.

Syntax

Cos(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck, der einen Winkel im Bogenmaß ausdrückt.

Exp

Gibt einen Wert des Typs Double zurück, der eine Potenz von e (die Grundlage natürlicher Logarithmen) angibt.

Syntax

Exp(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck.

Fix

Gibt den ganzzahligen Anteil einer Zahl zurück. Ist die Zahl negativ, wird die erste negative Ganzzahl zurückgegeben, die gleich oder größer als die Zahl ist.

Syntax

Fix(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck. Wenn numberNull enthält, wird Null zurückgegeben.

Int

Gibt den ganzzahligen Anteil einer Zahl zurück. Ist die Zahl negativ, wird die erste negative Ganzzahl zurückgegeben, die kleiner oder gleich der Zahl ist.

Syntax

Int(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck. Wenn numberNull enthält, wird Null zurückgegeben.

Log

Gibt einen Wert des Typs Double zurück, der den natürlichen Logarithmus einer Zahl angibt.

Syntax

Log(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck größer als 0 (null).

Rnd

Gibt einen Wert des Typs Single zurück, der eine Zufallszahl enthält.

Syntax

Rnd(Zahl)

Zahl  Erforderlich; Einzelner oder ein beliebiger gültiger numerischer Ausdruck.

Sgn

Gibt einen Wert des Typs Variant (Integer) zurück, der das Vorzeichen einer Zahl angibt.

Syntax

Sgn(Zahl)

Zahl  Erforderlich; ein gültiger numerischer Ausdruck.

Folgende Werte werden zurückgegeben:

• Zahl größer als Null: "Sgn" gibt 1 zurück.

• Zahl gleich Null: "Sgn" gibt 0 zurück.

• Zahl kleiner als Null: "Sgn" gibt -1 zurück.

Sin

Gibt einen Wert des Typs Double zurück, der den Sinus eines Winkels angibt.

Syntax

Sin(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck, der einen Winkel im Bogenmaß ausdrückt.

Sqr

Gibt einen Wert des Typs Double zurück, der die Quadratwurzel einer Zahl angibt.

Syntax

Sqr(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck gleich oder größer als 0 (null).

Tan

Gibt einen Wert des Typs Double zurück, der den Tangens eines Winkels angibt.

Syntax

Tan(Zahl)

Zahl  Erforderlich; Double oder ein beliebiger gültiger numerischer Ausdruck, der einen Winkel im Bogenmaß ausdrückt.

Textfunktionen

Asc

Gibt einen Wert des Typs Integer zurück, der den Zeichencode darstellt, der dem ersten Buchstaben in einer Zeichenfolge entspricht.

Syntax

Asc(Zeichenfolge)

Schnur  Ein beliebiger gültiger Zeichenfolgenausdruck.

Chr

Gibt eine Zeichenfolge zurück, die das Zeichen enthält, das dem angegebenen Zeichencode zugeordnet ist.

Syntax

Chr(Zeichencode)

Charcode  Ein Long-Wert , der ein Zeichen identifiziert.

Format

Gibt einen Wert des Typs Variant (String) zurück, der einen Ausdruck enthält, der entsprechend der in einem Formatausdruck enthaltenen Anweisungen formatiert ist.

Syntax

Format(Ausdruck; [Format; [ErsterTagDerWoche; [ErsteWocheDesJahres]]])

Ausdruck  Erforderlich; ein beliebiger gültiger Ausdruck.

Format  Optional; ein gültiger benannter oder benutzerdefinierter Formatausdruck.

ErsterTagDerWoche  Optional; eine Konstante , die den ersten Tag der Woche angibt.

ErsteWocheDesJahres  Optional; eine Konstante , die die erste Woche des Jahres angibt.

Instr

Gibt einen Wert des Typs Variant (Long) zurück, der die Position des ersten Auftretens einer Zeichenfolge innerhalb einer anderen Zeichenfolge angibt.

Syntax

Instr([Startwert]; Zeichenfolge1; Zeichenfolge2; [Zeichenvergleich])

Starten  Optional; numerischer Ausdruck, der die Anfangsposition für jede Suche festlegt. Fehlt dieses Argument, beginnt die Suche an der ersten Zeichenposition. Wenn startNull enthält, tritt ein Fehler auf. Das Argument Anfang ist erforderlich, wenn Vergleich angegeben ist.

Zeichenfolge1  Erforderlich; Zeichenfolgenausdruck, der durchsucht wird.

Zeichenfolge2  Erforderlich; Zeichenfolgenausdruck, der gesucht wird.

Vergleich  Optional; gibt den Typ des Zeichenfolgenvergleichs an. Enthält Vergleich den Nullwert, tritt ein Fehler auf. Wenn vergleich nicht angegeben wird, bestimmt die Einstellung Vergleichsoption den Vergleichstyp.

LCase

Gibt eine Zeichenfolge zurück, die in Kleinbuchstaben konvertiert wurde.

Syntax

LCase(Zeichenfolge)

Zeichenfolge   Erforderlich; jeder gültige Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.

Left

Gibt einen Wert des Typs Variant (String) zurück, der ausgehend von der linken Seite einer Zeichenfolge eine angegebene Anzahl von Zeichen enthält.

Syntax

Left(Zeichenfolge; Länge)

Zeichenfolge  Erforderlich. Zeichenfolgenausdruck, für den die ganz linken Zeichen zurückgegeben werden. Wenn stringNull enthält, wird Null zurückgegeben.

Länge  Erforderlich; Variant (Long). Numerischer Ausdruck, der angibt, wie viele Zeichen zurückgegeben werden sollen. Ist dieses Argument gleich 0, wird eine Zeichenfolge der Länge Null ("") zurückgegeben. Ist der Wert des Arguments größer gleich der Anzahl von Zeichen in string, wird die gesamte Zeichenfolge zurückgegeben.

Len

Gibt einen Wert des Typs Long zurück, der die Anzahl der Zeichen in einer Zeichenfolge oder die Anzahl von Bytes enthält, die erforderlich sind, um eine Variable zu speichern.

Syntax

Len(Zeichenfolge; Variablenname)

Zeichenfolge  Ein beliebiger gültiger Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.

Variablenname  Jeder gültige Variablenname. Wenn varnameNull enthält, wird Null zurückgegeben. Wenn varname ein Variant-Wert ist, behandelt Len es wie eine Zeichenfolge und gibt immer die Anzahl der darin enthaltenen Zeichen zurück.

LTrim

Gibt einen Wert des Typs Variant (String) zurück, der eine Kopie einer angegebenen Zeichenfolge ohne führende Leerzeichen enthält.

Syntax

LTrim(Zeichenfolge)

Zeichenfolge  Erforderlich; jeder gültige Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.

Mid

Gibt einen Wert des Typs Variant (String) zurück, der eine bestimme Zeichenanzahl aus einer Zeichenfolge enthält.

Syntax

Mid(Zeichenfolge; Startwert; [Länge])

Zeichenfolge  Erforderlich; Zeichenfolgenausdruck, von dem Zeichen zurückgegeben werden. Wenn stringNull enthält, wird Null zurückgegeben.

Starten  Erforderlich; Lang. Zeichenposition in der Zeichenfolge , an der der zu belegtde Teil beginnt. Wenn start größer als die Anzahl der Zeichen in der Zeichenfolge ist, gibt Mid eine leere Zeichenfolge ("") zurück.

Länge  Optional; Variant (Long). Anzahl der zurückzugebenden Zeichen. Wird kein Wert angegeben oder enthält der Text weniger Zeichen als für die Länge angegeben (einschließlich des Zeichens als Startwert), werden alle Zeichen von der Position des Startwerts bis zum Ende der Zeichenfolge zurückgegeben.

Right

Gibt einen Wert des Typs Variant (String) zurück, der ausgehend von der rechten Seite einer Zeichenfolge eine angegebene Anzahl von Zeichen enthält.

Syntax

Right(Zeichenfolge; Länge)

Zeichenfolge  Erforderlich; Zeichenfolgenausdruck, von dem die am weitesten rechts stehenden Zeichen zurückgegeben werden. Wenn stringNull enthält, wird Null zurückgegeben.

Länge  Erforderlich; Variant (Long). Numerischer Ausdruck, der angibt, wie viele Zeichen zurückgegeben werden sollen. Ist dieses Argument gleich 0, wird eine Zeichenfolge der Länge Null ("") zurückgegeben. Wenn gleich oder größer als die Anzahl der Zeichen in der Zeichenfolge ist, wird die gesamte Zeichenfolge zurückgegeben.

RTrim

Gibt einen Wert des Typs Variant (String) zurück, der eine Kopie einer angegebenen Zeichenfolge ohne nachgestellte Leerzeichen enthält.

Syntax

RTrim(Zeichenfolge)

Zeichenfolge  Erforderlich; jeder gültige Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.

Space

Gibt einen Wert des Typs Variant (String) zurück, der aus der angegebenen Anzahl von Leerzeichen besteht.

Syntax

Space(Zahl)

Zahl  Erforderlich; Anzahl der Leerzeichen, die in der Zeichenfolge enthalten sein sollen.

StrComp

Gibt einen Wert des Typs Variant (Integer) zurück, der das Ergebnis eines Zeichenvergleichs angibt.

Syntax

StrComp(Zeichenfolge1; Zeichenfolge2; [Zeichenvergleich])

Zeichenfolge1  Erforderlich; jeder gültige Zeichenfolgenausdruck.

Zeichenfolge2  Erforderlich; jeder gültige Zeichenfolgenausdruck.

Vergleich  Optional; gibt den Typ des Zeichenfolgenvergleichs an. Wenn das Compare-ArgumentNull ist, tritt ein Fehler auf.

StrConv

Gibt einen Wert des Typs Variant (String) zurück, der wie angegeben konvertiert wird.

Syntax

StrConv(Zeichenfolge; Konvertierung; LCID)

Zeichenfolge  Erforderlich; Zeichenfolgenausdruck, der konvertiert werden soll.

Konvertierung  Erforderlich; Ganze Zahl. Die Summe der Werte, die den auszuführenden Konvertierungstyp angeben.

LCID  Optional; Die LocaleID, wenn sie von der LocaleID des Systems abweicht. (Standardmäßig wird das Gebietsschema des Systems verwendet.)

String

Gibt einen Wert des Typs Variant (String) zurück, der eine wiederholte Zeichenfolge der angegebenen Länge enthält.

Syntax

String(Zahl; Zeichen)

Zahl  Erforderlich; Lang. Länge der zurückgegebenen Zeichenfolge. Wenn numberNull enthält, wird Null zurückgegeben.

Zeichen  Erforderlich; Variante. Zeichencode, der den Zeichen- oder Zeichenfolgenausdruck angibt, dessen erstes Zeichen zum Erstellen der Rückgabezeichenfolge verwendet wird. Wenn zeichenNull enthält, wird Null zurückgegeben.

Trim

Gibt einen Wert des Typs Variant (String) zurück, der eine Kopie einer angegebenen Zeichenfolge ohne führende oder nachgestellte Leerzeichen enthält.

Syntax

Trim(Zeichenfolge)

Zeichenfolge  Erforderlich; jeder gültige Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.

UCase

Gibt einen Wert des Typs Variant (String) zurück, der die angegebene, in Großbuchstaben konvertierte Zeichenfolge enthält.

Syntax

UCase(Zeichenfolge)

Zeichenfolge  Erforderlich; jeder gültige Zeichenfolgenausdruck. Wenn stringNull enthält, wird Null zurückgegeben.