Partilhar via


Método Range.Group (Excel)

Quando o objeto Intervalo representa uma única célula no intervalo de dados de um campo de tabela dinâmica, o método Group efetua um agrupamento numérico ou baseado em datas nesse campo.

Sintaxe

expressão. Grupo (Início, Fim, 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 Variant O primeiro valor a ser agrupado. Se este argumento for omitido ou for True, será usado o primeiro valor no campo.
End Opcional Variant O último valor a ser agrupado. Se este argumento for omitido ou for True, será usado o último valor no campo.
By Opcional Variant 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 Variant 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, este argumento é 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 Trimestres
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 Intervalo tem de 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.