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)."м.";
}
?>

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Алексей Мельников 09.08.2022 09:09:47

Сообщение не промодерировано, возможны ошибки и неточности.

Если нужно вывести данные, которые попадают в интервал, то фильтр нужно формировать подобным образом:

Код
// Вывести задачи, которые были созданы в июле 2022 $arFilter[">="."CREATED_DATE"] = "01.07.2022 00:00:00"; $arFilter["<="."CREATED_DATE"] = "31.07.2022 23:59:59";

Наверх