Описание встроенного языка системы 1С Предприятие


         

ВыбратьЗаписи


Выбрать записи, действующие в определенном временном интервале.

Синтаксис:

ВыбратьЗаписи(<Начало>, <Окончание>}

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

SelectRecords

Параметры:



<Начало>

Дата начала периода.

<Окончание>

Дата окончания периода.

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

Число: 1 — если операция успешно выполнена и выборка не пуста, т. е. со­держит хотя бы одну запись; 0 — в противном случае.

Описание:

Метод открывает выборку записей журнала расчетов. Выбираются все запи­си, период действия которых хоть на один день затрагивается тем периодом, который задан параметрами <Начало> и <Окончание>. Это значит, например, что если запись журнала расчетов имеет даты начала и окончания '15.12.96' и '25.12.96' то она попадет в выборку, открытую при помощи любого из следующих методов:

  • ВыбратьЗаписи(•10.10.96', •15.12.96')
  • ВыбратьЗаписи('25.12.96', '01.01.97')
  • ВыбратьЗаписи('17.12.96', '17.12.96').
  • Как правило, после применения данного метода проводится перебор всех записей выборки в цикле при помощи метода журнала расчетов ПолучитьЗапись.

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

    Пример:

    // Расчет количества дней, отработанных всеми сотрудниками

    // за прошлый период

    //

    // журнал расчета зарплаты

    ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

    // дата начала прошлого периода

    ДатаНачала = ЖР.НачалоПериодаПоДате(ЖР.НачалоТекущегоПериода() - 1);

    ЖР.ВыбратьЗаписи(ДатаНачала, ЖР.КонецПериодаПоДате(ДатаНачала));

    Пока ЖР.ПолучитьЗапись() > 0 Цикл

       Сумма = Сумма + ЖР.ДНИ;

    КонецЦикла;

    См. также: методы ВыбратьЗаписиПоОбъекту, ВыбратьПериод, атрибуты ДатаНачала, ДатаОкончания



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