Функции проекта для настраиваемых полей в классической версии Project
Applies ToКлассический клиент Project Online Project стандартный 2024 Project профессиональный 2021 Project стандартный 2021 Project профессиональный 2019 Project стандартный 2019 Project профессиональный 2016 Project стандартный 2016 Project профессиональный 2013 Project Server 2013 Project стандартный 2013

Эти функции используются в формулах для вычисления значений настраиваемых полей.

Чтобы ввести формулу в настраиваемое поле, перейдите на вкладку Проект и в группе Свойства щелкните Настраиваемые поля. В диалоговом окне Настраиваемые поля нажмите кнопку Формула.

Общие сведения о функциях 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 .

Нужна дополнительная помощь?

Нужны дополнительные параметры?

Изучите преимущества подписки, просмотрите учебные курсы, узнайте, как защитить свое устройство и т. д.

В сообществах можно задавать вопросы и отвечать на них, отправлять отзывы и консультироваться с экспертами разных профилей.