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  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  Eine ganze Zahl von 0 bis 255.

CCur

Erzwingt einen Ausdruck des Datentyps Currency.

Syntax

CCur(Ausdruck)

Ausdruck  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  Beliebiger numerischer Ausdruck aus +/-79.228.162.514.264.337.593.543.950.335 für Zahlen ohne Dezimalstellen. Bei Zahlen mit 28 Dezimalstellen beträgt der Bereich +/-7,9228162514264337593543950335. 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, das ein Zeichen identifiziert.

CInt

Erzwingt einen Ausdruck des Datentyps Integer.

Syntax

CInt(Ausdruck)

Ausdruck  Beliebiger numerischer Ausdruck von -32.768 bis 32.767; Brüche 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; Brüche 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; Integer. Zahl zwischen 100 und 9999(einschließlich) oder einem numerischen Ausdruck.

Monat  Erforderlich; Integer. Ein beliebiger numerischer Ausdruck.

Tag  Erforderlich; Integer. 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. Datum kann jedoch auch jeder 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; einen beliebigen Variant-,numerischen oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn DatumNull 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; eine beliebige gültige Zeichenfolge oder einen numerischen Ausdruck.

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 DatumNull 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; eine beliebige gültige Zeichenfolge oder einen numerischen Ausdruck.

ProjDateConv

Konvertiert einen Wert in ein Datum.

Syntax

ProjDateConv(Ausdruck; Datumsformat)

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

Datumsformat  Optional; Long. Die Standardeinstellung für das Datumsformat ist pjDateDefault,Sie können jedoch eine der folgenden pjDateFormat-Konstanten ersetzen (Datumsformat, das am 25.09.2007 um 12:33 Uhr angewendet wurde):

• 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; Variant. Der Ausdruck, der in eine Dauer konvertiert werden soll.

durationunits  Optional; Long. 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 in option auf der Registerkarte Zeitplan des Dialogfelds Optionen (MenüExtras) eingegebenen Einheiten 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, der einen gültigen numerischen Ausdruck enthält.

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; Integer. Die Summe der Werte, die den auszuführenden Konvertierungstyp angeben.

LCID  Optional; die LocaleID, wenn sie sich von der System-LocaleID unterscheiden. (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 einem numerischen 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 Uhrzeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 (23:59:59) darstellt. Zeit kann jedoch auch jeder Ausdruck sein, der eine Uhrzeit 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; einen beliebigen gültigen 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 DatumNull 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; einen beliebigen Variant-,numerischen oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn DatumNull 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)

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

Zahl  Erforderlich; numerischer Ausdruck, der die Anzahl der Intervalle ist, die Sie hinzufügen möchten. 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, 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]])

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

Datum1, Datum2  Erforderlich; Variant (Datum). 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 die erste Woche als die Woche angenommen, 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]])

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

Datum  Erforderlich; Wert des Werts Variant(Datum),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 sich die erste Woche in der Woche befindet, in der der 1. Januar stattfindet.

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; Integer. Zahl zwischen 100 und 9999(einschließlich) oder einem numerischen Ausdruck.

Monat  Erforderlich; Integer. Ein beliebiger numerischer Ausdruck.

Tag  Erforderlich; Integer. 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. Datum kann jedoch auch jeder 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; einen beliebigen Variant-,numerischen oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn DatumNull 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; variant, die einen Datums- oder Zeichenfolgenausdruck enthalten, 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 DatumNull 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; Variant. Das ursprüngliche Datum, dem die Dauer hinzugefügt wird.

Dauer  Erforderlich; Variant. 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; Variant. Der Ausdruck, der in ein Datum konvertiert werden soll.

Datumsformat  Optional; Long. Die Standardeinstellung für das Datumsformat ist pjDateDefault,Sie können jedoch eine der folgenden pjDateFormat-Konstanten ersetzen (Datumsformat, das am 25.09.2007 um 12:33 Uhr angewendet wurde):

• 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)

Datum1  Erforderlich; Variant. Das Datum, das als Anfang der Dauer verwendet wird.

Datum2  Erforderlich; Variant. Das Datum, das als Ende der Dauer verwendet wird.

Kalender  Kalender, der beim Berechnen der Datumsdifferenz verwendet werden soll. Der Kalender, der beim Berechnen der Dauer verwendet werden soll. Wenn kein Kalender angegeben ist, ist die Standardeinstellung für die aktuelle Ressource der Ressourcenkalender oder für den aktuellen Vorgang, den Vorgangskalender (oder den 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; Variant. Das ursprüngliche Datum, von dem die Dauer subtrahiert wird.

Dauer  Erforderlich; Variant. 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; Variant. 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; Variant. Der Ausdruck, der in eine Dauer konvertiert werden soll.

durationunits  Optional; Long. 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 in option auf der Registerkarte Zeitplan des Dialogfelds Optionen (MenüExtras) eingegebenen Einheiten 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; Variant. 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 einem numerischen 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 Uhrzeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 (23:59:59) darstellt. Zeit kann jedoch auch jeder Ausdruck sein, der eine Uhrzeit 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 DatumNull 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; einen beliebigen Variant-,numerischen oder Zeichenfolgenausdruck oder eine beliebige Kombination, die ein Datum darstellen kann. Wenn DatumNull 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 Auswahlmöglichkeiten führt.

Wahlmöglichkeiten  Erforderlich; Variantenausdruck, 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; Variantenausdruck, 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 Ausdruck Falseist.

IsNumeric

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

Syntax

IsNumeric(Ausdruck)

Ausdruck  Erforderlich; Variant, die einen numerischen Ausdruck oder 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; Variant, die einen numerischen Ausdruck oder 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; beliebiger gültiger numerischer Ausdruck. Wenn ZahlNull 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; Doppelter oder gültiger numerischer Ausdruck.

Cos

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

Syntax

Cos(Zahl)

Zahl  Erforderlich; Doppel- oder beliebiger gültiger numerischer Ausdruck, der einen Winkel in Bogenmaß ausd.

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; Doppelter oder 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; Doppelter oder gültiger numerischer Ausdruck. Wenn ZahlNull 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; Doppelter oder gültiger numerischer Ausdruck. Wenn ZahlNull 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; Doppel- oder beliebiger gültiger numerischer Ausdruck größer als 0

Rnd

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

Syntax

Rnd(Zahl)

Zahl  Erforderlich; Einzelner oder 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; beliebiger 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; Doppel- oder beliebiger gültiger numerischer Ausdruck, der einen Winkel in Bogenmaß ausd.

Sqr

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

Syntax

Sqr(Zahl)

Zahl  Erforderlich; Doppel- oder beliebiger gültiger numerischer Ausdruck, der gleich oder größer als 0 ist.

Tan

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

Syntax

Tan(Zahl)

Zahl  Erforderlich; Doppel- oder beliebiger gültiger numerischer Ausdruck, der einen Winkel in Bogenmaß ausd.

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)

Zeichenfolge  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, das 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; einen beliebigen gültigen Ausdruck.

Format  Optional; einen gültigen benannten oder benutzerdefinierten 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])

Start  Optional; numerischer Ausdruck, mit dem die Ausgangsposition für jede Suche bestimmt wird. 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. Fehlt Vergleich, bestimmt die Einstellung Vergleich der Option den Typ des Vergleichs.

LCase

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

Syntax

LCase(Zeichenfolge)

Zeichenfolge   Erforderlich; einen beliebigen gültigen Zeichenfolgenausdruck. Wenn ZeichenfolgeNull 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 ZeichenfolgeNull enthält,wird Null zurückgegeben.

Länge  Erforderlich; Variant (Long). Numerischer Ausdruck, der angibt, wie viele Zeichen zurückgeben werden. 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  Beliebiger gültiger Zeichenfolgenausdruck. Wenn ZeichenfolgeNull enthält,wird Null zurückgegeben.

Variablenname  Beliebiger gültiger Variablenname. Wenn VarnameNull enthält,wird Null zurückgegeben. Wenn varname ein Variantist, behandelt Len ihn wie eine Zeichenfolge und gibt immer die Anzahl der zeichen zurück, die es enthält.

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; einen beliebigen gültigen Zeichenfolgenausdruck. Wenn ZeichenfolgeNull 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, aus dem Zeichen zurückgegeben werden. Wenn ZeichenfolgeNull enthält,wird Null zurückgegeben.

Start  Erforderlich; Long. Zeichenposition in der Zeichenfolge, an der das zu verwendende Teil beginnt. Ist "Start" größer als die Anzahl der Zeichenin der Zeichenfolge, gibt "Mid" eine Zeichenfolge mit der Länge null ("") 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, aus dem die ganz rechts zeichen zurückgegeben werden. Wenn ZeichenfolgeNull enthält,wird Null zurückgegeben.

Länge  Erforderlich; Variant (Long). Numerischer Ausdruck, der angibt, wie viele Zeichen zurückgeben werden. Ist dieses Argument gleich 0, wird eine Zeichenfolge der Länge Null ("") zurückgegeben. Ist die Zeichenfolge gleich oder größer als die Anzahl der Zeichen,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; einen beliebigen gültigen Zeichenfolgenausdruck. Wenn ZeichenfolgeNull 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; einen beliebigen gültigen Zeichenfolgenausdruck.

Zeichenfolge2  Erforderlich; einen beliebigen gültigen Zeichenfolgenausdruck.

Vergleich  Optional; gibt den Typ des Zeichenfolgenvergleichs an. Wenn das Argument Vergleichnull 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; Integer. Die Summe der Werte, die den auszuführenden Konvertierungstyp angeben.

LCID  Optional; die LocaleID, wenn sie sich von der System-LocaleID unterscheiden. (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; Long. Länge der zurückgegebenen Zeichenfolge. Wenn ZahlNull enthält,wird Null zurückgegeben.

Zeichen  Erforderlich; Variant. Zeichencode, der das Zeichen oder den Zeichenfolgenausdruck an gibt, dessen erstes Zeichen zum Erstellen der Rückgabezeichenfolge verwendet wird. Enthält das Zeichen Null,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; einen beliebigen gültigen Zeichenfolgenausdruck. Wenn ZeichenfolgeNull 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; einen beliebigen gültigen Zeichenfolgenausdruck. Wenn ZeichenfolgeNull enthält,wird Null zurückgegeben.