Встроенные функции для разных типов данных

Функция

Что возвращает

результат = Окр(число,[числоЗнаков],[способ]);

Округленное значение параметра число. Параметр числоЗнаков, если он присутствует, задает число знаков дробной части результата. Значение по умолчанию - 0. Параметр способ, если он вычисляется со значением 1, устанавливает, что число вида 1 . 5 округляется до числа 2 или округляется до числа 1 в противном случае. Значение по умолчанию - 0

результат = Цел(число);

Целую часть параметра число

минЗначение = Мин(число1, [число2],..., [числоN);

Минимальное значение своих параметров. Может иметь только один параметр - число!

максЗначение = Макс(чнсло1, [число2],..., [числоN);

Максимальное значение своих параметров. Может иметь только один параметр - число1

результат = Лог10(число);

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

результат - Лог(число);

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

функция

Что возвращает

длина = СтрДлина(строка);

Длину параметра строка

флаг = ПустаяСтрока(строка);

Число 1, если строка имеет нулевую длину или состоит из одних пробелов, или 0 -в противном случае

новаяСтрока = СокрЛ(строка);

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

новаяСтрока = СокрП(строка);

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

новаяСтрока = СокрЛП(строка);

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

подстрока = Лев(строка, число);

Строку, содержащую первые число символов параметра

строка или всю строку строка, если число =>

СтрДлина(строка). Если число <=0, то возвращается строка нулевой длины

подстрока = Прав(строка, число);

Строку, содержащую последние число символов

параметра строка или всю строку строка, если число >

СтрДлина(строка). Если число < 0, то возвращается строка нулевой длины

подстрока = Сред(строка, число1, [число 2]);

Строку, содержащую подстроку параметра строка, начинающуюся с символа под номером число 1 длиной число2. Если параметр число2 опущен, возвращается подстрока, начинающаяся с символа под номером число1

длиной до конца строки. Если число1 >

СтрДлина(строка) или число2 < 0, то возвращается

строка нулевой длины. Если параметр число1 < 0, то он принимается равным единице

позиция = Найти(строка, подстрока);

Позицию, с которой подстрока начинается в параметре строка, или нуль, если подстрока не найдена в первом параметре

новаяСтрока = СтрЗаменить

(строка, подстрока1, подстрока2);

Строку, в которой все вхождения параметра подстрока 1 в параметр строка заменены на параметр подстрока2

кол = СтрЧислоВхождений(строка, подстрока);

Число вхождений параметра подстрока в параметр строка

кол = СтрКоличествоСтрок {текст);

Число строк в тексте текст. Строки в тексте разделены символом РазделительСтрок (см. разд. 2.3)

стр = СтрПолучитьСтроку(текст, номерСтроки);

Строку параметра текст, имеющую номер номерСтроки.

Если номерСтроки < 0 или номерСтроки больше числа строк в тексте, то возвращается строка нулевой длины

новаяСтрока = Врег(строка);

Строку, в которой все символы параметра строка преобразованы в верхний регистр

новаяСтрока - Нрег(строка);

Строку, в которой все символы параметра строка преобразованы в нижний регистр

новаяСтрока = OemToAnsi (строка);

Строку, в которой OEM-коды символов параметра строка преобразованы в ANSI-коды

новаяСтрока = AnsiToOem (строка);

Строку, в которой ANSI-коды символов параметра строка преобразованы в ОЕМ-коды

символ = Симв(кодСимвола);

Символ, код которого равен значению параметра кодСимвола

код = КодСимв(строка);

Код первого символа параметра строка

Функция

Что возвращает

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

новаяДата = ДобавитьМесяц (дата, числоМесяцев);

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

нМесяца = НачМесяца(дата);

Дату начала месяца, которому принадлежит дата

кМесяца = КонМесяца(дата);

Дату конца месяца, которому принадлежит дата

нКвартала = НачКвартала(дата);

Дату начала квартала, которому принадлежит дата

кКвартала = КонКвартала(дата);

Дату конца квартала, которому принадлежит дата

нГода = НачГода(дата);

Дату начала года, которому принадлежит дата

кГода = КонГода(дата);

Дату конца года, которому принадлежит дата

нНедели = НачНедели(дата);

Дату начала недели, которой принадлежит дата

кНедели - КонНедели(дата);

Дату конца недели, которой принадлежит дата

ДатаТек = РабочаяДата ([рДата], [режимСмены]);

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

• 0, то рабочая дата в полночь не меняется;

• 1, то система предлагает изменить рабочую дату в полночь;

• 2, то рабочая дата меняется в полночь автоматически.

Если параметр режимСмены не задан, то при вызове функции РабочаяДата сохраняются заданные в системе установки режима смены. Если новое значение даты - это несуществующая дата, то рабочая дата не меняется. Рабочую дату можно также изменить, воспользовавшись в 1С:Предприятии пунктами меню Сервис- Параметры и выбрав в появившемся окне закладку Общие (см. рис. 2.1). По умолчанию рабочая и текущие даты совпадают

год = ДатаГод(дата);

Числовое значение года, которому принадлежит дата

месяц = ДатаМесяц(дата);

Номер месяца, которому принадлежит дата

число = ДатаЧисло(дата);

Номер дня месяца, заданного параметром дата

неделя = НомерНеделиГода(дата);

Номер недели года, которой принадлежит дата

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

Номер дня года, заданного параметром дата

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

Номер дня недели, заданного параметром дата (нумерация дней начинается с понедельника)

период = ПериодСтр(датаНачПериода, датаКонПериода);

Символьное представление периода, границы которого задаются значениями параметров функции. Если период - это месяц, квартал, полугодие или год, то выводится соответствующее название периода, например 1 Полугодие 2002 г.

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

([вариант]);

Устанавливает/возвращает вариант задания начала

стандартного интервала отображения журнала документов. Параметр вариант, если он имеет тип Дата, задает дату начала интервала журнала документов. Если параметр - это символьное выражение, то оно должно вычисляться со следующими значениями: "День", "Месяц", "Квартал", "Год". Если параметр опущен или содержит неверное значение, имеющаяся в системе установка сохраняется. Начало стандартного интервала можно задать в 1С:Предприятии, обратившись к пунктам меню Сервис - Параметры и выбрав в появившемся окне закладку Журналы (рис. 2.3)

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

([вариант]);

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

время = ТекущееВремя([час], [мин], [сек]);

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

флаг = ВвестиПериод(нПер, кПер, заг)

Единицу, если в выведенном диалоге (рис. 2.4) задания

даты начала (нПер) и даты конца (кПер) периода нажата

кнопка ОК, или нуль, если нажата кнопка Отмена, или

клавиша Esc, или кнопка, закрывающая окно диалога.

Символьный параметр заг задает заголовок диалогового

окна

Функция

Что делает

стр = Строка(параметр);

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

чис = Число(параметр);

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

Вариант 1: дат = Дата(параметр);

Вариант 2: дат = Дата(год, месяц, число);

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

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

Форматная строка

Вид результата

Примеры

"ДДДММГГ"

ДД.ММ.ГГ

21.12.01

"ДДДММГГГГ"

ДД.ММ.ГГГГ

21.12.2001

"ДДДММММГГГГ"

ДД месяц прописью ГГГГ г.

5 Декабря 2001 г.

"Д(0)ДДММММГГГГ"

ДД месяц прописью ГГГГ г., если в дне две цифры

ОД месяц прописью ГГГГ г., если в дне одна цифра

21 Декабря 2001 г.

05 Декабря 2001 г.

"ДММММГГГГ"

Месяц прописью ГГГГ г.

Декабрь 2001 г.

"ДММММГГ"

Месяц прописью ГГ г.

Декабрь 01г.

"ДММММ"

Месяц прописью

Декабрь

"ДККККГГГГ"

Номер квартала ГГГГ г.

4 Квартал 2001 г.

"ДККККГГ"

Номер квартала ГГ г.

4 Квартал 01 г.

"ДКККК"

Номер квартала.

4 Квартал

"ДГГГММДД"

ГГГММДЦ

20011205

"ДНННН"

Название дня недели даты; по умолчанию берется из секции WeekDay файла 1CV7.SPL

Среда