GetList

Описание и параметры

CDBResult
CTaskElapsedTime::GetList(
	array arOrder = array(),
	array arFilter = array(),
	array arParams = array()
);

Возвращает список записей о затраченном времени по фильтру arFilter, отсортированный в порядке arOrder. Метод статический.

Параметры метода

Параметр	Описание	С версии
arOrder	Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]). Поле для сортировки может принимать значения: ID - идентификатор задачи; USER - идентификатор пользователя. Направление сортировки может принимать значения: asc - по возрастанию; desc - по убыванию; Необязательный. По умолчанию фильтруется по дате добавления.
arFilter	Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения: CREATED_DATE - дата добавления; ID - идентификатор записи; USER_ID - идентификатор пользователя; TASK_ID - идентификатор задачи. Перед названием фильтруемого поля может указать тип фильтрации: "!" - не равно "<" - меньше "<=" - меньше либо равно ">" - больше ">=" - больше либо равно "значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются.
arParams	Массив дополнительных параметров. Необязательный.	12.5.4

Параметр

Описание

С версии

arOrder

Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:

ID - идентификатор задачи;
USER - идентификатор пользователя.

Направление сортировки может принимать значения:

asc - по возрастанию;
desc - по убыванию;

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

arFilter

Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:

CREATED_DATE - дата добавления;
ID - идентификатор записи;
USER_ID - идентификатор пользователя;
TASK_ID - идентификатор задачи.

Перед названием фильтруемого поля может указать тип фильтрации:

"!" - не равно
"<" - меньше
"<=" - меньше либо равно
">" - больше
">=" - больше либо равно

"значения фильтра" - одиночное значение или массив.

Необязательный. По умолчанию записи не фильтруются.

arParams

Массив дополнительных параметров. Необязательный.

12.5.4

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

Возвращается объект CDBResult.

Примеры использования

<?
// Посчитаем затраченное время для задачи с ID = 2
if (CModule::IncludeModule("tasks"))
{
	$res = CTaskElapsedTime::GetList(
		Array(), 
		Array("TASK_ID" => "2")
	);
	$elapsedTime = 0;
	while ($arElapsed = $res->Fetch())
	{
		$elapsedTime += $arElapsed["MINUTES"];
	}
	echo "Затраченное время: ".floor($elapsedTime / 60)."ч. ".($elapsedTime % 60)."м.";
}
?>