Эти функции используются в формулах для вычисления значений настраиваемых полей.
: Чтобы ввести формулу в настраиваемое поле, перейдите на вкладку Проект и в группе Свойства щелкните Настраиваемые поля. В диалоговом окне Настраиваемые поля нажмите кнопку Формула.
Общие сведения о функциях 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,9228162514264337593543950335. Наименьшее допустимое ненулевое число — 0,0000000000000000000000000001.
Chr
Возвращает значение типа String, которое содержит символ, связанный с указанным кодом.
Синтаксис
Chr( кодировка )
charcode Объект Long, идентифицирующий символ.
CInt
Приводит выражение к типу данных Integer.
Синтаксис
CInt( выражение )
<c0>выражение</c0> — любое числовое выражение в диапазоне от –32 768 до 32 767. Дробные числа округляются.
CLng
Приводит выражение к типу данных Long.
Синтаксис
CLng( выражение )
<c0>выражение</c0> — любое числовое выражение в диапазоне от –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 для числовых значений. Тот же диапазон, что и Строка для нечисловых значений.
DateSerial
Возвращает значение типа Variant (Date) для указанного года, месяца и дня.
Синтаксис
DateSerial( год, месяц, день )
Год Обязательно; Целое число. Число от 100 до 9999 включительно или числовое выражение.
Месяц Обязательно; Целое число. Любое числовое выражение.
день Обязательно; Целое число. Любое числовое выражение.
DateValue
Возвращает значение типа Variant (Date).
Синтаксис
DateValue( дата )
Дата Обязательно; обычно строковое выражение, представляющее дату с 1 января 100 г. по 31 декабря 9999 г. Однако датой также может быть любое выражение, которое может представлять дату, время или дату и время в этом диапазоне.
Day
Возвращает значение типа Variant (Integer), указывающее целое число в диапазоне от 1 до 31 включительно, которое представляет день месяца.
Синтаксис
Day( дата)
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
Hex
Возвращает значение типа String, представляющее собой шестнадцатеричное значение числа.
Синтаксис
Hex( число )
Число Обязательно; любое допустимое строковое или числовое выражение.
Hour
Возвращает значение типа Variant (Integer), которое указывает целое число от 0 до 23 включительно и соответствует часу дня.
Синтаксис
Hour( время )
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение NULL, возвращается значение NULL .
Minute
Возвращает значение типа Variant (Integer), которое указывает целое число от 0 до 59 включительно и соответствует минуте часа.
Синтаксис
Minute( время )
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение NULL, возвращается значение NULL .
Month
Возвращает значение типа Variant (Integer), которое указывает целое число от 1 до 12 включительно и соответствует месяцу года.
Синтаксис
Month( дата)
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если date содержит значение NULL, возвращается значение NULL .
Oct
Возвращает значение типа Variant (String), представляющее собой восьмеричное значение числа.
Синтаксис
Oct (число )
Число Обязательно; любое допустимое строковое или числовое выражение.
ProjDateConv
Преобразует значение в дату.
Синтаксис
ProjDateConv( выражение, формат_даты )
выражение Обязательно; Variant. Выражение для преобразования в дату.
формат даты Дополнительные; Долго. Формат даты по умолчанию — pjDateDefault, но можно заменить одну из следующих констант pjDateFormat (формат даты применяется 25.09.07 в 12:33 вечера):
-
pjDateDefault — формат по умолчанию. Задается на вкладке Вид диалогового окна Параметры (меню Сервис).
-
pjDate_mm_dd_yy_hh_mmAM: 09.25.07 12:33
-
pjDate_mm_dd_yy: 09.25.07
-
pjDate_mm_dd_yyyy: 09.25.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: Вт 09.25.07 12:33
-
pjDate_ddd_mm_dd_yy: Вт 09.25.07
-
pjDate_ddd_mmm_dd_yyy: Вт Сен 25, '07
-
pjDate_ddd_hh_mmAM: Вт 12:33
-
pjDate_mm_dd: 09.25
-
pjDate_dd: 25
-
pjDate_hh_mmAM: 12:33
-
pjDate_ddd_mmm_dd: Вт Сен 25
-
pjDate_ddd_mm_dd: Вт 09.25
-
pjDate_ddd_dd: Вт 25
-
pjDate_Www_dd: Н40.2
-
pjDate_Www_dd_yy_hh_mmAM: Н40.02.07 12:33
ProjDurConv
Преобразует выражение в значение длительности в указанных единицах.
Синтаксис
ProjDurConv( выражение, единицы_длительности )
выражение Обязательно; Variant. Выражение, преобразуемое в длительность.
durationunits Дополнительные; Долго. Единицы измерения, используемые для выражения длительности. Если параметр 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( время )
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение NULL, возвращается значение NULL .
Str
Возвращает значение типа Variant (String), представляющее число.
Синтаксис
Str( число )
Число Обязательно; Long , содержащий любое допустимое числовое выражение.
StrConv
Возвращает значение типа Variant (String), преобразованное в соответствии с указанными параметрами.
Синтаксис
StrConv( строка, преобразование, LCID )
строка Обязательно; преобразуемое строковое выражение.
Преобразования Обязательно; Целое число. Сумма значений, указывающая тип выполняемого преобразования.
код_языка Дополнительные; LocaleID, если он отличается от системного 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 (11:59:59 вечера) включительно. Однако время также может быть любым выражением, которое представляет время в этом диапазоне. Если время содержит значение NULL, возвращается значение NULL .
Val
Возвращает числа, содержащиеся в строке в качестве числового значения соответствующего типа.
Синтаксис
Val( строка )
строка Обязательно; любое допустимое строковое выражение.
Weekday
Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.
Синтаксис
Weekday( дата[, первый_день_недели] )
Дата Обязательно; Variant, числовое выражение, строковое выражение любой комбинации, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
первый_день_недели Дополнительные; константы, указывающей первый день недели. Если не указано, предполагается воскресенье.
Year
Возвращает значение типа Variant (Integer), содержащее целое число, которое обозначает год.
Синтаксис
Year( дата )
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
Функции даты и времени
CDate
Приводит выражение к типу данных Date.
Синтаксис
CDate( выражение )
выражение Любое допустимое выражение даты.
Date
Возвращает значение типа Variant (Date), содержащее текущую системную дату.
Синтаксис
Date
DateAdd
Возвращает значение типа Variant (Date), содержащее результат прибавления к дате указанного интервала времени.
Синтаксис
DateAdd( интервал, число, дата )
<c0>интервал</c0> — обязательный аргумент. Строковое выражение, обозначающее интервал времени, который требуется добавить, например "m" или "d".
Число Числовое выражение, обозначающее количество интервалов, которые требуется добавить. Может принимать положительное (для получения будущих дат) или отрицательное (для получения прошедших дат) значение.
дата Обязательно; Variant (Date) или литерал, представляющий дату, к которой добавляется интервал.
DateDiff
Возвращает значение типа Variant (Long), указывающее на количество интервалов времени между двумя указанными датами.
Синтаксис
DateDiff( интервал, дата1, дата2[, первый_день_недели[, первая_неделя_года]] )
<c0>интервал</c0> — обязательный аргумент. Строковое выражение, которое обозначает интервал времени, используемый для вычисления разницы значений дата1 и дата2.
date1, date2 Обязательно; Variant (Date). Две даты, которые необходимо использовать при вычислении.
первый_день_недели Дополнительные; константы, указывающей первый день недели. Если не указано, предполагается воскресенье.
первая_неделя_года Дополнительные; константы, указывающей первую неделю года. Если не указано, предполагается, что первая неделя будет неделей, в которую приходится 1 января.
DatePart
Возвращает значение типа Variant (Integer), содержащее указанную часть заданной даты.
Синтаксис
DatePart( интервал, дата[, первый_день_недели[, первая_неделя_года]] )
<c0>интервал</c0> — обязательный аргумент. Строковое выражение, обозначающее интервал времени, который требуется возвратить.
Дата Значение, которое требуется вычислить.
первый_день_недели Дополнительные; константы, указывающей первый день недели. Если не указано, предполагается воскресенье.
первая_неделя_года Дополнительные; константы, указывающей первую неделю года. Если не указано, предполагается, что первая неделя будет в той неделе, в которой приходится 1 января.
DateSerial
Возвращает значение типа Variant (Date) для указанного года, месяца и дня.
Синтаксис
DateSerial( год, месяц, день )
Год Обязательно; Целое число. Число от 100 до 9999 включительно или числовое выражение.
Месяц Обязательно; Целое число. Любое числовое выражение.
день Обязательно; Целое число. Любое числовое выражение.
DateValue
Возвращает значение типа Variant (Date).
Синтаксис
DateValue( дата)
Дата Обязательно; обычно строковое выражение, представляющее дату с 1 января 100 г. по 31 декабря 9999 г. Однако датой также может быть любое выражение, которое может представлять дату, время или дату и время в этом диапазоне.
Day
Возвращает значение типа Variant (Integer), указывающее целое число в диапазоне от 1 до 31 включительно, которое представляет день месяца.
Синтаксис
Day( дата)
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
Hour
Возвращает значение типа Variant (Integer), которое указывает целое число от 0 до 23 включительно и соответствует часу дня.
Синтаксис
Hour( время )
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение NULL, возвращается значение NULL .
IsDate
Возвращает значение типа Boolean, указывающее на возможность преобразования выражения в дату.
Синтаксис
IsDate( выражение )
выражение Обязательно; любой вариант Variant , содержащий выражение даты или строковое выражение, распознаваемое как дата или время.
Minute
Возвращает значение типа Variant (Integer), которое указывает целое число от 0 до 59 включительно и соответствует минуте часа.
Синтаксис
Minute( время)
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение NULL, возвращается значение NULL .
Month
Возвращает значение типа Variant (Integer), которое указывает целое число от 1 до 12 включительно и соответствует месяцу года.
Синтаксис
Month( дата)
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если date содержит значение NULL, возвращается значение NULL .
Now
Возвращает значение типа Variant (Date), которое указывает текущую дату и время в соответствии с системной датой и системным временем на компьютере пользователя.
Синтаксис
Now
ProjDateAdd
Добавляет длительность к дате, чтобы возвратить новую дату.
Синтаксис
ProjDateAdd( дата, длительность, календарь )
Дата Обязательно; Variant. Исходная дата, к которой добавляется длительность .
длительность Обязательно; Variant. Длительность добавления к дате.
Календарь Календарь, который требуется использовать для расчета длительности. Календарь, используемый при вычислении новой даты. Если календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса или для текущей задачи, календарь задачи или стандартный календарь, если календарь задачи отсутствует. Для Project Server будет использоваться стандартный календарь, независимо от того, какой календарь указан в строке календаря . При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.
ProjDateConv
Преобразует значение в дату.
Синтаксис
ProjDateConv( выражение, формат_даты )
выражение Обязательно; Variant. Выражение для преобразования в дату.
формат даты Дополнительные; Долго. Формат даты по умолчанию — pjDateDefault, но можно заменить одну из следующих констант pjDateFormat (формат даты применяется 25.09.07 в 12:33 вечера):
-
pjDateDefault — формат по умолчанию. Задается на вкладке Вид диалогового окна Параметры (меню Сервис).
-
pjDate_mm_dd_yy_hh_mmAM: 09.25.07 12:33
-
pjDate_mm_dd_yy: 09.25.07
-
pjDate_mm_dd_yyyy: 09.25.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: Вт 09.25.07 12:33
-
pjDate_ddd_mm_dd_yy: Вт 09.25.03
-
pjDate_ddd_mmm_dd_yyy: Вт Сен 25, '07
-
pjDate_ddd_hh_mmAM: Вт 12:33
-
pjDate_mm_dd: 09.25
-
pjDate_dd: 25
-
pjDate_hh_mmAM: 12:33
-
pjDate_ddd_mmm_dd: Вт Сен 25
-
pjDate_ddd_mm_dd: Вт 09.25
-
pjDate_ddd_dd: Вт 25
-
pjDate_Www_dd: Н40.2
-
pjDate_Www_dd_yy_hh_mmAM: Н40.02.07 12:33
ProjDateDiff
Возвращает длительность интервала времени между двумя датами в минутах.
Синтаксис
ProjDateDiff( дата1, дата2, календарь )
date1 Обязательно; Variant. Дата, используемая в качестве начала длительности.
date2 Обязательно; Variant. Дата, используемая в качестве окончания длительности.
Календарь Календарь, который требуется использовать для расчета длительности. Если аргумент календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса, а для текущей задачи — календарь задачи (или стандартный календарь, если календарь задачи не задан). Если календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса или для текущей задачи, календарь задачи (или стандартный календарь, если нет календаря задач Для Project Server, будет использоваться стандартный календарь, независимо от того, какой календарь указан в строке календаря ). При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.
ProjDateSub
Возвращает дату, которая предшествует другой дате на указанную длительность.
Синтаксис
ProjDateSub( дата, длительность, календарь )
Дата Обязательно; Variant. Исходная дата, из которой вычитается длительность .
длительность Обязательно; Variant. Длительность, вычитаемая из даты.
Календарь Календарь, который требуется использовать для расчета длительности. Календарь, используемый при вычислении разницы в датах. Если календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса или для текущей задачи, календарь задачи (или стандартный календарь, если календарь задачи отсутствует). Для Project Server будет использоваться стандартный календарь, независимо от того, какой календарь указан в строке календаря . При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.
ProjDateValue
Возвращает значение даты для выражения.
Синтаксис
ProjDateValue(выражение)
выражение Обязательно; Variant. Выражение, которое должно быть представлено в виде даты.
ProjDurConv
Преобразует выражение в значение длительности в указанных единицах.
Синтаксис
ProjDurConv( выражение, единицы_длительности )
выражение Обязательно; Variant. Выражение, преобразуемое в длительность.
durationunits Дополнительные; Долго. Единицы измерения, используемые для выражения длительности. Если параметр 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( длительность )
длительность Обязательно; Variant. Длительность, выраженная в минутах.
Second
Возвращает значение типа Variant (Integer), которое указывает целое число от 0 до 59 включительно и соответствует секундам минуты.
Синтаксис
Second( время )
Время Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять время. Если время содержит значение 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 (11:59:59 вечера) включительно. Однако время также может быть любым выражением, которое представляет время в этом диапазоне. Если время содержит значение NULL, возвращается значение NULL .
Weekday
Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.
Синтаксис
Weekday( дата[, первый_день_недели] )
Дата Обязательно; Variant, числовое выражение, строковое выражение любой комбинации, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
первый_день_недели Дополнительные; константы, указывающей первый день недели. Если не указано, предполагается воскресенье.
Year
Возвращает значение типа Variant (Integer), содержащее целое число, которое обозначает год.
Syntax
Year( год)
Дата Обязательно; любой вариант Variant, числовое выражение, строковое выражение или любое сочетание, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL .
Общие функции
Choose
Выбирает и возвращает значение из списка аргументов.
Синтаксис
Choose( индекс, вариант-1[, вариант-2, ... [, вариант-n]])
<c0>индекс</c0> — обязательный аргумент. Числовое выражение или поле со значением в диапазоне от 1 до числа доступных вариантов выбора.
<c0>вариант</c0> — обязательный аргумент. Выражение типа Variant, содержащее один из возможных вариантов выбора.
IIf
Возвращает одну из двух частей в зависимости от вычисленного значения выражения.
Синтаксис
IIf( выражение, если_истина, если_ложь )
<c0>выражение</c0> — обязательный аргумент. Выражение типа Variant, которое требуется вычислить.
<c0>если_истина</c0> — обязательный аргумент. Значение или выражение, которое возвращается, если соответствующее выражение принимает значение True.
<c0>если_ложь</c0> — обязательный аргумент. Значение или выражение, которое возвращается, если соответствующее выражение принимает значение False.
IsNumeric
Возвращает значение типа Boolean, показывающее, является ли выражение числовым.
Синтаксис
IsNumeric( выражение)
выражение Обязательно; Variant , содержащий числовое или строковое выражение.
IsNull
Возвращает значение типа Boolean, указывающее на содержание в выражении недопустимых данных (Null).
Синтаксис
IsNull( выражение )
выражение Обязательно; Variant , содержащий числовое или строковое выражение.
Switch
Вычисляет список выражений и возвращает значение типа Variant или выражение, связанное с первым выражением в списке, принимающим значение True.
Синтаксис
Switch( выражение-1, значение-1[, выражение-2, значение-2, ... [, выражение-n,значение-n]] )
Математические функции
Abs
Возвращает значение того же типа, который был передан в функцию, указывая абсолютное значение числа.
Синтаксис
Abs( число )
Число Обязательно; любое допустимое числовое выражение. Если число содержит значение NULL, возвращается значение NULL ; Если это неинициализированная переменная, возвращается ноль.
Atn
Возвращает значение типа Double, указывающее арктангенс числа.
Синтаксис
Atn( число )
Число Значение типа Double или любое допустимое числовое выражение.
Cos
Возвращает значение типа Double, указывающее косинус угла.
Синтаксис
Cos( число )
Число Значение типа Double или любое допустимое числовое выражение, соответствующее значению угла в радианах.
Exp
Возвращает значение типа Double, указывающее константу e (основание натурального логарифма), возведенную в степень.
Синтаксис
Exp( число )
Число Значение типа Double или любое допустимое числовое выражение.
Fix
Возвращает целую часть числа. Если число отрицательное, возвращается первое отрицательное целое, которое равно или больше значения число.
Синтаксис
Fix( число )
Число Значение типа Double или любое допустимое числовое выражение. Если аргумент число содержит Null, возвращается значение Null.
Int
Возвращает целую часть числа. Если значение число отрицательное, возвращается первое отрицательное целое, которое равно или меньше значения число.
Синтаксис
Int( число )
Число Значение типа Double или любое допустимое числовое выражение. Если аргумент число содержит Null, возвращается значение Null.
Log
Возвращает значение типа Double, указывающее натуральный логарифм числа.
Синтаксис
Log( число )
Число Значение типа Double или любое допустимое числовое выражение больше нуля.
Rnd
Возвращает значение типа Single, содержащее случайное число.
Синтаксис
Rnd( число )
Число Значение типа Single или любое допустимое числовое выражение.
Sgn
Возвращает значение типа Variant (Integer), указывающее символ числа.
Синтаксис
Sgn( число )
Число Обязательно; любое допустимое числовое выражение.
Возвращает следующие значения.
-
Если число больше нуля, функция Sgn возвращает 1.
-
Если число равно нулю, функция Sgn возвращает 0.
-
Если число меньше нуля, функция Sgn возвращает -1.
Sin
Возвращает значение типа Double, указывающее синус угла.
Синтаксис
Sin( число )
Число Значение типа Double или любое допустимое числовое выражение, соответствующее значению угла в радианах.
Sqr
Возвращает значение типа Double, указывающее квадратный корень числа.
Синтаксис
Sqr( число )
Число Значение типа Double или любое допустимое числовое выражение, большее или равное нулю.
Tan
Возвращает значение типа Double, указывающее тангенс угла.
Синтаксис
Tan( число )
Число Значение типа Double или любое допустимое числовое выражение, соответствующее значению угла в радианах.
Текстовые функции
Asc
Возвращает значение типа Integer, которое является кодом символа, соответствующего первой букве строки.
Синтаксис
Asc( строка )
Строка Любое допустимое строковое выражение.
Chr
Возвращает значение типа String, которое содержит символ, связанный с указанным кодом.
Синтаксис
Chr( кодировка )
charcode Объект Long, идентифицирующий символ.
Format
Возвращает значение типа Variant (String), которое содержит выражение, отформатированное в соответствии с указаниями, содержащимися в выражении формата.
Синтаксис
Format( выражение[, формат[, первый_день_недели[, первая_неделя_года]]] )
выражение Обязательно; любое допустимое выражение.
Формат Дополнительные; допустимое именованное или определяемое пользователем выражение формата.
первый_день_недели Дополнительные; Константой , указывающей первый день недели.
первая_неделя_года Дополнительные; Константой , указывающей первую неделю года.
Instr
Возвращает значение типа Variant (Long), определяющее положение первого вхождения одной строки в другую.
Синтаксис
Instr( [начало, ]строка1, строка2[, сравнение] )
<c0>начало</c0> — необязательный аргумент. Числовое выражение, которое задает начальное положение для каждого поиска. Если аргумент не задан, поиск начинается с первого символа. Если аргумент начало содержит значение Null, возникает ошибка. Если задан аргумент сравнение, аргумент начало является обязательным.
строка1 Обязательно; строковое выражение, для которого выполняется поиск.
строка2 Обязательно; запрошенное строковое выражение.
compare Дополнительные; указывает тип сравнения строк. Если параметр compare имеет значение Null, возникает ошибка. Если параметр сравнение опущен, параметр Сравнение параметров определяет тип сравнения.
LCase
Возвращает значение типа String, преобразованное в символы нижнего регистра
Синтаксис
LCase( строка )
строка Обязательно; любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .
Left
Возвращает значение типа Variant (String), содержащее указанное число символов с левой стороны строки.
Синтаксис
Left( строка, длина )
строка Обязательный аргумент. Строковое выражение, из левой части которого возвращаются символы. Если строка содержит значение NULL, возвращается значение NULL .
length Обязательно; Variant (Long). Числовое выражение, указывающее, сколько символов необходимо вернуть. Если значение равно 0, возвращается строка нулевой длины (""). Если оно больше числа символов в строке или равно ему, возвращается вся строка.
Len
Возвращает значение типа Long, содержащее число символов в строке или число байт, которое требуется для хранения переменной.
Синтаксис
Len( строка, имя_переменной )
строка Любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .
имя_переменной Любое допустимое имя переменной. Если в варнаме содержится значение NULL, возвращается значение NULL . Если варнаме является variant, Len обрабатывает его так же, как строка , и всегда возвращает количество символов, содержащихся в нем.
LTrim
Возвращает значение типа Variant (String), содержащее копию указанной строки без начальных пробелов.
Синтаксис
LTrim( string )
строка Обязательно; любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .
Mid
Возвращает значение типа Variant (String), содержащее указанное число символов строки.
Синтаксис
Mid( строка, начало[, длина] )
строка Обязательно; строковое выражение, из которого возвращаются символы. Если строка содержит значение NULL, возвращается значение NULL .
Начать Обязательно; Долго. Позиция символа в строке , с которой начинается часть, которую необходимо принять. Если start больше числа символов в строке, mid возвращает строку нулевой длины ("").
length Дополнительные; Variant (Long). Число возвращаемых символов. Если опущен или в тексте меньше символов длины (включая символ в начале), возвращаются все символы от начальной позиции до конца строки.
Right
Возвращает значение типа Variant (String), содержащее указанное количество символов с правой стороны строки.
Синтаксис
Right( строка, длина )
строка Обязательно; строковое выражение, из которого возвращаются крайне правые символы. Если строка содержит значение NULL, возвращается значение NULL .
length Обязательно; Variant (Long). Числовое выражение, указывающее, сколько символов необходимо вернуть. Если значение равно 0, возвращается строка нулевой длины (""). Если число символов в строке равно или больше, возвращается вся строка.
RTrim
Возвращает значение типа Variant (String), содержащее копию указанной строки без конечных пробелов.
Синтаксис
RTrim( строка )
строка Обязательно; любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .
Space
Возвращает значение типа Variant (String), состоящее из указанного количества пробелов.
Синтаксис
Space( число )
Число Обязательно; количество пробелов в строке.
StrComp
Возвращает значение типа Variant (Integer), указывающее результат сравнения строк.
Синтаксис
StrComp( строка1, строка2[, сравнение] )
строка1 Обязательно; любое допустимое строковое выражение.
строка2 Обязательно; любое допустимое строковое выражение.
compare Дополнительные; указывает тип сравнения строк. Если аргумент сравнения имеет значение Null, возникает ошибка.
StrConv
Возвращает значение типа Variant (String), преобразованное в соответствии с указанными параметрами.
Синтаксис
StrConv( строка, преобразование, LCID )
строка Обязательно; преобразуемое строковое выражение.
Преобразования Обязательно; Целое число. Сумма значений, указывающая тип выполняемого преобразования.
код_языка Дополнительные; LocaleID, если он отличается от системного LocaleID. (По умолчанию используется системный код языка.)
String
Возвращает значение типа Variant (String), содержащее строку повторяющихся символов указанной длины.
Синтаксис
String( число, символ )
Число Обязательно; Долго. Длина возвращаемой строки. Если аргумент число содержит Null, возвращается значение Null.
<c0>символ</c0>. Обязательно; Variant. Код символа, указывающий символ или строковое выражение, первый символ которого используется для построения возвращаемой строки. Если символ содержит значение NULL, возвращается значение NULL .
Trim
Возвращает значение типа Variant (String), содержащее копию указанной строки без начальных и конечных пробелов.
Синтаксис
Trim( строка )
строка Обязательно; любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .
UCase
Возвращает значение типа Variant (String), содержащее указанную строку, преобразованную в символы верхнего регистра.
Синтаксис
UCase( строка )
строка Обязательно; любое допустимое строковое выражение. Если строка содержит значение NULL, возвращается значение NULL .