d9e5a92d

Глава 7-1 Системные процедуры и функции

Системные процедуры и функции доступны в любом программном модуле конфигурации. Доступ к системным процедурам и функциям в текстах программных модулей непосредственный, т. е. просто имя процедуры или функции (без предварительной ссылки на какой-либо объект).

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

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

Окр

Округлить число.

Синтаксис:

Окр(Число1, [Число2], [Спосо6])

Англоязычный синоним:

Round

Параметры:

Число1 Числовое выражение, значение которого надо округлить.
Число2 Необязательный параметр. Числовое выражение, значение которого — формат округления (число знаков дробной части (если Число2 отрицательно, то округляется до соответствующего количества знаков целой части). Значение этого параметра по умолчанию — 0.
Способ Необязательный параметр. Числовое выражение — способ округления: 0 — если при округлении 1.5 = 1; 1 — если при округлении 1.5 = 2. Значение по умолчанию — 0.
Возвращаемое значение:

Числовое значение результата округления.

Описание:

Функция Окр возвращает числовое значение результата округления Число1 до Число2 знаков дробной части (если Число2 отрицательно, то округляется до соответствующего количества знаков целой части). Параметр Число2 может быть опущен, при этом принимается, что Число2 = 0.

Пример:

ОкруглЦена = Окр(ЦЕНА, -2);

Цел

Получить целую часть числа.

Синтаксис:

Цел(Число)

Англоязычный синоним:

Int

Параметры:

Число Числовое выражение.
Возвращаемое значение:

Числовое значение целой части переданного в качестве параметра числа.

Описание:

Функция Цел возвращает целую часть переданного в качестве параметра числа, полностью отсекая дробную часть.

Пример:

МожноКупить = Цел(Наличность/Цена);

Мин

Определить минимальное значение.

Синтаксис:

Мин(Элемент1, ..., ЭлементN)

Англоязычный синоним:

Min

Параметры:

Элемент1, ..., ЭлементN Список выражений базовых типов данных.
Возвращаемое значение:

Значение минимального элемента из списка Элемент1, ..., ЭлементN

Описание:

Функция Мин определяет минимальное значение из списка Элемент1, ..., ЭлементN.

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

Пример:

МинимЦена = Мин(Цена1, Цена2, ЦенаЗ);

Макс

Определить максимальное значение.

Синтаксис:

Макс(Элемент1, ..., ЭлементN)

Англоязычный синоним:

Мах

Параметры:

Элемент1, ..., ЭлементN   Список выражений базовых типов данных.

Возвращаемое значение:

Значение максимального элемента из списка Элемент1, ..., ЭлементN

Описание:

Функция Макс определяет максимальное значение из списка Элемент1, ..., ЭлементN.

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

Пример:

МаксимЦена = Макс(Цена1, Цена2, ЦенаЗ);

Лог10

Вычислить десятичный логарифм числа.

Синтаксис:

Лог10(Число)

Англоязычный синоним:

Log10

Параметры:

Число Числовое выражение.
Возвращаемое значение:

Числовое значение результата вычисления десятичного логарифма.

Описание:

Функция Лог10 вычисляет и возвращает десятичный логарифм числа. При отрицательном или нулевом значении параметра возвращаемое значение — 0.

Пример:

Шкала = Лог10(Частота);

Лог

Вычислить натуральный логарифм числа.

Синтаксис:

Лог(Число)

Англоязычный синоним:

Ln

Параметры:

Число Числовое выражение.
Возвращаемое значение:

Числовое значение результата вычисления натурального логарифма.

Описание:

Функция Лог вычисляет и возвращает натуральный логарифм числа. При отрицательном или нулевом значении параметра возвращаемое значение — 0.

Пример:

Шкала = Лог(Частота);

Строковые функции

СтрДлина

Получить длину строки.

Синтаксис:

СтрДлина(Строка)

Англоязычный синоним:

StrLen

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Числовое значение длины строки.

Описание:

Функция СтрДлина получает в качестве параметра строку и возвращает числовое значение ее длины.

Пример:

Длина = СтрДлина(Измерим длину строки);

ПустаяСтрока

Проверить строку на наличие значащих символов.

Синтаксис:

ПустаяСтрока(Строка)

Англоязычный синоним:

IsBlankString

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Числовое значение. 1 — пустая строка или только пробелы. 0 — не пустая строка.

Описание:

Функция ПустаяСтрока проверяет переданный параметр Строка на наличие значащих символов (любых кроме пробелов) и возвращает число 1, если строка пустая или содержит только пробелы, 0 , если строка не пустая.

Пример:

Если ПустаяСтрока(Буфер) = 1 Тогда

   // если Буфер содержит только пробелы, то его удаляем

   Буфер = ;

КонецЕсли;

СокрЛ

Отбросить в строке стоящие слева пробелы.

Синтаксис:

СокрЛ(Строка)

Англоязычный синоним:

TrimL

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция СокрЛ получает в качестве параметра строку, отсекает стоящие слева пробелы и возвращает результирующую строку.

Пример:

СтрЦена = СокрЛ(Цена) + руб.;

СокрП

Отбросить в строке стоящие справа пробелы.

Синтаксис:

СокрП(Строка)

Англоязычный синоним:

TrimR

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция СокрП получает в качестве параметра строку, отсекает стоящие справа пробелы и возвращает результирующую строку.

Пример:

ФИО = СокрП(Фамилия) + + СокрП(Имя) + + СокрП(Отчество);

СокрЛП

Отбросить в строке пробелы, стоящие слева и справа.

Синтаксис:

СокрЛП(Строка)

Англоязычный синоним:

TrimAll

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция СокрЛП получает в качестве параметра строку, отсекает стоящие слева и справа пробелы, и возвращает результирующую строку.

Пример:

ФИО = СокрЛП(Фамилия) + + СокрП(Имя) + + СокрП(Отчество);

Лев

Выбрать в строке символы слева.

Синтаксис:

Лев (Строка, Число)

Англоязычный синоним:

Left

Параметры:

Строка Строковое выражение.
Число Числовое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция Лев получает в качестве параметра строку, выбирает первые слева символы строки, числом равные Число, и возвращает в качестве значения результирующую строку.

Пример:

Фамилия = Лев(ФИО, 15);

Прав

Выбрать в строке символы справа.

Синтаксис:

Прав(Строка, Число)

Англоязычный синоним:

Right

Параметры:

Строка Строковое выражение.
Число Числовое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция Прав получает в качестве параметра строку, выбирает крайние справа символы строки, числом равные Число, и возвращает в качестве значения результирующую строку.

Пример:

Отчество = Прав(ФИО, 15);

Сред

Выбрать подстроку.

Синтаксис:

Сред(Строка, Число1, Число2)

Англоязычный синоним:

Mid

Параметры:

Строка Строковое выражение.
Число1 Числовое выражение, начальный номер символа.
Число2 Числовое выражение, количество символов.
Возвращаемое значение:

Строковое значение.

Описание:

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

Пример:

Имя = Сред(ФИО, 10, 12);

Найти

Найти вхождение подстроки.

Синтаксис:

Найти(Строка1, Строка2)

Англоязычный синоним:

Find

Параметры:

Строка1 Строковое выражение места поиска.
Строка2 Строковое выражение шаблона поиска.
Возвращаемое значение:

Числовое значение позиции первого знака найденной подстроки.

Описание:

Функция Найти находит вхождение строки Строка2 как подстроки в Строка1. Возвращает числовое значение позиции первого знака найденной подстроки (первая позиция имеет индекс 1). Если не находит — возвращает число 0.

Пример:

Симв = Найти(ФИО, Борис);

СтрЗаменить

Заменить вхождение подстроки другим значением.

Синтаксис:

СтрЗаменить(СтрИсточник, СтрПодстрока, СтрЗамены)

Англоязычный синоним:

StrReplace

Параметры:

СтрИсточник Строковое выражение места поиска.
СтрПодстрока Строковое выражение шаблона поиска.
СтрЗамены Строковое выражение замены.
Возвращаемое значение:

Результирующая строка.

Описание:

Функция СтрЗаменить находит вхождение строки СтрПодстрока как подстроки в СтрИсточник и заменяет его на СтрЗамены. Результирующую строку возвращает в качестве собственного значения. Исходная строка не изменяется.

Пример:

Результат = СтрЗаменить(СтрИсточник, СтрПодстрока, СтрЗамены);

СтрЧислоВхождений

Вычислить число вхождений подстроки.

Синтаксис:

СтрЧислоВхождений(СтрИсточник, СтрПодстрока)

Англоязычный синоним:

StrCountOccur

Параметры:

СтрИсточник Строковое выражение места поиска.
СтрПодстрока Строковое выражение шаблона поиска.
Возвращаемое значение:

Число вхождений.

Описание:

Функция СтрЧислоВхождений вычисляет число вхождений строки СтрПодстрока как подстроки в СтрИсточник.

Пример:

Результат = СтрЧислоВхождений(СтрИсточник, СтрПодстрока);

СтрКоличествоСтрок

Определить число строк в многострочном тексте.

Синтаксис:

СтрКоличествоСтрок(Строка)

Англоязычный синоним:

StrLineCount

Параметры:

Строка Строковое выражение, в котором строки разделены символами перевода строк.
Возвращаемое значение:

Число строк в многострочном тексте.

Описание:

Функция СтрКоличествоСтрок вычисляет число строк в многострочном тексте (строки разделены символами перевода строк).

Пример:

Рез = СтрКоличествоСтрок(ДлТекст);

См. также: РазделительСтрок

СтрПолучитьСтроку

Получить строку из многострочного текста по номеру.

Синтаксис:

СтрПолучитьСтроку(Текст, НомерСтроки)

Англоязычный синоним:

StrGetLine

Параметры:

Текст Строковое выражение, в котором строки разделены символами перевода строк.
НомерСтроки Числовое выражение, начальный номер символа.
Возвращаемое значение:

Строковое значение.

Описание:

Функция СтрПолучитьСтроку возвращает строку с номером НомерСтроки из многострочного текста Текст (строки разделены символами перевода строк).

Пример:

ВтораяСтрока = СтрПолучитьСтроку(ДлТекст, 2);

См. также: РазделительСтрок

Врег

Преобразовать символы строки в верхний регистр.

Синтаксис:

ВРег(Строка)

Англоязычный синоним:

UpРег

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция ВРег преобразует все символы строки в верхний регистр. Результирующую строку возвращает в качестве собственного значения. Исходная строка не изменяется.

Пример:

Загл = ВРег(маленькие);

Нрег

Преобразовать символы строки в нижний регистр.

Синтаксис:

НРег(Строка)

Англоязычный синоним:

Lower

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция НРег преобразует все символы строки в нижний регистр. Результирующую строку возвращает в качестве собственного значения. Исходная строка не изменяется.

Пример:

Загл = НРег(БОЛЬШИЕ);

OemToAnsi

Преобразовать строку в кодировку ANSI.

Синтаксис:

OemToAnsi(Строка)

Англоязычный синоним:

OemToAnsi

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция OemToAnsi используется для перевода строки из DOS-кодировки в Windows-Кодировку. Результирующая строка возвращается в качестве собственного значения. Исходная строка не изменяется.

Пример:

Загл = OemToAnsi(ТекстDOS);

AnsiToOem

Преобразовать строку в кодировку OEM.

Синтаксис:

AnsiToOem(Строка)

Англоязычный синоним:

AnsiToOem

Параметры:

Строка Строковое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция AnsiToOem используется для перевода строки из Windows-кодировки в DOS-Кодировку. Результирующая строка возвращается в качестве собственного значения. Исходная строка не изменяется.

Пример:

3aгл = AnsiToOem(TeкстWin);

Симв

Преобразовать код символа в символ.

Синтаксис:

Симв(КодСимвола)

Англоязычный синоним:

Chr

Параметры:

КодСимвола Числовое выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция Chr преобразует код символа в символ. Возвращает результирующий символ в виде строкового значения.

Пример:

Буква_я = Симв(255);

КодСимв

Преобразовать символ в код символа.

Синтаксис:

КодСимв(Символ)

Англоязычный синоним:

Asс

Параметры:

Символ Строковое выражение.
Возвращаемое значение:

Числовое значение.

Описание:

Функция КодСимв преобразует символ в код символа. Возвращает результирующий код символа в виде числового значения.

Пример:

КодБуквы_я = КодСимв(я);

Функции работы с датой

РабочаяДата

Установить/получить текущую рабочую дату.

Синтаксис:

РабочаяДата(Дата, РежимСменыРабДаты)

Англоязычный синоним:

WorkingDate

Параметры:

Дата Необязательный параметр. Выражение типа «дата».
РежимСменыРабДаты Необязательный параметр. Режим автоматической смены рабочей даты в полночь: 0 — не менять; 1 — менять с предупреждением; 2 — менять автоматически без предупреждения. Если параметр не указан, то режим не меняется и действует установка, выбранная в параметрах системы.
Возвращаемое значение:

Значение текущей рабочей даты (на момент до выполнения функции).

Описание:

При помощи функции РабочаяДата можно установить/получить значение рабочей даты, выбранной в текущем сеансе работы программы (которая может изменяться при помощи главного меню Сервис-Параметры-Общие-РабочаяДата).

Пример:

// оклад сотрудника на текущую рабочую дату

Сотрудник.Оклад.Получить(РабочаяДата());

ТекущаяДата

Возвратить текущую дату.

Синтаксис:

ТекущаяДата()

Англоязычный синоним:

CurDate

Возвращаемое значение:

Результирующая дата.

Описание:

Функция ТекущаяДата возвращает текущую (системную) дату. Возвращаемое значение — результирующая дата.

Пример:

ДатаТекущая = ТекущаяДата();

ДобавитьМесяц

Добавляет к указанной дате заданное число месяцев.

Синтаксис:

ДобавитьМесяц(Дата, ЧислоМесяцев)

Англоязычный синоним:

AddMonth

Параметры:

Дата Выражение со значением типа «дата».
ЧислоМесяцев Числовое выражение, задающее число месяцев, добавляемое к дате.
Возвращаемое значение:

Результирующая дата.

Описание:

Функция ДобавитьМесяц добавляет к указанной дате заданное число месяцев.

Пример:

ДатаЧерезТриМесяца = ДобавитьМесяц(РабочаяДата(), 3);

НачМесяца

Определить дату начала месяца.

Синтаксис:

НачМесяца(Дата)

Англоязычный синоним:

BegOfMonth

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция НачМесяца определяет дату начала месяца для указанной даты.

Пример:

ДатаНачалаМесяца = НачМесяца(РабочаяДата());

КонМесяца

Определить дату конца месяца.

Синтаксис:

КонМесяца(Дата)

Англоязычный синоним:

EndOfMonth

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция КонМесяца определяет дату конца месяца для указанной даты.

Пример:

ДатаКонцаМесяца = КонМесяца(РабочаяДата());

НачКвартала

Определить дату начала квартала.

Синтаксис:

НачКвартала(Дата)

Англоязычный синоним:

BegOfQuart

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция НачКвартала определяет дату начала квартала для указанной даты.

Пример:

ДатаНачалаКвартала = НачКвартала(РабочаяДата());

КонКвартала

Определить дату конца квартала.

Синтаксис:

КонКвартала(Дата)

Англоязычный синоним:

EndOfQuart

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция КонКвартала определяет дату конца квартала для указанной даты.

Пример:

ДатаКонцаКвартала = КонКвартала(РабочаяДата());

НачГода

Определить дату начала года.

Синтаксис:

НачГода(Дата)

Англоязычный синоним:

BegOfYear

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция НачГода определяет дату начала года для указанной даты.

Пример:

ДатаНачалаГода = НачГода(РабочаяДата());

КонГода

Определить дату конца года.

Синтаксис:

КонГода(Дата)

Англоязычный синоним:

EndOfYear

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция КонГода определяет дату конца года для указанной даты.

Пример:

ПатаКонцаГода = КонГода(РабочаяДата());

НачНедели

Определить дату начала недели.

Синтаксис:

НачНедели(Дата)

Англоязычный синоним:

BegOfWeek

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция НачНедели определяет дату начала недели для указанной даты.

Пример:

ДатаНачалаНедели = НачНедели(РабочаяДата());

КонНедели

Определить дату конца недели.

Синтаксис:

КонНедели(Дата)

Англоязычный синоним:

EndOfWeek

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Результирующая дата.

Описание:

Функция КонНедели определяет дату конца недели для указанной даты.

Пример:

ДатаКонцаНедели = КонНедели(РабочаяДата());

ДатаГод

Определить год указанной даты.

Синтаксис:

ДатаГод(Дата)

Англоязычный синоним:

GetYear

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением определенного года.

Описание:

Функция ДатаГод определяет год указанной даты.

Пример:

ЗначениеГода = ДатаГод(РабочаяДата());

ДатаМесяц

Определить месяц указанной даты.

Синтаксис:

ДатаМесяц(Дата)

Англоязычный синоним:

GetMonbh

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением номера месяца года.

Описание:

Функция ДатаМесяц определяет месяц указанной даты.

Пример:

ЗначениеМесяца = ДатаМесяц(РабочаяДата());

ДатаЧисло

Определить день месяца указанной даты.

Синтаксис:

ДатаЧисло(Дата)

Англоязычный синоним:

GetDay

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением определенного дня месяца.

Описание:

Функция ДатаЧисло определяет день месяца указанной даты.

Пример:

ЗначениеДняМесяца = ДатаЧисло(РабочаяДата());

НомерНеделиГода

Определить номер недели в году для указанной даты.

Синтаксис:

НомерНеделиГода(Дата)

Англоязычный синоним:

GetWeekOfYear

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением определенного номера недели в году.

Описание:

Функция НомерНеделиГода определяет номер недели в году для указанной даты.

Пример:

ЗначениеНедели = НомерНеделиГода(РабочаяДата());

НомерДняГода

Определить день года указанной даты.

Синтаксис:

НомерДняГода(Дата)

Англоязычный синоним:

GetDayOfYear

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением определенного дня года.

Описание:

Функция НомерДняГода определяет порядковый день в году для указанной даты.

Пример:

ЗначениеДняГода = НомерДняГода(РабочаяДата());

НомерДняНедели

Определить день недели указанной даты.

Синтаксис:

НомерДняНедели(Дата)

Англоязычный синоним:

GetDayOfWeek

Параметры:

Дата Выражение со значением типа «дата».
Возвращаемое значение:

Число со значением определенного порядкового дня недели.

Описание:

Функция НомерДняНедели определяет день недели указанной даты. Возвращаемое значение — число со значением определенного порядкового дня недели (1 — понедельник, 2 — вторник, ..., 7 — воскресенье).

Пример:

ЗначениеДняНедели = НомерДняНедели(РабочаяДата());

ПериодСтр

Строковое представление периода.

Синтаксис:

ПериодСтр(ДатаНачалаПериода, ДатаКонцаПериода)

Англоязычный синоним:

Рег1odStr

Параметры:

ДатаНачалаПериода Дата — начальная дата периода.
ДатаКонцаПериода Дата — конечная дата периода.
Возвращаемое значение:

Символьная строка — представление периода.

Описание:

Внутри системы все периоды задаются интервалом дат — дата начала и дата конца. Функция ПериодСтр предназначена для того, чтобы в случае, если период фактически является кварталом, месяцем, полугодием отобразить его соответствующим образом, например 1 квартал 1997 г.

Функция ПериодСтр возвращает информацию о периоде бухгалтерских итогов в виде строки символов. Строка может использоваться для выдачи ин-форации о периоде итогов в отчетах.

Пример:

Дата1='01.01.97';

Дата2='31.03.97';

Сообщить(ПериодСтр(Дата1, Дата2));  //Выводит 1 квартал 1997 г.

НачалоСтандартногоИнтервала

Устанавливает вариант задания начала стандартного интервала отображения журнала документов.

Синтаксис:

НачалоСтандартногоИнтервала(Вариант)

Англоязычный синоним:

BegOfStandrdRange

Параметры:

Вариант Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значения параметра:

День, Месяц, Квартал, Год, Day, Month, Quarter, Year. Значением типа «дата» задается конкретная дата начала интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант.
Возвращаемое значение:

Возвращает текущий установленный вариант.

Описание:

Функция НачалоСтандартногоИнтервала устанавливает вариант зада ния начала стандартного интервала отображения журнала документов. Вариан может изменяться при помощи главного меню Сервис-Параметры-Общие.

Пример:

НачалоСтандартногоИнтервала(Месяц);

КонецСтандартногоИнтервала

Устанавливает вариант задания конца стандартного интервала ото бражения журнала документов.

Синтаксис:

КонецСтандартногоИнтервала(Вариант)

Англоязычный синоним:

EndOfStandardRange

Параметры:

Вариант Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значения параметра: День, Месяц, Квартал, Год, Day, Month, Quarter, Year. Значением типа «дата» задается конкретная дата конца интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант.
Возвращаемое значение:

Возвращает текущий установленный вариант.

Описание:

Функция КонецСтандартногоИнтервала устанавливает вариант задания конца стандартного интервала отображения журнала документов. Вариант может изменяться при помощи главного меню Сервис-Параметры-Общие.

Пример:

КонецСтандартногоИнтервала(Месяц);

Функции работы с временем

ТекущееВремя

Возвратить текущее время

Синтаксис:

ТекущееВремя(Час, Мин, Сек)

Англоязычный синоним:

CurrentTime

Параметры:

Час Необязательный параметр. Имя переменной, куда система возвращает числовое значение часа текущего времени.
Мин Необязательный параметр. Имя переменной, куда система возвращает числовое значение минут текущего времени.
Сек Необязательный параметр. Имя переменной, куда система возвращает числовое значение секунд текущего времени.
Возвращаемое значение:

Текущее время в текстовом виде.

Описание:

Функция ТекущееВремя возвращает текущее (системное) время в текстовом виде. Кроме того, если в качестве параметров при вызове функции передать переменные, то функция вернет в них числовые значения текущего часа, минуты, секунды.

Пример:

Сообщить(Сейчас + ТекущееВремя());

Функции преобразования типов

Дата

Преобразовать параметр в дату.

Синтаксис 1:

Дата(Параметр)

Синтаксис 2:

Дата(Год, Месяц, Число)

Англоязычный синоним:

Date

Параметры:

Параметр Числовое выражение.
Год Числовое выражение. Год указывается 4-х знач-ным числом (вместе с веком).
Месяц Числовое выражение.
Число Числовое выражение.
Возвращаемое значение:

Значение типа «дата».

Описание:

Функция Дата преобразует значение переданных параметров в дату, руководствуясь принятыми правилами преобразования типов и возвращает значение даты.

Пример:

// преобразование из строки

ДатаРожд = Дата('06.03.1958');

Строка

Преобразовать параметр в строку.

Синтаксис:

Строка(Параметр)

Англоязычный синоним:

String

Параметры:

Параметр Выражение.
Возвращаемое значение:

Строковое значение.

Описание:

Функция Строка преобразует параметр в строку, руководствуясь принятыми правилами преобразования типов и возвращает значение строки.

Стр = Строка(ДатаРожд + 1);

Число

Преобразовать параметр в число.

Синтаксис:

Число(Параметр)

Англоязычный синоним:

Number

Параметры:

Параметр Выражение.
Возвращаемое значение:

Числовое значение.

Описание:

Функция Число преобразует параметр в число, руководствуясь принятыми правилами преобразования типов и возвращает значение числа.

Пример:

ВР = Число(Вар + Род);


Содержание раздела