Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы объекта "Счет"

ИспользоватьДату

Установить дату выборки периодических реквизитов счета.

Синтаксис:

ИспользоватьДату(<Дата>)

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

UseDate

Параметры:

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

Текущее значение используемой даты (на момент до исполнения метода).

Описание:

Метод ИспользоватьДату устанавливает для объекта типа "Счет" дату, на которую будут в дальнейшем выбираться (или записываться) значения периодических реквизитов счета.

Данный метод, используется обычно, если нужно обращаться сразу к не-сколькитм периодическим реквизитам спозиционированного объекта. Для одиночных обращений рекомендуется использовать методы периодического реквизита счета Получить(<Дата>) и Установить(<Дата>, <3начение>).

Замечание
Если к объекту типа "Счет" однажды применен метод ИспользоватьДату, то в дальнейшем, чтобы выбирать значения периодических реквизитов, нельзя применять к этому же объекту методы Получить и Установить, т. е. в такой последовательности эти методы несовместимы.

Замечание
Метод ИспользоватьДату устанавливает дату выборки для данного объекта. В случае, если обращение к объекту типа счет выполняется по длинному пути (например, Клиент.СчетУчета.СтатусУчета) значение типа "Счет" создается динамически и после первого обращения к нему с вызовом метода ИспользоватьДату уничтожается, поэому при повторном обращении для получении значения реквизита данная установка уже действовать не будет.

Замечание
Метод ИспользоватьДату должен быть вызван до позиционирования объекта. В этом случае после позиционирования периодические реквизиты будут выдаваться на указанную дату.

Пример:

Выведем список счетов со значением периодического реквизита "СтатусУчета".

Процедура Сформировать()

Сч = СоздатьОбъект("Счет.Основной");

Сч.ИспользоватьДату(РабочаяДата());

Сч.ВыбратьСчета();

Пока Сч.ПолучитьСчет() = 1 Цикл

Сообщить("Статус учета " + Сч.Код + " - " + Сч.СтатусУчета);

КонецЦикла;

КонецПроцедуры