Функції Project для настроюваних полів у класичній програмі Project

Ці функції застосовуються у формулах для обчислення значень полів.

Огляд функцій Project

У Microsoft Project іноді доводиться працювати зі значеннями, не розташованими безпосередньо в полях. Щоб їх створити, можна скористатися формулами, які дають змогу працювати з полями.

В нижченаведених прикладах демонструється використання формул із настроюваними полями.

• У разі додавання до настроюваних числових полів зазначені нижче формули повертають числові значення, які вказують кількість днів між поточною датою та датою завершення завдань у розкладі.

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

• У разі додавання до настроюваного текстового поля наведена нижче формула поверне значення «Немає базової лінії», «Перевищення бюджету на 20 % або більше» або «У межах бюджету».

  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.
  

Функції перетворення

Asc

Повертає значення типу Integer, що є кодом символу, який відповідає першій букві в рядку.

Синтаксис

ASC (рядок)

рядок  Будь-який припустимий рядковий вираз.

CBool

Приводить вираз до типу даних Boolean.

Синтаксис

CBool(вираз)

вираз  Будь-який дійсний рядковий або числовий вираз.

CByte

Приводить вираз до типу даних Byte.

Синтаксис

CByte(вираз)

вираз  Будь-яке ціле число від 0 до 255.

CCur

Приводить вираз до типу даних Currency.

Синтаксис

CCur(вираз)

вираз  Будь-який числовий вираз від -922 337 203 685 477,5808 до 922 337 203 685 477,5807.

CDate

Приводить вираз до типу даних Date.

Синтаксис

CDate(вираз)

вираз  Будь-який вираз у форматі дати.

CDbl

Приводить вираз до типу даних Double.

Синтаксис

CDbl(вираз)

вираз  Будь-який числовий вираз від -1,79769313486232E308 до -4,94065645841247E-324 для від'ємних значень; 4.94065645841247E-324 до 1,79769313486232E308 для додатних значень.

CDec

Приводить вираз до типу даних Decimal.

Синтаксис

CDec(вираз)

вираз  Будь-який числовий вираз від +/-79 228 162 514 264 337 593 543 950 335 для чисел із нульовим масштабом, тобто чисел без десяткових розрядів. Для чисел із 28 десятковими розрядами діапазон становить +/-7,92281625142643375935439503335. Найменше можливе ненульове число – 0,0000000000000000000000000001.

Chr

Повертає значення типу String, яке містить символ, пов’язаний з указаним кодом символу.

Синтаксис

Chr(код_символу)

Снагсоле  Довге ціле, що визначає символ.

CInt

Приводить вираз до типу даних Integer.

Синтаксис

CInt(вираз)

вираз  Будь-який числовий вираз від -32 768 до 32 767; дроби округлюються.

CLng

Приводить вираз до типу даних Long.

Синтаксис

CLng(вираз)

вираз  Будь-який числовий вираз від -2 147 483 648 до 2 147 483 647; дроби округлюються.

CSng

Приводить вираз до типу даних Single.

Синтаксис

CSng(вираз)

вираз  Будь-який числовий вираз від -3,402823E38 до -1,401298E-45 для від'ємних значень; Від 1,401298E-45 до 3,402823E38 для додатних значень.

CStr

Приводить вираз до типу даних String.

Синтаксис

CStr(вираз)

вираз  Будь-який дійсний рядковий або числовий вираз.

CVar

Приводить вираз до типу даних Variant.

Синтаксис

CVar(вираз)

вираз  Такий же діапазон, як і в типу Double для числових виразів. Такий же діапазон як і в типу String для нечислових виразів.

DateSerial

Повернення значення типу Variant (Date) для вказаного року, місяця та дня.

Синтаксис

DateSerial(рік, місяць, день)

Рік  Необхідні; Ціле число. Число від 100 до 9999 включно або числовий вираз.

Місяць  Необхідні; Ціле число. Будь-який числовий вираз.

day  Необхідні; Ціле число. Будь-який числовий вираз.

DateValue

Повертає значення типу Variant (Date).

Синтаксис

DateValue(дата)

Дата  Необхідні; зазвичай рядковий вираз, який представляє дату від 1 січня 100 до 31 грудня 9999 року. Однак датою також може бути будь-який вираз, який може представляти дату, час або дату й час у цьому діапазоні.

Day

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 1 до 31 включно, і яке позначає день місяця.

Синтаксис

Day(дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

Hex

Повертає значення типу String, яке представляє шістнадцяткове значення числа.

Синтаксис

Hex(число)

Номер  Необхідні; будь-який припустимий рядковий або числовий вираз.

Hour

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 23 включно, і яке позначає годину доби.

Синтаксис

Hour(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

Minute

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 59 включно, і яке позначає хвилину в годині.

Синтаксис

Minute(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

Month

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 1 до 12 включно, і яке позначає місяць року.

Синтаксис

Month(дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо дата містить Null-значення, повертається значення Null .

Oct

Повертає значення типу Variant (String), яке представляє вісімкове значення числа.

Синтаксис

Oct(число)

Номер  Необхідні; будь-який припустимий рядковий або числовий вираз.

ProjDateConv

Перетворює значення на дату.

Синтаксис

ProjDateConv(вираз, формат_дати)

вираз  Необхідні; Варіант. Вираз, який потрібно перетворити на дату.

формат дати  Необов'язково; Довге ціле. За замовчуванням використовується формат дати pjDateDefault, але ви можете замінити одну з таких констант pjDateFormat (формат дати, застосований 25.09.07 о 12:33):

• pjDateDefault – стандартний формат. Його можна задати в діалоговому вікні Параметри (меню Знаряддя) на вкладці Вигляд.

• pjDate_mm_dd_yy_hh_mmAM: 25.09.07 12:33

• pjDate_mm_dd_yy: 25.09.07

• pjDate_mm_dd_yyyy: 25.09.2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: 25 вересня 2007, 12:33

• pjDate_mmmm_dd_yyyy: 25 вересня 2007

• pjDate_mmm_dd_hh_mmAM: 25 вер 12:33

• pjDate_mmm_dd_yyy: 25 вер, '07

• pjDate_mmmm_dd: 25 вересня

• pjDate_mmm_dd: 25 вер

• pjDate_ddd_mm_dd_yy_hh_mmAM: вт 25.09.07 12:33

• pjDate_ddd_mm_dd_yy: вт 9/25/07

• pjDate_ddd_mmm_dd_yyy: вт 25 вер '07

• pjDate_ddd_hh_mmAM: вт 12:33

• pjDate_mm_dd: 25.09

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33

• pjDate_ddd_mmm_dd: вт 25 вер

• pjDate_ddd_mm_dd: вт 25.09

• pjDate_ddd_dd: вт 25

• pjDate_Www_dd: Т40.2

• pjDate_Www_dd_yy_hh_mmAM: Т40.2.07 12:33

ProjDurConv

Перетворює вираз на значення тривалості у вказаних одиницях.

Синтаксис

ProjDurConv(вираз, одиниці_тривалості)

вираз  Необхідні; Варіант. Вираз, який потрібно перетворити на тривалість.

durationunits  Необов'язково; Довге ціле. Одиниці вимірювання, які виражали тривалість. Якщо значення durationunits не вказано, значення за промовчанням – це тип одиниць, указаний у параметрі Тривалість , на вкладці Розклад діалогового вікна Параметри (меню Знаряддя ). Одиниці тривалості можуть бути однією з таких констант pjFormatUnit :

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

Second

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 59 включно, і яке позначає секунду у хвилині.

Синтаксис

Second(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

Str

Повертає представлення числа у вигляді значення типу Variant (String).

Синтаксис

Str(число)

Номер  Необхідні; Довге числове значення містить будь-який припустимий числовий вираз.

StrConv

Повертає значення типу Variant (String), перетворене зазначеним чином.

Синтаксис

StrConv(рядок, перетворення, код мови)

рядок  Необхідні; рядковий вираз, який потрібно перетворити.

Перетворення  Необхідні; Ціле число. Сума значень, що визначає, який тип перетворення потрібно виконати.

LCID  Необов'язково; localeID, якщо він відрізняється від system LocaleID. (Код локалізації системи – це стандартний ідентифікатор.)

TimeSerial

Повертає значення типу Variant (Date), яке містить час певної години, хвилини та секунди.

Синтаксис

TimeSerial (години, хвилини, секунди)

Години  Необхідні; Variant (Integer). Число від 0 (12:00) до 23 (23:00) включно або числовий вираз.

Хвилин  Необхідні; Variant (Integer). Будь-який числовий вираз.

Другий  Необхідні; Variant (Integer). Будь-який числовий вираз.

TimeValue

Повертає значення типу Variant (Date), що містить час.

Синтаксис

TimeValue(час)

Час  Необхідні; зазвичай рядковий вираз, який представляє час із 0:00:00 (12:00:00) до 23:59:59 (23:59:59) включно. Однак час також може бути будь-яким виразом, який представляє час у цьому діапазоні. Якщо аргумент time містить Null-значення, повертається значення Null .

Val

Повертає числа, які містяться в рядку, як числове значення відповідного типу.

Синтаксис

Val (рядок)

рядок  Необхідні; будь-який припустимий рядковий вираз.

Weekday

Повертає значення типу Variant (Integer), яке містить ціле число, що позначає день тижня.

Синтаксис

Weekday(дата[, перший_день_тижня])

Дата  Необхідні; Варіант, числовий вираз, рядковий вираз будь-якої комбінації, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

firstdayofweek  Необов'язково; константа, яка визначає перший день тижня. Якщо це значення не задано, вважається, що це неділя.

Year

Повертає значення типу Variant (Integer), яке містить ціле число, що позначає рік.

Синтаксис

Year(дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

Функції дати й часу

CDate

Приводить вираз до типу даних Date.

Синтаксис

CDate(вираз)

вираз  Будь-який вираз у форматі дати.

Date

Повертає значення типу Variant (Date), що містить поточну системну дату.

Синтаксис

Date

DateAdd

Повертає значення типу Variant (Date), яке містить дату для якої було додано вказаний часовий інтервал.

Синтаксис

DateAdd (інтервал, кількість, дата)

<c0>інтервал</c0> – обов’язковий параметр.  Вираз, що повертає рядок з інтервалом часу, який необхідно додати, наприклад "m" або "d" .

<c0>кількість</c0> – обов’язковий параметр.  Числовий вираз, що дорівнює кількості інтервалів, які необхідно додати. Він може бути додатним (для отримання дат у майбутньому) або від’ємним (для отримання дат у минулому).

Дата  Необхідні; Variant (Date) або literal representing date to which the interval is added.

DateDiff

Повертає значення типу Variant (Long), яке задає кількість часових інтервалів між двома вказаними датами.

Синтаксис

DateDiff (інтервал, дата1, дата2[, перший_день_тижня[, перший_тиждень_року]])

<c0>інтервал</c0> – обов’язковий параметр.  Рядковий вираз, що є інтервалом часу, який використовується для обчислення різниці між значеннями дата1 і дата2.

date1, date2  Необхідні; Variant (Date). Дві дати, які потрібно використовувати в обчисленні.

firstdayofweek  Необов'язково; константа, яка визначає перший день тижня. Якщо це значення не задано, вважається, що це неділя.

firstweekofyear  Необов'язково; константа, яка визначає перший тиждень року. Якщо це значення не задано, першим тижнем вважається тиждень, у який настає 1 січня.

DatePart

Повертає значення типу Variant (Integer), яке містить указану частину заданої дати.

Синтаксис

DatePart (інтервал, дата[,перший_день_тижня[, перший_тиждень_року]])

<c0>число</c0> – обов’язкове значення.  Числовий вираз, який дорівнює кількості інтервалів часу, які необхідно додати.

Дата  Необхідні; Значення Variant (Date), яке потрібно обчислити.

firstdayofweek  Необов'язково; константа, яка визначає перший день тижня. Якщо це значення не задано, вважається, що це неділя.

firstweekofyear  Необов'язково; константа, яка визначає перший тиждень року. Якщо не вказано, першим тижнем вважається тиждень, у який настає 1 січня.

DateSerial

Повернення значення типу Variant (Date) для вказаного року, місяця та дня.

Синтаксис

DateSerial(рік, місяць, день)

Рік  Необхідні; Ціле число. Число від 100 до 9999 включно або числовий вираз.

Місяць  Необхідні; Ціле число. Будь-який числовий вираз.

day  Необхідні; Ціле число. Будь-який числовий вираз.

DateValue

Повертає значення типу Variant (Date).

Синтаксис

DateValue (дата)

Дата  Необхідні; зазвичай рядковий вираз, який представляє дату від 1 січня 100 до 31 грудня 9999 року. Однак датою також може бути будь-який вираз, який може представляти дату, час або дату й час у цьому діапазоні.

Day

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 1 до 31 включно, і яке позначає день місяця.

Синтаксис

Day(дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

Hour

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 23 включно, і яке позначає годину доби.

Синтаксис

Hour(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

IsDate

Повертає значення типу Boolean, яке вказує на те, чи можна перетворити вираз на дату.

Синтаксис

IsDate (вираз)

вираз  Необхідні; будь-який варіант , який містить вираз дати або рядковий вираз, який можна розпізнати як дату або час.

Minute

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 59 включно, і яке позначає хвилину в годині.

Синтаксис

Minute(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

Month

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 1 до 12 включно, і яке позначає місяць року.

Синтаксис

Month(дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо дата містить Null-значення, повертається значення Null .

Now

Повертає значення типу Variant (Date), що задає поточну дату й час відповідно до системної дати й часу комп’ютера.

Синтаксис

Now

ProjDateAdd

Додає тривалість до дати, повертаючи нову дату.

Синтаксис

ProjDateAdd(дата, тривалість, календар)

Дата  Необхідні; Варіант. Вихідна дата, до якої додається тривалість .

тривалість  Необхідні; Варіант. Тривалість додавання до дати.

Календар  Календар, який використовується під час обчислення тривалості. Календар, який слід використовувати під час обчислення нової дати. Якщо календар не вказано, стандартним для поточного ресурсу є календар ресурсу або для поточного завдання – календар завдання або стандартний календар, якщо немає календаря завдання. Для Project Server використовуватиметься стандартний календар незалежно від того, який календар зазначено в рядку календаря . У разі використання цієї функції у формулі, створеній у застосунку Project Web App, а також під час порівняння її з аналогічною формулою, створеною у Project Professional, слід виконати перевірку, щоб переконатися, що отримано очікувані результати.

ProjDateConv

Перетворює значення на дату.

Синтаксис

ProjDateConv(вираз, формат_дати)

вираз  Необхідні; Варіант. Вираз, який потрібно перетворити на дату.

формат дати  Необов'язково; Довге ціле. За замовчуванням використовується формат дати pjDateDefault, але ви можете замінити одну з таких констант pjDateFormat (формат дати, застосований 25.09.07 о 12:33):

• pjDateDefault – стандартний формат. Його можна задати в діалоговому вікні Параметри (меню Знаряддя) на вкладці Вигляд.

• pjDate_mm_dd_yy_hh_mmAM: 25.09.07 12:33

• pjDate_mm_dd_yy: 25.09.07

• pjDate_mm_dd_yyyy: 25.09.2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: 25 вересня 2007, 12:33

• pjDate_mmmm_dd_yyyy: 25 вересня 2007

• pjDate_mmm_dd_hh_mmAM: 25 вер 12:33

• pjDate_mmm_dd_yyy: 25 вер, '07

• pjDate_mmmm_dd: 25 вересня

• pjDate_mmm_dd: 25 вер

• pjDate_ddd_mm_dd_yy_hh_mmAM: вт 25.09.07 12:33

• pjDate_ddd_mm_dd_yy: вт 9/25/07

• pjDate_ddd_mmm_dd_yyy: вт 25 вер '07

• pjDate_ddd_hh_mmAM: вт 12:33

• pjDate_mm_dd: 25.09

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33

• pjDate_ddd_mmm_dd: вт 25 вер

• pjDate_ddd_mm_dd: вт 25.09

• pjDate_ddd_dd: вт 25

• pjDate_Www_dd: Т40.2

• pjDate_Www_dd_yy_hh_mmAM: Т40.2.07 12:33

ProjDateDiff

Повертає тривалість між двома датами у хвилинах.

Синтаксис

ProjDateDiff(дата1, дата2, календар)

дата1  Необхідні; Варіант. Дата, яка використовується як початок тривалості.

date2  Необхідні; Варіант. Дата, яка використовується як кінець тривалості.

Календар  Календар, який використовується під час обчислення тривалості. Якщо календар не задано, за промовчанням для поточного ресурсу використовується календар ресурсів, а поточного завдання – календар завдань або стандартний календар, якщо календар завдань відсутній. Якщо календар не вказано, за замовчуванням для поточного ресурсу використовується календар ресурсу або для поточного завдання, календар завдання (або стандартний календар, якщо для Project Server немає календаря завдання, використовуватиметься стандартний календар незалежно від того, який календар указано в рядку календаря . У разі використання цієї функції у формулі, створеній у застосунку Project Web App, а також під час порівняння її з аналогічною формулою, створеною у Project Professional, слід виконати перевірку, щоб переконатися, що отримано очікувані результати.

ProjDateSub

Повертає дату, яка передує іншій даті на вказану тривалість.

Синтаксис

ProjDateSub(дата, тривалість, календар)

Дата  Необхідні; Варіант. Вихідна дата, від якої віднімається тривалість .

тривалість  Необхідні; Варіант. Тривалість віднімання від дати.

Календар  Календар, який використовується під час обчислення тривалості. Календар, який слід використовувати під час обчислення різниці дат. Якщо календар не вказано, стандартним для поточного ресурсу є календар ресурсу або для поточного завдання – календар завдання (або стандартний календар, якщо немає календаря завдання). Для Project Server використовуватиметься стандартний календар незалежно від того, який календар зазначено в рядку календаря . У разі використання цієї функції у формулі, створеній у застосунку Project Web App, а також під час порівняння її з аналогічною формулою, створеною у Project Professional, слід виконати перевірку, щоб переконатися, що отримано очікувані результати.

ProjDateValue

Повертає значення дати у виразі.

Синтаксис

ProjDateValue(вираз)

вираз  Необхідні; Варіант. Вираз, який буде представлено як дату.

ProjDurConv

Перетворює вираз на значення тривалості у вказаних одиницях.

Синтаксис

ProjDurConv(вираз, одиниці_тривалості)

вираз  Необхідні; Варіант. Вираз, який потрібно перетворити на тривалість.

durationunits  Необов'язково; Довге ціле. Одиниці вимірювання, які виражали тривалість. Якщо значення durationunits не вказано, значення за промовчанням – це тип одиниць, указаний у параметрі Тривалість , на вкладці Розклад діалогового вікна Параметри (меню Знаряддя ). Одиниці тривалості можуть бути однією з таких констант pjFormatUnit :

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Повертає тривалість у хвилинах.

Синтаксис

ProjDurValue(тривалість)

тривалість  Необхідні; Варіант. Тривалість, виражена у хвилинах.

Second

Повертає значення типу Variant (Integer), яким задається ціле число в діапазоні від 0 до 59 включно, і яке позначає секунду у хвилині.

Синтаксис

Second(час)

Час  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти час. Якщо аргумент time містить Null-значення, повертається значення Null .

Time

Повертає значення типу Variant (Date), що вказує поточний системний час.

Синтаксис

Time

Timer

Повертає значення типу Single, що представляє кількість секунд, які минули від півночі.

Синтаксис

Timer

TimeSerial

Повертає значення типу Variant (Date), яке містить час певної години, хвилини та секунди.

Синтаксис

TimeSerial (години, хвилини, секунди)

Години  Необхідні; Variant (Integer). Число від 0 (12:00) до 23 (23:00) включно або числовий вираз.

Хвилин  Необхідні; Variant (Integer). Будь-який числовий вираз.

Другий  Необхідні; Variant (Integer). Будь-який числовий вираз.

TimeValue

Повертає значення типу Variant (Date), що містить час.

Синтаксис

TimeValue(час)

Час  Необхідні; зазвичай рядковий вираз, який представляє час із 0:00:00 (12:00:00) до 23:59:59 (23:59:59) включно. Однак час також може бути будь-яким виразом, який представляє час у цьому діапазоні. Якщо аргумент time містить Null-значення, повертається значення Null .

Weekday

Повертає значення типу Variant (Integer), яке містить ціле число, що позначає день тижня.

Синтаксис

Weekday(дата[, перший_день_тижня])

Дата  Необхідні; Варіант, числовий вираз, рядковий вираз будь-якої комбінації, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

firstdayofweek  Необов'язково; константа, яка визначає перший день тижня. Якщо це значення не задано, вважається, що це неділя.

Year

Повертає значення типу Variant (Integer), яке містить ціле число, що позначає рік.

Синтаксис

Year (дата)

Дата  Необхідні; будь-який варіант, числовий вираз, рядковий вираз або будь-яка комбінація, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null .

Загальні функції

Choose

Вибирає та повертає значення зі списку аргументів.

Синтаксис

Choose(індекс, варіант-1[, варіант-2, ... [, варіант-n]])

<c0>індекс</c0> – обов’язковий параметр.  Числовий вираз або поле, результатом якого є значення від 1 до кількості можливих варіантів.

Вибір  Необхідні; Вираз варіанта , який містить один із можливих варіантів.

IIf

Повертає одну з двох частин, залежно від результату обчислення виразу.

Синтаксис

IIf(вираз, якщо_істина, якщо_хибність)

expr  Необхідні; Вираз варіанта , який потрібно обчислити.

якщо_істина  Необхідні; значення або вираз, який повертається, якщо відповідний вираз має значення True.

якщо_хибність  Необхідні; значення або вираз, який повертається, якщо відповідний виразмає значення False.

IsNumeric

Повертає значення типу Boolean, яке вказує на те, чи можна отримати в результаті обчислення виразу число.

Синтаксис

IsNumeric(вираз)

вираз  Необхідні; Варіант , що містить числовий вираз або рядковий вираз.

IsNull

Повертає значення типу Boolean, яке вказує на те, чи справді вираз не містить припустимі дані (значення Null).

Синтаксис

IsNull(вираз)

вираз  Необхідні; Варіант , що містить числовий вираз або рядковий вираз.

Switch

Аналізує список виразів і повертає значення Variant або вираз, пов’язаний із першим істинним виразом у списку (значення True).

Синтаксис

Switch(вираз-1, значення-1[, вираз-2, значення-2, ... [, вираз-n,значення-n]])

Математичні функції

Abs

Повертає значення того ж типу, як і отримане значення, яке дорівнює модулю числа.

Синтаксис

Abs(число)

Номер  Необхідні; будь-який припустимий числовий вираз. Якщо число містить Null-значення, повертається значення Null ; якщо це неініціалізована змінна, повертається нуль.

Atn

Повертає значення типу Double, яке дорівнює арктангенсу числа.

Синтаксис

Atn(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз.

Cos

Повертає значення типу Double, яке дорівнює косинусу кута.

Синтаксис

Cos(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз, який виражає кут у радіанах.

Exp

Повертає значення типу Double, яке дорівнює e (основі натурального логарифма) у певній степені.

Синтаксис

Exp(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз.

Fix

Повертає цілу частину числа. Якщо число від’ємне, повертає перше від’ємне ціле число, більше або рівне параметру число.

Синтаксис

Fix(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз. Якщо число містить Null-значення, повертається значення Null .

Int

Повертає цілу частину числа. Якщо число від’ємне, повертає перше від’ємне ціле число, менше або рівне параметру число.

Синтаксис

Int(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз. Якщо число містить Null-значення, повертається значення Null .

Log

Повертає значення типу Double, яке дорівнює натуральному логарифму числа.

Синтаксис

Log(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз, більший за нуль.

Rnd

Повертає значення типу Single, яке містить випадкове число.

Синтаксис

Rnd(число)

Номер  Необхідні; Один або будь-який припустимий числовий вираз.

Sgn

Повертає представлення числа у вигляді значення типу Integer (String), яке позначає знак числа.

Синтаксис

Sgn(число)

Номер  Необхідні; будь-який припустимий числовий вираз.

Повертає значення за таким принципом:

• якщо число більше нуля, Sgn повертає 1;

• якщо число дорівнює нулю, Sgn повертає 0;

• якщо число менше нуля, Sgn повертає –1.

Sin

Повертає значення типу Double, яке дорівнює косинусу кута.

Синтаксис

Sin(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз, який виражає кут у радіанах.

Sqr

Повертає значення типу Double, яке дорівнює кореню квадратному числа.

Синтаксис

Sqr(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз, який дорівнює або більший за нуль.

Tan

Повертає значення типу Double, яке дорівнює тангенсу кута.

Синтаксис

Tan(число)

Номер  Необхідні; Подвійний або будь-який припустимий числовий вираз, який виражає кут у радіанах.

Текстові функції

Asc

Повертає значення типу Integer, що є кодом символу, який відповідає першій букві в рядку.

Синтаксис

Asc(рядок)

Рядок  Будь-який припустимий рядковий вираз.

Chr

Повертає значення типу String, яке містить символ, пов’язаний з указаним кодом символу.

Синтаксис

Chr(код_символу)

Снагсоле  Довге ціле, що визначає символ.

Format

Повертає значення типу Variant (String), яке містить вираз, відформатований відповідно до інструкцій, які містяться у виразі форматування.

Синтаксис

Format(вираз[, формат[, перший_день_тижня[, перший_тиждень_року]]])

вираз  Необхідні; будь-якого припустимого виразу.

Формат  Необов'язково; припустимий іменований або користувацький вираз формату.

firstdayofweek  Необов'язково; Константа , яка визначає перший день тижня.

firstweekofyear  Необов'язково; Константа , яка визначає перший тиждень року.

Instr

Повертає значення типу Variant (Long), яке задає положення першого входження одного рядка всередині іншого.

Синтаксис

Instr([початок, ]рядок1, рядок2[, порівняння])

Почати  Необов'язково; числовий вираз, який встановлює початкове положення для кожного пошуку. Якщо його не задано, пошук починається з першого символу. Якщо аргумент start містить Null-значення, станеться помилка. Аргумент start є обов’язковим, якщо задано аргумент compare.

string1  Необхідні; рядковий вираз, який шукається.

string2  Необхідні; шуканий рядковий вираз.

compare  Необов'язково; визначає тип порівняння рядків. Якщо аргумент compare має Null-значення, стається помилка. Якщо аргумент compare не вказано, параметр Optioncompare визначає тип порівняння.

LCase

Повертає значення типу String, перетворене на рядок, записаний малими буквами.

Синтаксис

LCase(рядок)

рядок   Необхідні; будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .

Left

Повертає значення типу Variant (String), яке містить указану кількість символів ліворуч від рядка.

Синтаксис

Left(рядок, довжина)

рядок  Обов’язковий аргумент. Вираз, що повертає рядок, з якого повертаються крайні зліва символи. Якщо рядок містить Null-значення, повертається значення Null .

довжина  Необхідні; Variant (Long). Числовий вираз, що вказує кількість символів, які потрібно повернути. Якщо він дорівнює 0, повертається рядок нульової довжини (""). Якщо його значення більше або рівне кількості символів в аргументі рядок, повертається весь рядок.

Len

Повертає значення типу Long, яке дорівнює кількості символів у рядку або кількості байт, які необхідні для зберігання змінної.

Синтаксис

Len(рядок, ім’я_змінної)

рядок  Будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .

ім'я_varname  Будь-яке припустиме ім'я змінної. Якщо ім'я varname містить Null-значення, повертається значення Null . Якщо аргумент varname – варіант,Len вважає його таким самим, як і рядок , і завжди повертає кількість символів, які він містить.

LTrim

Повертає значення типу Variant (String), що містить копію указаного рядка без пробілів на початку.

Синтаксис

LTrim(рядок)

рядок  Необхідні; будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .

Mid

Повертає значення типу Variant (String), яке містить указану кількість символів у рядку.

Синтаксис

Mid(рядок, початок[, довжина])

рядок  Необхідні; рядковий вираз, з якого повертаються символи. Якщо рядок містить Null-значення, повертається значення Null .

Почати  Необхідні; Довге ціле. Позиція символу в рядку , з якого починається частина, яку потрібно взяти. Якщо значення аргументу «початок » більше за кількість символів у рядку, функція Mid повертає рядок нульової довжини ("").

довжина  Необов'язково; Variant (Long). Кількість символів, які потрібно повернути. Якщо цей аргумент пропущено або в тексті менше символів довжини (включно з символом на початковому екрані), повертаються всі символи від початкової позиції до кінця рядка.

Right

Повертає значення типу Variant (String), яке містить указану кількість символів праворуч від рядка.

Синтаксис

Right(рядок, довжина)

рядок  Необхідні; рядковий вираз, з якого повертаються крайні праві символи. Якщо рядок містить Null-значення, повертається значення Null .

довжина  Необхідні; Variant (Long). Числовий вираз, що вказує кількість символів, які потрібно повернути. Якщо він дорівнює 0, повертається рядок нульової довжини (""). Якщо кількість символів у рядку дорівнює або більша, повертається весь рядок.

RTrim

Повертає значення типу Variant (String), що містить копію указаного рядка без пробілів вкінці.

Синтаксис

RTrim(рядок)

рядок  Необхідні; будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .

Space

Повертає значення типу Variant (String), яке складається з указаної кількості пробілів.

Синтаксис

Space(кількість)

Номер  Необхідні; кількість пробілів у рядку.

StrComp

Повертає представлення числа у вигляді значення типу Integer (String), яке позначає результат порівняння рядка.

Синтаксис

StrComp(рядок1, рядок2[, порівняння])

string1  Необхідні; будь-який припустимий рядковий вираз.

string2  Необхідні; будь-який припустимий рядковий вираз.

compare  Необов'язково; визначає тип порівняння рядків. Якщо аргумент compareмає Null-значення, стається помилка.

StrConv

Повертає значення типу Variant (String), перетворене зазначеним чином.

Синтаксис

StrConv(рядок, перетворення, код мови)

рядок  Необхідні; рядковий вираз, який потрібно перетворити.

Перетворення  Необхідні; Ціле число. Сума значень, що визначає, який тип перетворення потрібно виконати.

LCID  Необов'язково; localeID, якщо він відрізняється від system LocaleID. (Код локалізації системи – це стандартний ідентифікатор.)

String

Повертає значення типу Variant (String), яке містить повторюваний рядок символів заданої довжини.

Синтаксис

String(число, символ)

Номер  Необхідні; Довге ціле. Довжина повернутого рядка. Якщо число містить Null-значення, повертається значення Null .

character  Необхідні; Варіант. Код символу, що вказує символ або рядковий вираз, перший символ якого використовується для побудови рядка, що повертається. Якщо символ містить Null-значення, повертається значення Null .

Trim

Повертає значення типу Variant (String), що містить копію указаного рядка без пробілів на початку або вкінці.

Синтаксис

Trim(рядок)

рядок  Необхідні; будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .

UCase

Повертає значення типу Variant (String), яке містить заданий рядок, перетворений на текст малими буквами.

Синтаксис

UCase(рядок)

рядок  Необхідні; будь-який припустимий рядковий вираз. Якщо рядок містить Null-значення, повертається значення Null .