Funkcje projektu dla pól niestandardowych w wersji klasycznej programu Project

Tych funkcji można używać w formułach w celu obliczania wartości dla pól niestandardowych.

Omówienie funkcji programu Project

Podczas pracy w programie Microsoft Project może zajść potrzeba korzystania z wartości, które nie znajdują się bezpośrednio w polach. Formuły umożliwiają tworzenie tych nowych wartości przy użyciu pól.

W poniższych przykładach przedstawiono sposób używania formuł z polami niestandardowymi:

• Po dodaniu do niestandardowego pola liczbowego poniższa formuła zwraca wartość liczbową, która wskazuje liczbę dni między datą bieżącą a datą zakończenia zadań w harmonogramie:

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

• Po dodaniu do niestandardowego pola tekstowego poniższa formuła zwraca wartość „Brak wartości bazowej”, „Przekroczenie budżetu o 20% lub więcej” albo „Poniżej wartości budżetu”:

  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.
  

Funkcje konwersji

Asc

Zwraca liczbę całkowitą odpowiadającą kodowi znaku, który odpowiada pierwszej literze w ciągu.

Składnia

Asc(ciąg)

ciąg  Dowolne prawidłowe wyrażenie ciągu.

CBool

Wymusza traktowanie wyrażenia jako danych logicznych.

Składnia

CBool(wyrażenie)

wyrażenie  Dowolne prawidłowe wyrażenie ciągu lub wyrażenie liczbowe.

CByte

Wymusza traktowanie wyrażenia jako danych typu bajt.

Składnia

CByte(wyrażenie)

wyrażenie  Dowolna liczba całkowita z zakresu od 0 do 255.

CCur

Wymusza traktowanie wyrażenia jako danych typu waluta.

Składnia

CCur(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe z zakresu od -922337203685477,5808 do 922337203685477,5807.

CDate

Wymusza traktowanie wyrażenia jako danych typu data.

Składnia

CDate(wyrażenie)

wyrażenie  Dowolne prawidłowe wyrażenie daty.

CDbl

Wymusza traktowanie wyrażenia jako danych podwójnej precyzji.

Składnia

CDbl(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe z zakresu od -1,79769313486232E308 do -4,94065645841247E-324 dla wartości ujemnych i od 4,94065645841247E-324 do 1,79769313486232E308 dla wartości dodatnich.

CDec

Wymusza traktowanie wyrażenia jako danych dziesiętnych.

Składnia

CDec(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe z zakresu +/-79228162514264337593543950335 dla liczb bez miejsc po przecinku. W przypadku liczb z 28 miejscami po przecinku zakresem jest +/-7.9228162514264337593543950335. Najmniejsza możliwa liczba niezerowa jest równa 0,0000000000000000000000000001.

Chr

Zwraca ciąg zawierający znak skojarzony z określonym kodem znaku.

Składnia

Chr(kod_znaku)

kod_znaku  Wartość typu liczba długa identyfikująca znak.

CInt

Wymusza traktowanie wyrażenia jako danych typu liczba całkowita.

Składnia

CInt(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe od -32 768 do 32 767; ułamki są zaokrąglane.

CLng

Wymusza traktowanie wyrażenia jako danych typu liczba długa.

Składnia

CLng(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe od -2 147 483 648 do 2 147 483 647; ułamki są zaokrąglane.

CSng

Wymusza traktowanie wyrażenia jako danych pojedynczej precyzji.

Składnia

CSng(wyrażenie)

wyrażenie  Dowolne wyrażenie liczbowe z zakresu od -3,402823E38 do -1,401298E-45 dla wartości ujemnych i od 1,401298E-45 do 3,402823E38 dla wartości dodatnich.

CStr

Wymusza traktowanie wyrażenia jako danych typu ciąg.

Składnia

CStr(wyrażenie)

wyrażenie  Dowolne prawidłowe wyrażenie ciągu lub wyrażenie liczbowe.

CVar

Wymusza traktowanie wyrażenia jako danych typu wariant.

Składnia

CVar(wyrażenie)

wyrażenie  Ten sam zakres co w przypadku podwójnej precyzji dla liczb. Ten sam zakres co w przypadku ciągu dla danych nieliczbowych.

DateSerial

Zwraca wartość typu wariant (data) dla określonego roku, miesiąca i dnia.

Składnia

DateSerial(rok, miesiąc, dzień)

Roku  Wymagane; Liczba całkowita. Liczba z przedziału od 100 do 9999 włącznie lub wyrażenie liczbowe.

Miesiąc  Wymagane; Liczba całkowita. Dowolne wyrażenie liczbowe.

Dzień  Wymagane; Liczba całkowita. Dowolne wyrażenie liczbowe.

DateValue

Zwraca wartość typu wariant (data).

Składnia

DateValue(data)

Data  Wymagane; zwykle wyrażenie ciągu reprezentujące datę od 1 stycznia 100 do 31 grudnia 9999. Jednak data może być dowolnym wyrażeniem, które może reprezentować datę, godzinę lub datę i godzinę w tym zakresie.

Day

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 1 do 31 włącznie, która odpowiada dniu miesiąca.

Składnia

Day(data)

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Hex

Zwraca ciąg odpowiadający wartości szesnastkowej liczby.

Składnia

Hex(liczba)

number  Wymagane; dowolny prawidłowy ciąg lub wyrażenie liczbowe.

Hour

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 23 włącznie, która odpowiada godzinie.

Składnia

Hour(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Minute

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 59 włącznie, która odpowiada minucie.

Składnia

Minute(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Month

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 1 do 12, która odpowiada miesiącowi roku.

Składnia

Month(data )

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Oct

Zwraca wartość typu wariant (ciąg) odpowiadającą wartości ósemkowej liczby.

Składnia

Oct(liczba)

number  Wymagane; dowolny prawidłowy ciąg lub wyrażenie liczbowe.

ProjDateConv

Konwertuje wartość na datę.

Składnia

ProjDateConv(wyrażenie, format_daty)

wyrażenie  Wymagane; Wariant. Wyrażenie do przekonwertowania na datę.

Dateformat  Opcjonalne; Długi. Domyślnym formatem daty jest pjDateDefault, ale można podstawić jedną z następujących stałych pjDateFormat (format daty zastosowany 07-09-25 o godzinie 12:33):

• pjDateDefault: format domyślny. Ustawienie na karcie Widok w oknie dialogowym Opcje (menu Narzędzia ).

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM;

• pjDate_mm_dd_yy: 9/25/07;

• pjDate_mm_dd_yyyy: 9/25/2007;

• pjDate_mmmm_dd_yyyy_hh_mmAM: Wrzesień 25, 2007 12:33 PM;

• pjDate_mmmm_dd_yyyy: Wrzesień 25, 2007;

• pjDate_mmm_dd_hh_mmAM: Wrz 25 12:33 PM;

• pjDate_mmm_dd_yyy: Wrz 25, '07;

• pjDate_mmmm_dd: Wrzesień 25;

• pjDate_mmm_dd: Wrz 25;

• pjDate_ddd_mm_dd_yy_hh_mmAM: Wto 9/25/07 12:33 PM;

• pjDate_ddd_mm_dd_yy: Wto 9/25/07;

• pjDate_ddd_mmm_dd_yyy: Wto Wrz 25, '07;

• pjDate_ddd_hh_mmAM: Wto 12:33 PM;

• pjDate_mm_dd: 9/25;

• pjDate_dd: 25;

• pjDate_hh_mmAM: 12:33 PM;

• pjDate_ddd_mmm_dd: Wto Wrz 25;

• pjDate_ddd_mm_dd: Wto 9/25;

• pjDate_ddd_dd: Wto 25;

• pjDate_Www_dd: W40/2;

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM.

ProjDurConv

Konwertuje wyrażenie na wartość czasu trwania w określonych jednostkach.

Składnia

ProjDurConv(wyrażenie, jednostki_czasu_trwania)

wyrażenie  Wymagane; Wariant. Wyrażenie, które ma zostać przekonwertowane na czas trwania.

jednostki czasu_trwania  Opcjonalne; Długi. Jednostki używane do wyrażania czasu trwania. Jeśli argument jednostki_czasu_trwania nie jest określony, wartością domyślną jest typ jednostek określony w opcji Czas trwania wprowadzony na karcie Harmonogram w oknie dialogowym Opcje (menu Narzędzia ). Jednostki czasu_trwania mogą być jedną z następujących stałych pjFormatUnit:

• pjMinutes: pjElapsedMinutes,

• pjHours: pjElapsedHours,

• pjDays: pjElapsedDays,

• pjWeeks: pjElapsedWeeks,

• pjMonths: pjElapsedMonths,

• pjMinutesEstimated: pjElapsedMinutesEstimated,

• pjHoursEstimated: pjElapsedHoursEstimated,

• pjDaysEstimated: pjElapsedDaysEstimated,

• pjWeeksEstimated: pjElapsedWeeksEstimated,

• pjMonthsEstimated: pjElapsedMonthsEstimated.

Second

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 59 włącznie, która odpowiada sekundzie minuty.

Składnia

Second(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Str

Zwraca wartość typu wariant (ciąg) odpowiadającą liczbie.

Składnia

Str(liczba)

number  Wymagane; Liczba długa zawierająca dowolne prawidłowe wyrażenie liczbowe.

StrConv

Zwraca wartość typu wariant (ciąg) przekonwertowaną zgodnie z ustawieniami.

Składnia

StrConv(ciąg, konwersja, LCID)

ciąg  Wymagane; wyrażenie ciągu do przekonwertowania.

Konwersji  Wymagane; Liczba całkowita. Suma wartości określających typ konwersji do wykonania.

LCID  Argument opcjonalny. Identyfikator ustawień regionalnych, jeśli jest inny niż identyfikator ustawień regionalnych systemu (wartością domyślną jest identyfikator ustawień regionalnych systemu).

TimeSerial

Zwraca wartość typu wariant (data) zawierającą czas określonej godziny, minuty i sekundy.

Składnia

TimeSerial(godzina, minuta, sekunda)

Godziny  Wymagane; Wariant (liczba całkowita). Liczba między godziną 0 (12:00) a 23 (23:00), włącznie lub wyrażeniem liczbowym.

Minut  Wymagane; Wariant (liczba całkowita). Dowolne wyrażenie liczbowe.

Drugi  Wymagane; Wariant (liczba całkowita). Dowolne wyrażenie liczbowe.

TimeValue

Zwraca wartość typu wariant (data) zawierającą godzinę.

Składnia

TimeValue(czas)

Czas  Wymagane; zwykle wyrażenie ciągu reprezentujące czas od 0:00:00 (12:00:00) do 23:59:59 (23:59:59) włącznie. Jednak czas może być również dowolnym wyrażeniem reprezentującym godzinę w tym zakresie. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Val

Zwraca liczby zawarte w ciągu jako wartość liczbową odpowiedniego typu.

Składnia

Val(ciąg)

ciąg  Wymagane; dowolne prawidłowe wyrażenie ciągu.

Weekday

Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą odpowiadającą dniu tygodnia.

Składnia

Weekday(data;[pierwszy_dzień_tygodnia])

Data  Wymagane; Wariant, wyrażenie liczbowe, wyrażenie ciągu dowolnej kombinacji, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Firstdayofweek  Opcjonalne; stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że niedziela.

Year

Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą reprezentującą rok.

Składnia

Year(data)

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Funkcje daty/godziny

CDate

Wymusza traktowanie wyrażenia jako danych typu data.

Składnia

CDate(wyrażenie)

wyrażenie  Dowolne prawidłowe wyrażenie daty.

Date

Zwraca wartość typu wariant (data) zawierającą bieżącą datę systemową.

Składnia

Date

DateAdd

Zwraca wartość typu wariant (data) zawierającą datę, do której dodano określony interwał.

Składnia

DateAdd(interwał, liczba, data)

interval  Wymagane; Wyrażenie ciągu będące interwałem, który chcesz dodać, na przykład "m" lub "d".

number  Wymagane; wyrażenie liczbowe będące liczbą interwałów, które chcesz dodać. Może to być dodatnie (aby uzyskać daty w przyszłości) lub ujemne (aby uzyskać daty w przeszłości).

Data  Wymagane; Wariant (data) lub literał reprezentujący datę, do której jest dodawany interwał.

DateDiff

Zwraca wartość typu wariant (liczba długa) określającą liczbę interwałów między dwiema określonymi datami.

Składnia

DateDiff(interwał, data1, data2[, pierwszy_dzień_tygodnia[, pierwszy_tydzień_roku]])

interval  Wymagane; wyrażenie ciągu będące interwałem czasu używanym do obliczania różnicy między datą 1 a datą2.

data1, data2  Wymagane; Wariant (data). Dwie daty, których chcesz użyć w obliczeniach.

Firstdayofweek  Opcjonalne; stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że niedziela.

firstweekofyear  Opcjonalne; stała określająca pierwszy tydzień roku. Jeśli nie określono, przyjmuje się, że pierwszy tydzień jest tygodniem, w którym występuje 1 stycznia.

DatePart

Zwraca wartość typu wariant (liczba całkowita) zawierającą określoną część danej daty.

Składnia

DatePart(interwał, data[,pierwszy_dzień_tygodnia[,pierwszy_tydzień_roku]])

interval  Wymagane; wyrażenie ciągu będące interwałem czasu, który ma zostać zwrócony.

Data  Wymagane; Wartość typu wariant (data), która ma zostać obliczona.

Firstdayofweek  Opcjonalne; stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że niedziela.

firstweekofyear  Opcjonalne; stała określająca pierwszy tydzień roku. Jeśli nie określono, przyjmuje się, że pierwszy tydzień należy do tygodnia, w którym występuje 1 stycznia.

DateSerial

Zwraca wartość typu wariant (data) dla określonego roku, miesiąca i dnia.

Składnia

DateSerial(rok, miesiąc, dzień)

Roku  Wymagane; Liczba całkowita. Liczba z przedziału od 100 do 9999 włącznie lub wyrażenie liczbowe.

Miesiąc  Wymagane; Liczba całkowita. Dowolne wyrażenie liczbowe.

Dzień  Wymagane; Liczba całkowita. Dowolne wyrażenie liczbowe.

DateValue

Zwraca wartość typu wariant (data).

Składnia

DateValue(data)

Data  Wymagane; zwykle wyrażenie ciągu reprezentujące datę od 1 stycznia 100 do 31 grudnia 9999. Jednak data może być dowolnym wyrażeniem, które może reprezentować datę, godzinę lub datę i godzinę w tym zakresie.

Day

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 1 do 31 włącznie, która odpowiada dniu miesiąca.

Składnia

Day(data)

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Hour

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 23 włącznie, która odpowiada godzinie.

Składnia

Hour(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

IsDate

Zwraca wartość logiczną wskazującą, czy wyrażenie można konwertować na datę.

Składnia

IsDate(wyrażenie)

wyrażenie  Wymagane; dowolny wariant zawierający wyrażenie daty lub wyrażenie ciągu rozpoznawalne jako data lub godzina.

Minute

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 59 włącznie, która odpowiada minucie.

Składnia

Minute(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Month

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 1 do 12, która odpowiada miesiącowi roku.

Składnia

Month(data )

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Now

Zwraca wartość typu wariant (data) określającą bieżącą datę i godzinę według daty i godziny systemowej komputera.

Składnia

Now

ProjDateAdd

Dodaje czas trwania do daty i zwraca nową datę.

Składnia

ProjDateAdd(data, czas_trwania, kalendarz)

Data  Wymagane; Wariant. Oryginalna data, do której dodano czas trwania .

czas trwania  Wymagane; Wariant. Czas trwania do dodania do daty.

Kalendarz  Opcjonalne; Ciąg znaków. Kalendarz używany podczas obliczania nowej daty. Jeśli nie określono kalendarza , wartością domyślną bieżącego zasobu jest kalendarz zasobu lub dla bieżącego zadania— kalendarz zadania lub kalendarz standardowy, jeśli nie istnieje kalendarz zadania. W przypadku programu Project Server będzie używany kalendarz standardowy, niezależnie od tego, który kalendarz jest określony w ciągu kalendarza . Podczas używania tej funkcji w formule utworzonej w aplikacji Project Web App i porównania jej z tą samą formułą utworzoną w programie Project Professional należy sprawdzić, czy wyniki są oczekiwane.

ProjDateConv

Konwertuje wartość na datę.

Składnia

ProjDateConv(wyrażenie, format_daty)

wyrażenie  Wymagane; Wariant. Wyrażenie do przekonwertowania na datę.

Dateformat  Opcjonalne; Długi. Domyślnym formatem daty jest pjDateDefault, ale można podstawić jedną z następujących stałych pjDateFormat (format daty zastosowany 07-09-25 o godzinie 12:33):

• pjDateDefault: format domyślny. Ustawienie na karcie Widok w oknie dialogowym Opcje (menu Narzędzia ).

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM;

• pjDate_mm_dd_yy: 9/25/07;

• pjDate_mm_dd_yyyy: 9/25/2007;

• pjDate_mmmm_dd_yyyy_hh_mmAM: Wrzesień 25, 2007 12:33 PM;

• pjDate_mmmm_dd_yyyy: Wrzesień 25, 2007;

• pjDate_mmm_dd_hh_mmAM: Wrz 25 12:33 PM;

• pjDate_mmm_dd_yyy: Wrz 25, '07;

• pjDate_mmmm_dd: Wrzesień 25;

• pjDate_mmm_dd: Wrz 25;

• pjDate_ddd_mm_dd_yy_hh_mmAM: Wto 9/25/07 12:33 PM;

• pjDate_ddd_mm_dd_yy: Wto 9/25/03;

• pjDate_ddd_mmm_dd_yyy: Wto Wrz 25, '07;

• pjDate_ddd_hh_mmAM: Wto 12:33 PM;

• pjDate_mm_dd: 9/25;

• pjDate_dd: 25;

• pjDate_hh_mmAM: 12:33 PM;

• pjDate_ddd_mmm_dd: Wto Wrz 25;

• pjDate_ddd_mm_dd: Wto 9/25;

• pjDate_ddd_dd: Wto 25;

• pjDate_Www_dd: W40/2;

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM.

ProjDateDiff

Zwraca czas trwania w minutach między dwiema datami.

Składnia

ProjDateDiff(data1, data2, kalendarz)

data1  Wymagane; Wariant. Data używana jako początek czasu trwania.

data2  Wymagane; Wariant. Data używana jako koniec czasu trwania.

Kalendarz  Opcjonalne; Ciąg znaków. Kalendarz używany podczas obliczania czasu trwania. Jeśli nie określono kalendarza , kalendarzem domyślnym bieżącego zasobu jest kalendarz zasobu lub dla bieżącego zadania, kalendarza zadania (lub kalendarza standardowego, jeśli nie ma kalendarza zadania dla programu Project Server, zostanie użyty kalendarz standardowy, niezależnie od tego, który kalendarz został określony w ciągu kalendarza . Podczas używania tej funkcji w formule utworzonej w aplikacji Project Web App i porównania jej z tą samą formułą utworzoną w programie Project Professional należy sprawdzić, czy wyniki są oczekiwane.

ProjDateSub

Zwraca datę poprzedzającą inną datę o określony czas trwania.

Składnia

ProjDateSub(data, czas_trwania, kalendarz)

Data  Wymagane; Wariant. Oryginalna data, od której jest odejmowany czas trwania .

czas trwania  Wymagane; Wariant. Czas trwania odejmowania od daty.

Kalendarz  Opcjonalne; Ciąg znaków. Kalendarz używany podczas obliczania różnicy dat. Jeśli nie określono kalendarza , wartością domyślną bieżącego zasobu jest kalendarz zasobu lub dla bieżącego zadania, kalendarz zadania (lub kalendarz standardowy, jeśli nie ma kalendarza zadania). W przypadku programu Project Server będzie używany kalendarz standardowy, niezależnie od tego, który kalendarz jest określony w ciągu kalendarza . Podczas używania tej funkcji w formule utworzonej w aplikacji Project Web App i porównania jej z tą samą formułą utworzoną w programie Project Professional należy sprawdzić, czy wyniki są oczekiwane.

ProjDateValue

Zwraca wartość daty wyrażenia.

Składnia

ProjDateValue(wyrażenie)

wyrażenie  Wymagane; Wariant. Wyrażenie, które ma być reprezentowane jako data.

ProjDurConv

Konwertuje wyrażenie na wartość czasu trwania w określonych jednostkach.

Składnia

ProjDurConv(wyrażenie, jednostki_czasu_trwania)

wyrażenie  Wymagane; Wariant. Wyrażenie, które ma zostać przekonwertowane na czas trwania.

jednostki czasu_trwania  Opcjonalne; Długi. Jednostki używane do wyrażania czasu trwania. Jeśli argument jednostki_czasu_trwania nie jest określony, wartością domyślną jest typ jednostek określony w opcji Czas trwania wprowadzony na karcie Harmonogram w oknie dialogowym Opcje (menu Narzędzia ). Jednostki czasu_trwania mogą być jedną z następujących stałych pjFormatUnit:

• pjMinutes: pjElapsedMinutes,

• pjHours: pjElapsedHours,

• pjDays: pjElapsedDays,

• pjWeeks: pjElapsedWeeks,

• pjMonths: pjElapsedMonths,

• pjMinutesEstimated: pjElapsedMinutesEstimated,

• pjHoursEstimated: pjElapsedHoursEstimated,

• pjDaysEstimated: pjElapsedDaysEstimated,

• pjWeeksEstimated: pjElapsedWeeksEstimated,

• pjMonthsEstimated: pjElapsedMonthsEstimated.

ProjDurValue

Zwraca liczbę minut w czasie trwania.

Składnia

ProjDurValue(czas_trwania)

czas trwania  Wymagane; Wariant. Czas trwania wyrażony w minutach.

Second

Zwraca wartość typu wariant (liczba całkowita) określającą liczbę całkowitą z zakresu od 0 do 59 włącznie, która odpowiada sekundzie minuty.

Składnia

Second(czas)

Czas  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować czas. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Time

Zwraca wartość typu wariant (data) wskazującą bieżący czas systemowy.

Składnia

Time

Timer

Zwraca wartość typu Pojedyncza precyzja odpowiadającą liczbie sekund, jaka upłynęła od północy.

Składnia

Timer

TimeSerial

Zwraca wartość typu wariant (data) zawierającą czas określonej godziny, minuty i sekundy.

Składnia

TimeSerial(godzina, minuta, sekunda)

Godziny  Wymagane; Wariant (liczba całkowita). Liczba między godziną 0 (12:00) a 23 (23:00), włącznie lub wyrażeniem liczbowym.

Minut  Wymagane; Wariant (liczba całkowita). Dowolne wyrażenie liczbowe.

Drugi  Wymagane; Wariant (liczba całkowita). Dowolne wyrażenie liczbowe.

TimeValue

Zwraca wartość typu wariant (data) zawierającą godzinę.

Składnia

TimeValue(czas)

Czas  Wymagane; zwykle wyrażenie ciągu reprezentujące czas od 0:00:00 (12:00:00) do 23:59:59 (23:59:59) włącznie. Jednak czas może być również dowolnym wyrażeniem reprezentującym godzinę w tym zakresie. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .

Weekday

Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą odpowiadającą dniu tygodnia.

Składnia

Weekday(data;[pierwszy_dzień_tygodnia])

Data  Wymagane; Wariant, wyrażenie liczbowe, wyrażenie ciągu dowolnej kombinacji, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Firstdayofweek  Opcjonalne; stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że niedziela.

Year

Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą reprezentującą rok.

Składnia

Year(data)

Data  Wymagane; dowolne wyrażenie typu wariant, wyrażenie liczbowe lub wyrażenie ciągu albo dowolna kombinacja, która może reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null .

Funkcje ogólne

Choose

Wybiera i zwraca wartość z listy argumentów.

Składnia

Choose(indeks, wybór-1[, wybór-2, ... [, wybór-n]])

indeks  Wymagane; wyrażenie liczbowe lub pole powodujące wartość z przedziału od 1 do liczby dostępnych opcji do wyboru.

Wybór  Wymagane; Wyrażenie typu wariant zawierające jedną z możliwych opcji do wyboru.

IIf

Zwraca jedną z dwóch części, w zależności od obliczonego wyniku wyrażenia.

Składnia

IIf(wyr., część_prawdziwa, część_fałszywa)

wyrażenie  Wymagane; Wyrażenie typu wariant , które ma zostać obliczone.

truepart  Wymagane; wartość lub wyrażenie, które mają zostać zwrócone, jeśli odpowiadające im wyrażenie ma wartość Prawda.

falsepart  Wymagane; wartość lub wyrażenie, które mają zostać zwrócone, jeśli odpowiadające im wyrażenie mawartość Fałsz.

IsNumeric

Zwraca wartość logiczną wskazującą, czy wyrażenie można obliczyć jako liczbę.

Składnia

IsNumeric(wyrażenie)

wyrażenie  Wymagane; Wariant zawierający wyrażenie liczbowe lub wyrażenie ciągu.

IsNull

Zwraca wartość logiczną, która wskazuje, czy wyrażenie nie zawiera żadnych prawidłowych danych (null).

Składnia

IsNull(wyrażenie)

wyrażenie  Wymagane; Wariant zawierający wyrażenie liczbowe lub wyrażenie ciągu.

Switch

Wyznacza wartość listy wyrażeń i zwraca wartość typu wariant lub wyrażenie skojarzone z pierwszym wyrażeniem na liście, które ma wartość Prawda.

Składnia

Switch(wyr-1, wartość-1[, wyr-2, wartość-2, ... [, wyr-n,wartość-n]])

Funkcje matematyczne

Abs

Zwraca wartość tego samego typu co wartość przekazywana do funkcji, określając wartość bezwzględną liczby.

Składnia

Abs(liczba)

number  Wymagane; dowolne prawidłowe wyrażenie liczbowe. Jeśli argument liczba zawiera wartość Null, funkcja zwraca wartość Null . jeśli jest to zmienna niezainicjowana, zwracana jest wartość zero.

Atn

Zwraca wartość typu Podwójna precyzja określającą arcus tangens liczby.

Składnia

Atn(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe.

Cos

Zwraca wartość typu Podwójna precyzja określającą cosinus kąta.

Składnia

Cos(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe, które wyraża kąt w radianach.

Exp

Zwraca wartość typu Podwójna precyzja określającą e (podstawę logarytmów naturalnych) podniesione do potęgi.

Składnia

Exp(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe.

Fix

Zwraca część całkowitą liczby. Jeśli liczba jest ujemna, zwraca pierwszą ujemną liczbę całkowitą większą lub równą liczbie.

Składnia

Fix(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe. Jeśli argument liczba zawiera wartość Null, funkcja zwraca wartość Null .

Int

Zwraca część całkowitą liczby. Jeśli argument liczba jest ujemny, zwraca pierwszą ujemną liczbę całkowitą mniejszą lub równą argumentowi liczba.

Składnia

Int(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe. Jeśli argument liczba zawiera wartość Null, funkcja zwraca wartość Null .

Log

Zwraca wartość typu Podwójna precyzja określającą logarytm naturalny liczby.

Składnia

Log(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe większe niż zero.

Rnd

Zwraca wartość typu Pojedyncza precyzja, zawierającą liczbę losową.

Składnia

Rnd(liczba)

number  Wymagane; Pojedyncze lub dowolne prawidłowe wyrażenie liczbowe.

Sgn

Zwraca wartość typu wariant (liczba całkowita) wskazującą znak liczby.

Składnia

Sgn(liczba)

number  Wymagane; dowolne prawidłowe wyrażenie liczbowe.

Zwracane wartości:

• Jeśli liczba jest większa od zera, funkcja Sgn zwraca 1.

• Jeśli liczba jest równa zero, funkcja Sgn zwraca 0.

• Jeśli liczba jest mniejsza od zera, funkcja Sgn zwraca -1.

Sin

Zwraca wartość typu Podwójna precyzja określającą sinus kąta.

Składnia

Sin(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe, które wyraża kąt w radianach.

Sqr

Zwraca wartość typu Podwójna precyzja określającą pierwiastek kwadratowy liczby.

Składnia

Sqr(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe równe lub większe niż zero.

Tan

Zwraca wartość typu Podwójna precyzja określającą tangens kąta.

Składnia

Tan(liczba)

number  Wymagane; Podwójne lub dowolne prawidłowe wyrażenie liczbowe, które wyraża kąt w radianach.

Funkcje tekstowe

Asc

Zwraca liczbę całkowitą odpowiadającą kodowi znaku, który odpowiada pierwszej literze w ciągu.

Składnia

Asc(ciąg)

Ciąg  Dowolne prawidłowe wyrażenie ciągu.

Chr

Zwraca ciąg zawierający znak skojarzony z określonym kodem znaku.

Składnia

Chr(kod_znaku)

kod_znaku  Wartość typu liczba długa identyfikująca znak.

Format

Zwraca wartość typu wariant (ciąg) zawierającą wyrażenie sformatowane według instrukcji zawartej w wyrażeniu formatowania.

Składnia

Format(wyrażenie[, format[, pierwszy_dzień_tygodnia[, pierwszy_tydzień_roku]]])

wyrażenie  Wymagane; dowolne prawidłowe wyrażenie.

Formacie  Opcjonalne; prawidłowe nazwane lub zdefiniowane przez użytkownika wyrażenie formatu.

Firstdayofweek  Opcjonalne; Stała określająca pierwszy dzień tygodnia.

firstweekofyear  Opcjonalne; Stała określająca pierwszy tydzień roku.

Instr

Zwraca wartość typu wariant (długa), określającą pozycję pierwszego wystąpienia jednego ciągu w innym ciągu.

Składnia

Instr([start, ]ciąg1, ciąg2[, porównanie])

Uruchomić  Opcjonalne; wyrażenie liczbowe, które ustawia pozycję początkową dla każdego wyszukiwania. Jeśli zostanie pominięte, wyszukiwanie rozpocznie się od pierwszego znaku. Jeśli argument start zawiera wartość Null, występuje błąd. Argument początek jest wymagany, jeśli określono porównanie .

ciąg1  Wymagane; przeszukiwane wyrażenie ciągu.

ciąg2  Wymagane; szukane wyrażenie ciągu.

Porównać  Opcjonalne; określa typ porównania ciągów. Jeśli argument porównaj ma wartość Null, występuje błąd. Jeśli argument porównanie zostanie pominięty, ustawienie Porównajopcję określa typ porównania.

LCase

Zwraca ciąg przekonwertowany na małe litery.

Składnia

LCase(ciąg)

ciąg   Wymagane; dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

Left

Zwraca wartość typu wariant (ciąg) zawierającą określoną liczbę znaków z lewej strony innego ciągu.

Składnia

Left(ciąg, długość)

ciąg  Argument wymagany. Wyrażenie ciągu, z którego lewej strony są zwracane znaki. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

długość  Wymagane; Wariant (liczba długa). Wyrażenie liczbowe wskazujące liczbę zwracanych znaków. Jeśli długość jest równa 0, funkcja zwraca ciąg o zerowej długości (""). Jeśli jest większa lub równa liczbie znaków w ciągu, funkcja zwraca cały ciąg.

Len

Zwraca wartość typu liczba długa zawierającą liczbę znaków w ciągu lub liczbę bajtów wymaganych do przechowania zmiennej.

Składnia

Len(ciąg, nazwa_zmiennej)

ciąg  Dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

nazwa_zmiennej  Dowolna prawidłowa nazwa zmiennej. Jeśli argument nazwa_zmiennej zawiera wartość null, funkcja zwraca wartość null. Jeśli argument nazwa_zmiennej jest wartością typu wariant, funkcja Len traktuje ją tak samo, jak ciąg i zawsze zwraca jej liczbę znaków.

LTrim

Zwraca wartość typu wariant (ciąg) zawierającą kopię określonego ciągu bez początkowych spacji.

Składnia

LTrim(ciąg)

ciąg  Wymagane; dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

Mid

Zwraca wartość typu wariant (ciąg) zawierającą określoną liczbę znaków z ciągu.

Składnia

Mid(ciąg, start[, długość])

ciąg  Wymagane; wyrażenie ciągu, z którego są zwracane znaki. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

Uruchomić  Wymagane; Długi. Pozycja znaku w ciągu , od którego rozpoczyna się część do wykonania. Jeśli wartość argumentu początek jest większa niż liczba znaków w ciągu, funkcja Mid zwraca ciąg o zerowej długości ("").

długość  Opcjonalne; Wariant (liczba długa). Liczba znaków do zwrócenia. Jeśli znak w tekście zostanie pominięty lub będzie ich mniej niż długość (w tym znak na początku), zostaną zwrócone wszystkie znaki od pozycji początkowej do końca ciągu.

Right

Zwraca wartość typu wariant (ciąg) zawierającą określoną liczbę znaków z prawej strony innego ciągu.

Składnia

Right(ciąg, długość)

ciąg  Wymagane; wyrażenie ciągu, z którego są zwracane skrajne po prawej stronie znaki. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

długość  Wymagane; Wariant (liczba długa). Wyrażenie liczbowe wskazujące liczbę zwracanych znaków. Jeśli długość jest równa 0, funkcja zwraca ciąg o zerowej długości (""). Jeśli liczba znaków w ciągu jest równa lub większa, zwracany jest cały ciąg.

RTrim

Zwraca wartość typu wariant (ciąg) zawierającą kopię określonego ciągu bez spacji końcowych.

Składnia

RTrim(ciąg)

ciąg  Wymagane; dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

Space

Zwraca wartość typu wariant (ciąg) zawierającą określoną liczbę spacji.

Składnia

Space(liczba)

number  Wymagane; liczba spacji w ciągu.

StrComp

Zwraca wartość typu wariant (liczba całkowita) wskazującą wynik porównania ciągów.

Składnia

StrComp(ciąg1, ciąg2[, porównanie])

ciąg1  Wymagane; dowolne prawidłowe wyrażenie ciągu.

ciąg2  Wymagane; dowolne prawidłowe wyrażenie ciągu.

Porównać  Opcjonalne; określa typ porównania ciągów. Jeśli argument porównaj ma wartość Null, występuje błąd.

StrConv

Zwraca wartość typu wariant (ciąg) przekonwertowaną zgodnie z ustawieniami.

Składnia

StrConv(ciąg, konwersja, LCID)

ciąg  Wymagane; wyrażenie ciągu do przekonwertowania.

Konwersji  Wymagane; Liczba całkowita. Suma wartości określających typ konwersji do wykonania.

LCID  Argument opcjonalny. Identyfikator ustawień regionalnych, jeśli jest inny niż identyfikator ustawień regionalnych systemu (wartością domyślną jest identyfikator ustawień regionalnych systemu).

String

Zwraca wartość typu wariant (ciąg) zawierającą ciąg powtarzającego się znaku o określonej długości.

Składnia

String(liczba, znak)

number  Wymagane; Długi. Długość zwracanego ciągu. Jeśli argument liczba zawiera wartość Null, funkcja zwraca wartość Null .

znak  Wymagane; Wariant. Kod znaku określający znak lub wyrażenie ciągu, którego pierwszy znak jest używany do utworzenia zwracanego ciągu. Jeśli argument znak zawiera wartość Null, funkcja zwraca wartość Null .

Trim

Zwraca wartość typu wariant (ciąg) zawierającą kopię określonego ciągu bez spacji początkowych i końcowych.

Składnia

Trim(ciąg)

ciąg  Wymagane; dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.

UCase

Zwraca wartość typu wariant (ciąg), zawierającą określony ciąg przekonwertowany na wielkie litery.

Składnia

UCase(ciąg)

ciąg  Wymagane; dowolne prawidłowe wyrażenie ciągu. Jeśli argument ciąg zawiera wartość null, funkcja zwraca wartość null.