Ler em inglês

Compartilhar via


Método Range.Group (Excel)

Quando o objeto Range representa uma única célula no intervalo de dados de um campo de Tabela Dinâmica, o método Group executa agrupamento numérico ou baseado em datas nesse campo.

Sintaxe

expressão. Grupo (Iniciar, Terminar, Por, Períodos)

expressão Uma variável que representa um objeto de Intervalo.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Start Opcional Variantes O primeiro valor a ser agrupado. Se este argumento for omitido ou for True, será usado o primeiro valor no campo.
End Opcional Variantes O último valor a ser agrupado. Se este argumento for omitido ou for True, será usado o último valor no campo.
By Opcional Variantes Se o campo for numérico, este argumento especificará o tamanho de cada grupo. Se o campo for uma data, este argumento especificará o número de dias em cada grupo se o elemento 4 da matriz Periods for True e todos os outros elementos forem False. Caso contrário, este argumento será ignorado. Se esse argumento for omitido, o Microsoft Excel escolherá automaticamente um tamanho de grupo padrão.
Periods Opcional Variantes Uma matriz de valores Boolean que especifica o período do grupo, descrito na seção Comentários. Se um elemento da matriz for True, será criado um grupo para a hora correspondente; se o elemento for False, nenhum grupo será criado. Se o campo não for um campo de data, esse argumento será ignorado.

Valor de retorno

Variant

Comentários

A matriz Boolean do parâmetro Periods contém os seguintes elementos:

Elemento da matriz Period
1 Segundos
2 Minutos
3 Horas
4 Dias
5 Meses
6 Quartos
7 Anos

Em função do grupo de formas ser tratado como uma forma única, o agrupamento e o desagrupamento das formas altera o número de itens da coleção Shapes e altera os números indexados de itens que vêm após os itens afetados na coleção.

O objeto Range deve ser uma única célula no intervalo de dados do campo tabela dinâmica. Se você tentar aplicar este método a mais de uma célula, ele falhará (sem exibir uma mensagem de erro).

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.