Документация для разработчиков
Темная тема

GetUserGroupEx

CDBResult public static CUser::GetUserGroupEx(
	int $ID
);

Метод возвращает расширенную информацию об активных группах пользователя. Метод статический.

Используйте CUser::GetUserGroupEx, когда кроме идентификаторов групп нужны символьные коды групп или даты активности привязки пользователя к группе. Если нужны только идентификаторы групп, используйте CUser::GetUserGroup.

Параметры вызова

Параметр Описание
$ID Идентификатор пользователя.

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

Метод возвращает объект CDBResult. Каждая запись результата содержит данные одной активной группы пользователя.

Поле Описание
GROUP_ID Идентификатор группы.
STRING_ID Символьный идентификатор группы.
DATE_ACTIVE_FROM Дата начала активности привязки пользователя к группе. Значение может быть пустым.
DATE_ACTIVE_TO Дата окончания активности привязки пользователя к группе. Значение может быть пустым.

Метод выбирает только активные группы и только те привязки пользователя к группам, у которых период активности не истек и уже начался. В результат всегда добавляется группа всех пользователей с GROUP_ID = 2 и STRING_ID = everyone.

Смотрите также

Примеры

Получение расширенной информации о группах пользователя:

$userId = 12;

$rsGroups = CUser::GetUserGroupEx($userId);

while ($group = $rsGroups->Fetch())
{
	echo $group['GROUP_ID'] . ': ' . $group['STRING_ID'];
}


© «Битрикс», 2001-2026, «1С-Битрикс», 2026