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