Методы объекта "Счет"
ИспользоватьДату
Установить дату выборки периодических реквизитов счета.
Синтаксис:
ИспользоватьДату(<Дата>)
Англоязычный синоним:
UseDate
Параметры:
| <Дата> | Необязательный параметр. Выражение типа "дата". |
Возвращаемое значение:
Текущее значение используемой даты (на момент до исполнения метода).
Описание:
Метод ИспользоватьДату устанавливает для объекта типа "Счет" дату, на которую будут в дальнейшем выбираться (или записываться) значения периодических реквизитов счета.
Данный метод, используется обычно, если нужно обращаться сразу к не-сколькитм периодическим реквизитам спозиционированного объекта. Для одиночных обращений рекомендуется использовать методы периодического реквизита счета Получить(<Дата>) и Установить(<Дата>, <3начение>).
Замечание
Если к объекту типа "Счет" однажды применен метод ИспользоватьДату, то в дальнейшем, чтобы выбирать значения периодических реквизитов, нельзя применять к этому же объекту методы Получить и Установить, т. е. в такой последовательности эти методы несовместимы.
Замечание
Метод ИспользоватьДату устанавливает дату выборки для данного объекта. В случае, если обращение к объекту типа счет выполняется по длинному пути (например, Клиент.СчетУчета.СтатусУчета) значение типа "Счет" создается динамически и после первого обращения к нему с вызовом метода ИспользоватьДату уничтожается, поэому при повторном обращении для получении значения реквизита данная установка уже действовать не будет.
Замечание
Метод ИспользоватьДату должен быть вызван до позиционирования объекта. В этом случае после позиционирования периодические реквизиты будут выдаваться на указанную дату.
Пример:
Выведем список счетов со значением периодического реквизита "СтатусУчета".
Процедура Сформировать()
Сч = СоздатьОбъект("Счет.Основной");
Сч.ИспользоватьДату(РабочаяДата());
Сч.ВыбратьСчета();
Пока Сч.ПолучитьСчет() = 1 Цикл
Сообщить("Статус учета " + Сч.Код + " - " + Сч.СтатусУчета);
КонецЦикла;
КонецПроцедуры