Функции проекта

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

Совет: Чтобы ввести формулу в настраиваемое поле в Project 2007, в меню Сервис выберите пункт Настройка, а затем — Поля. В диалоговом окне Настраиваемые поля нажмите кнопку Формула. В Project 2010 на вкладке Проект в группе Свойства выберите пункт Настраиваемые поля. В диалоговом окне Настраиваемые поля нажмите кнопку Формула.

Общие сведения о функциях 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( выражение )

выражение — любое значение типа Integer в диапазоне от 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( кодировка )

кодировка — число типа Long, которое определяет символ.

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( год, месяц, день )

год — обязательный аргумент типа Integer. Число от 100 до 9999 включительно или числовое выражение.

месяц — обязательный аргумент типа Integer. Любое числовое выражение.

день — обязательный аргумент типа Integer. Любое числовое выражение.

DateValue

Возвращает значение типа Variant (Date).

Синтаксис

DateValue( дата )

дата — обязательный аргумент; как правило, является строковым выражением, обозначающим дату в диапазоне от 1 января 100 г. до 31 декабря 9999 г. Но аргумент дата также может быть представлен любым выражением, обозначающим дату, время или дату и время в указанном диапазоне.

Day

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

Синтаксис

Day( дата)

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит 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, числовым, строковым выражением или любым сочетанием, которое может обозначать время. Если аргумент дата содержит Null, возвращается значение Null.

Oct

Возвращает значение типа Variant (String), представляющее собой восьмеричное значение числа.

Синтаксис

Oct (число )

число — обязательный аргумент, который является любым допустимым строковым или числовым выражением.

ProjDateConv

Преобразует значение в дату.

Синтаксис

ProjDateConv( выражение, формат_даты )

выражение — обязательный аргумент типа Variant. Выражение для преобразования к типу «дата».

формат_даты — необязательный аргумент типа Long. По умолчанию используется формат даты pjDateDefault, но его можно заменить на одну из перечисленных ниже констант pjDateFormat (формат даты применен 25.09.2007 в 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. Выражение для преобразования в значение длительности.

единицы_длительности — необязательный аргумент типа Long. Единицы, используемые для выражения длительности. Если значение единицы_длительности не указано, то по умолчанию используется тип единиц, заданный в параметре Длительность вводится в на вкладке Планирование диалогового окна Параметры (меню Сервис). Аргумент единицы_длительности может быть представлен одной из следующих констант 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 )

строка — обязательный аргумент, который является строковым выражением для преобразования.

преобразование — обязательный аргумент типа Integer. Совокупность значений, определяющих тип преобразования.

LCID — необязательный аргумент, который является кодом языка, если он отличается от системного. (По умолчанию используется системный код языка.)

TimeSerial

Возвращает значение типа Variant (Date), содержащее время для определенных значений часов, минут и секунд.

Синтаксис

TimeSerial( часы, минуты, секунды )

час — обязательный аргумент типа Variant (Integer). Число в диапазоне от 0 (00:00) до 23 (23:00) включительно или числовое выражение.

минута — обязательный аргумент типа Variant (Integer). Любое числовое выражение.

секунда — обязательный аргумент типа Variant (Integer). Любое числовое выражение.

TimeValue

Возвращает значение типа Variant (Date), содержащее время.

Синтаксис

TimeValue( время)

время — обязательный аргумент; как правило, является строковым выражением, соответствующим значению времени в диапазоне от 00:00:00 до 23:59:59 включительно. Но аргумент время также может быть представлен любым выражением, обозначающим время в этом диапазоне. Если аргумент время содержит Null, возвращается значение Null.

Val

Возвращает числа, содержащиеся в строке в качестве числового значения соответствующего типа.

Синтаксис

Val( строка )

строка — обязательный аргумент, который является любым допустимым строковым выражением.

Weekday

Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.

Синтаксис

Weekday( дата[, первый_день_недели] )

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит Null, возвращается значение Null.

первый_день_недели — необязательный аргумент, который является константой, указывающей первый день недели. Если аргумент не указан, предполагается значение «Воскресенье».

Year

Возвращает значение типа Variant (Integer), содержащее целое число, которое обозначает год.

Синтаксис

Year( дата )

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит Null, возвращается значение Null.

Функции даты и времени

CDate

Приводит выражение к типу данных Date.

Синтаксис

CDate( выражение )

выражение — любое допустимое выражение типа «дата».

Date

Возвращает значение типа Variant (Date), содержащее текущую системную дату.

Синтаксис

Date

DateAdd

Возвращает значение типа Variant (Date), содержащее результат прибавления к дате указанного интервала времени.

Синтаксис

DateAdd( интервал, число, дата )

интервал — обязательный аргумент. Строковое выражение, обозначающее интервал времени, который требуется добавить, например "m" или "d".

число — обязательный аргумент. Числовое выражение, обозначающее количество интервалов, которые требуется добавить. Может принимать положительное (для получения будущих дат) или отрицательное (для получения прошедших дат) значение.

дата — обязательный аргумент типа Variant (Date) или буквальное представление даты, к которой добавляется интервал.

DateDiff

Возвращает значение типа Variant (Long), указывающее на количество интервалов времени между двумя указанными датами.

Синтаксис

DateDiff( интервал, дата1, дата2[, первый_день_недели[, первая_неделя_года]] )

интервал — обязательный аргумент. Строковое выражение, которое обозначает интервал времени, используемый для вычисления разницы значений дата1 и дата2.

дата1, дата2 — обязательный аргумент типа Variant (Date). Две даты, которые используются при вычислении.

первый_день_недели — необязательный аргумент, который является константой, указывающей первый день недели. Если аргумент не указан, предполагается значение «Воскресенье».

первая_неделя_года — необязательный аргумент, который является константой, указывающей первую неделю года. Если аргумент не указан, первой считается неделя, на которую приходится 1 января.

DatePart

Возвращает значение типа Variant (Integer), содержащее указанную часть заданной даты.

Синтаксис

DatePart( интервал, дата[, первый_день_недели[, первая_неделя_года]] )

интервал — обязательный аргумент. Строковое выражение, обозначающее интервал времени, который требуется возвратить.

дата — обязательный аргумент типа Variant (Date). Значение, которое требуется вычислить.

первый_день_недели — необязательный аргумент, который является константой, указывающей первый день недели. Если аргумент не указан, предполагается значение «Воскресенье».

первая_неделя_года — необязательный аргумент, который является константой, указывающей первую неделю года. Если аргумент не указан, первой считается неделя, на которую приходится 1 января.

DateSerial

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

Синтаксис

DateSerial( год, месяц, день )

год — обязательный аргумент типа Integer. Число от 100 до 9999 включительно или числовое выражение.

месяц — обязательный аргумент типа Integer. Любое числовое выражение.

день — обязательный аргумент типа Integer. Любое числовое выражение.

DateValue

Возвращает значение типа Variant (Date).

Синтаксис

DateValue( дата)

дата — обязательный аргумент; как правило, является строковым выражением, обозначающим дату от 1 января 100 г. до 31 декабря 9999 г. Но аргумент дата также может быть представлен любым выражением, обозначающим дату, время или дату и время в указанном диапазоне.

Day

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

Синтаксис

Day( дата)

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит 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, числовым, строковым выражением или любым сочетанием, которое может обозначать время. Если аргумент дата содержит Null, возвращается значение Null.

Now

Возвращает значение типа Variant (Date), которое указывает текущую дату и время в соответствии с системной датой и системным временем на компьютере пользователя.

Синтаксис

Now

ProjDateAdd

Добавляет длительность к дате, чтобы возвратить новую дату.

Синтаксис

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

дата — обязательный аргумент типа Variant. Исходная дата, к которой добавляется значение длительность.

длительность — обязательный аргумент типа Variant. Длительность, которую требуется добавить к значению дата.

календарь — необязательный аргумент типа String. Календарь, который требуется использовать при расчете новой даты. Если аргумент календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса, а для текущей задачи — календарь задачи или стандартный календарь, если нет календаря задачи. В Project Server используется стандартный календарь независимо от значения, указанного в строке календарь. При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.

Примечание:  Чтобы вычесть семь дней из определенной даты, в Project профессиональный 2010 используется такая формула: ProjDateAdd("24.09.2010", "-7d"). Но эта же формула в приложении Project Server 2010 возвратит результат 24.09.2010, а не 17.09.2010. Чтобы формулы с функциями ProjDateAdd и ProjDateSub правильно работали в Project профессиональный и Project Server, следует избегать отрицательных параметров.

ProjDateConv

Преобразует значение в дату.

Синтаксис

ProjDateConv( выражение, формат_даты )

выражение — обязательный аргумент типа Variant. Выражение, которое требуется преобразовать в дату.

формат_даты — необязательный аргумент типа Long. По умолчанию используется формат даты pjDateDefault, но его можно заменить на одну из перечисленных ниже констант pjDateFormat (формат даты применен 25.09.2007 в 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, календарь )

дата1 — обязательный аргумент типа Variant. Дата, используемая в качестве начала интервала.

дата2 — обязательный аргумент типа Variant. Дата, используемая в качестве конца интервала

календарь  — необязательный аргумент типа String. Календарь, который требуется использовать для расчета длительности. Если аргумент календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса, а для текущей задачи — календарь задачи (или стандартный календарь, если календарь задачи не задан). В приложении Project Server используется стандартный календарь независимо от значения, указанного в строке календарь. При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.

ProjDateSub

Возвращает дату, которая предшествует другой дате на указанную длительность.

Синтаксис

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

дата — обязательный аргумент типа Variant. Исходная дата, из которой вычитается значение длительность.

длительность — обязательный аргумент типа Variant. Длительность, которую требуется вычесть из значения дата.

календарь  — необязательный аргумент типа String. Календарь, который требуется использовать для расчета длительности. Если аргумент календарь не указан, по умолчанию для текущего ресурса используется календарь ресурса, а для текущей задачи — календарь задачи (или стандартный календарь, если календарь задачи не задан). В приложении Project Server используется стандартный календарь независимо от значения, указанного в строке календарь. При использовании этой функции в формуле, созданной в приложении Project Web App, и сравнении ее с такой же формулой, созданной в приложении Project Professional, следует проверить формулу в действии, чтобы обеспечить предполагаемый результат.

Примечание:  Чтобы вычесть семь дней из определенной даты, в Project профессиональный 2010 используется такая формула: ProjDateAdd("24.09.2010", "-7d"). Но эта же формула в приложении Project Server 2010 возвратит результат 24.09.2010, а не 17.09.2010. Чтобы формулы с функциями ProjDateAdd и ProjDateSub правильно работали в Project профессиональный и Project Server, следует избегать отрицательных параметров.

ProjDateValue

Возвращает значение даты для выражения.

Синтаксис

ProjDateValue(выражение)

выражение — обязательный аргумент типа Variant. Выражение, которое требуется представить в виде даты.

ProjDurConv

Преобразует выражение в значение длительности в указанных единицах.

Синтаксис

ProjDurConv( выражение, единицы_длительности )

выражение — обязательный аргумент типа Variant. Выражение для преобразования в значение длительности.

единицы_длительности — необязательный аргумент типа Long. Единицы, используемые для выражения длительности. Если значение единицы_длительности не указано, то по умолчанию используется тип единиц, заданный в параметре Длительность вводится в на вкладке Планирование диалогового окна Параметры (меню Сервис). Аргумент единицы_длительности может быть представлен одной из следующих констант 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 (00:00) до 23 (23:00) включительно или числовое выражение.

минута — обязательный аргумент типа Variant (Integer). Любое числовое выражение.

секунда — обязательный аргумент типа Variant (Integer). Любое числовое выражение.

TimeValue

Возвращает значение типа Variant (Date), содержащее время.

Синтаксис

TimeValue( время)

время — обязательный аргумент; как правило, является строковым выражением, соответствующим значению времени в диапазоне от 00:00:00 до 23:59:59 включительно. Но аргумент время также может быть представлен любым выражением, обозначающим время в этом диапазоне. Если аргумент время содержит Null, возвращается значение Null.

Weekday

Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.

Синтаксис

Weekday( дата[, первый_день_недели] )

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит Null, возвращается значение Null.

первый_день_недели — необязательный аргумент, который является константой, указывающей первый день недели. Если аргумент не указан, предполагается значение «Воскресенье».

Year

Возвращает значение типа Variant (Integer), содержащее целое число, которое обозначает год.

Syntax

Year( год)

дата — обязательный аргумент, который является любым значением типа Variant, числовым, строковым выражением или любым сочетанием, которое может обозначать дату. Если аргумент дата содержит Null, возвращается значение Null.

Общие функции

Choose

Выбирает и возвращает значение из списка аргументов.

Синтаксис

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

индекс — обязательный аргумент. Числовое выражение или поле со значением в диапазоне от 1 до числа доступных вариантов выбора.

вариант — обязательный аргумент. Выражение типа Variant, содержащее один из возможных вариантов выбора.

IIf

Возвращает одну из двух частей в зависимости от вычисленного значения выражения.

Синтаксис

IIf( выражение, если_истина, если_ложь )

выражение — обязательный аргумент. Выражение типа Variant, которое требуется вычислить.

если_истина — обязательный аргумент. Значение или выражение, которое возвращается, если соответствующее выражение принимает значение True.

если_ложь — обязательный аргумент. Значение или выражение, которое возвращается, если соответствующее выражение принимает значение 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( кодировка )

кодировка — число типа Long, которое определяет символ.

Format

Возвращает значение типа Variant (String), которое содержит выражение, отформатированное в соответствии с указаниями, содержащимися в выражении формата.

Синтаксис

Format( выражение[, формат[, первый_день_недели[, первая_неделя_года]]] )

выражение — обязательный аргумент, который является любым допустимым выражением.

формат — необязательный аргумент; допустимое имя или заданное пользователем выражение формата.

первый_день_недели — необязательный аргумент, который является константой, указывающей первый день недели.

первая_неделя_года — необязательный аргумент, который является константой, указывающей первую неделю года.

Instr

Возвращает значение типа Variant (Long), определяющее положение первого вхождения одной строки в другую.

Синтаксис

Instr( [начало, ]строка1, строка2[, сравнение] )

начало — необязательный аргумент. Числовое выражение, которое задает начальное положение для каждого поиска. Если аргумент не задан, поиск начинается с первого символа. Если аргумент начало содержит значение Null, возникает ошибка. Если задан аргумент сравнение, аргумент начало является обязательным.

строка1 — обязательный аргумент; строковое выражение, в котором выполняется поиск.

строка2 — обязательный аргумент, который является искомым строковым выражением.

сравнение — необязательный аргумент, указывающий тип строкового сравнения. Если аргумент сравнение содержит значение «Null», возникает ошибка. Если аргумент сравнение не задан, тип сравнения определяется параметром Option аргумента сравнение.

LCase

Возвращает значение типа String, преобразованное в символы нижнего регистра

Синтаксис

LCase( строка )

строка  — обязательный аргумент, который является любым допустимым строковым выражением. Если аргумент строка содержит Null, возвращается значение Null.

Left

Возвращает значение типа Variant (String), содержащее указанное число символов с левой стороны строки.

Синтаксис

Left( строка, длина )

строка — обязательный аргумент; строковое выражение, с левого края которого будут возвращены символы. Если аргумент строка содержит Null, возвращается значение Null.

длина — обязательный аргумент типа Variant (Long). Числовое выражение, указывающее количество возвращаемых символов. Если оно равно 0, возвращается пустая строка («»). Если значение этого аргумента больше или равно числу символов в аргументе строка, возвращается вся строка.

Len

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

Синтаксис

Len( строка, имя_переменной )

строка — любое допустимое строковое выражение. Если аргумент строка содержит Null, возвращается значение Null.

имя_переменной — любое допустимое имя переменной. Если аргумент имя_переменной содержит Null, возвращается значение Null. Если аргумент имя_переменной является значением типа Variant, функция Len обрабатывает его так же, как и значения типа String, и всегда возвращает число символов, содержащихся в имени переменной.

LTrim

Возвращает значение типа Variant (String), содержащее копию указанной строки без начальных пробелов.

Синтаксис

LTrim( string )

строка — обязательный аргумент, который является любым допустимым строковым выражением. Если аргумент строка содержит Null, возвращается значение Null.

Mid

Возвращает значение типа Variant (String), содержащее указанное число символов строки.

Синтаксис

Mid( строка, начало[, длина] )

строка — обязательный аргумент; строковое выражение, из которого возвращаются символы. Если аргумент строка содержит Null, возвращается значение Null.

начало — обязательный аргумент типа Long; положение символа в значении аргумента строка, с которого начинается возвращаемая часть строки. Если значение аргумента начало превышает число символов в аргументе строка, функция Mid возвращает пустую строку ("").

длина — необязательный аргумент типа Variant (Long); число возвращаемых символов. Если аргумент не задан или если количество символов текста меньше количества символов строки (включая символ, указанный для аргумента начало), возвращаются все символы, начиная с положения аргумента начало и до конца строки.

Right

Возвращает значение типа Variant (String), содержащее указанное количество символов с правой стороны строки.

Синтаксис

Right( строка, длина )

строка — обязательный аргумент; строковое выражение, с правого края которого будут возвращены символы. Если аргумент строка содержит Null, возвращается значение Null.

длина — обязательный аргумент типа Variant (Long). Числовое выражение, указывающее количество возвращаемых символов. Если оно равно 0, возвращается пустая строка («»). Если значение этого аргумента больше или равно числу символов в аргументе строка, возвращается вся строка.

RTrim

Возвращает значение типа Variant (String), содержащее копию указанной строки без конечных пробелов.

Синтаксис

RTrim( строка )

строка — обязательный аргумент, который является любым допустимым строковым выражением. Если аргумент строка содержит Null, возвращается значение Null.

Space

Возвращает значение типа Variant (String), состоящее из указанного количества пробелов.

Синтаксис

Space( число )

число — обязательный аргумент; нужное количество пробелов в строке.

StrComp

Возвращает значение типа Variant (Integer), указывающее результат сравнения строк.

Синтаксис

StrComp( строка1, строка2[, сравнение] )

строка1 — обязательный аргумент, который является любым допустимым строковым выражением.

строка2 — обязательный аргумент, который является любым допустимым строковым выражением.

сравнение — необязательный аргумент, указывающий тип строкового сравнения. Если аргумент сравнение содержит значение Null, возникает ошибка.

StrConv

Возвращает значение типа Variant (String), преобразованное в соответствии с указанными параметрами.

Синтаксис

StrConv( строка, преобразование, LCID )

строка — обязательный аргумент, который является строковым выражением для преобразования.

преобразование — обязательный аргумент типа Integer. Совокупность значений, определяющих тип преобразования.

LCID — необязательный аргумент, который является кодом языка, если он отличается от системного. (По умолчанию используется системный код языка.)

String

Возвращает значение типа Variant (String), содержащее строку повторяющихся символов указанной длины.

Синтаксис

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

число  — обязательный аргумент типа Long; длина возвращаемой строки. Если аргумент число содержит Null, возвращается значение Null.

символ — обязательный аргумент типа Variant. Код символа, указывающий символ или строковое выражение, первый символ которого используется для создания возвращаемой строки. Если аргумент символ содержит Null, возвращается значение Null.

Trim

Возвращает значение типа Variant (String), содержащее копию указанной строки без начальных и конечных пробелов.

Синтаксис

Trim( строка )

строка — обязательный аргумент, который является любым допустимым строковым выражением. Если аргумент строка содержит Null, возвращается значение Null.

UCase

Возвращает значение типа Variant (String), содержащее указанную строку, преобразованную в символы верхнего регистра.

Синтаксис

UCase( строка )

строка — обязательный аргумент, который является любым допустимым строковым выражением. Если аргумент строка содержит Null, возвращается значение Null.

Совершенствование навыков работы с Office
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×