Somando valores em que foram associados a datas em um mês específico

Tome a seguinte planilha:

	Recebido	Finalizados
31/03/2020	22	9
01/04/2020	8	5
02/04/2020	12	4
03/05/2020	5	0
04/05/2020	0	0
05/05/2020	10	13
06/06/2020	12	1
07/06/2020	3	20
08/06/2020	0	4

Imagine que você queria uma consolidação por mês, somando os valores dos recebidos no més de março, abril, maio e junho, como o que temos abaixo:

Mês
Recebidos
Finalizados
03/2020
22
9
04/2020
20
9
05/2020
15
13
06/2020
15
25

Certamente o seu primeiro pensamento deve ser a função SOMASE, o que é bem coerente. Porém existe um problema no uso dessa função:

• criterio - O padrão ou teste a ser aplicado em intervalo.

  • Se intervalo contiver texto para verificação, criterio deverá ser uma string. criterio pode conter caracteres curinga, inclusive ? para corresponder a qualquer caractere individual e * para corresponder a zero ou mais caracteres adjacentes. Para fazer correspondência com um ponto de interrogação ou asterisco, adicione o prefixo (~) (por exemplo, ~? e ~*). Um critério para string deve ficar entre aspas. O criterio é conferido em cada célula no intervalo em busca de igualdade (ou correspondência, se caracteres curinga forem usados).

  • Se intervalo contiver números para verificação, criterio poderá ser string ou número. Se um número for fornecido, o criterio será conferido em todas as células do intervalo em busca de igualdade. Caso contrário, criterio pode ser uma string que contém um número (que também é sujeito a verificações de igualdade) ou um número prefixado por qualquer um dos seguintes operadores: = (verificações de igualdade), > (verifica se o valor do intervalo de células é maior que o valor do critério) ou < (verifica se o valor do intervalo de células é menor que o valor do critério)

Isso limita as possibilidades, pois os dados apresentam uma data completa, com dia, mês e ano. Se nos critérios pudéssemos usar a função MÊS(), tudo estaria resolvido, mas não é possível.

Dessa forma, fui fazer uma função para servir como uma extensão da SOMASE(), onde o critério pudesse ser uma formula genérica, integrando com a função que expliquei aqui. Poderia ter resolvido e criado uma super poderosa função SOMASE(). Mas aí me deparei com isso aqui 

Using Apps Script services

Nesse link, fala-se que todas as Custom Functions só podem usar a maioria dos métodos get e nenhum método set do objeto SpreadsheetApp. Isso impede o uso do setFormula(). Volto então a uma idéia de função que trate diretamente com a questão de comparar o mês da minha tabela consolidada, com o mês extraído da célula que tem a data completa do registro. Código abaixo: 

/**
* Somase com o critério de uma fórmula
* @param intervalo_teste O intervalo onde o a fórmula será testada
* @param reference_month A célula que tem o mês de referência para comparação
* @param intervalo_a_somar O intervalo que terá os dados a serem somados
* @customfunction
*/
function MONTHLY_SUM(intervalo_teste, reference_month, intervalo_a_somar){
  var ss = SpreadsheetApp.getActiveSheet();
  var data = intervalo_teste;
  var data2Sum = intervalo_a_somar;
  
  var d1, d2;
  var sum2return = 0;
  for(var i=0; i<data.length; i++){
    d1 = new Date(reference_month);
    d2 = new Date(data[i]);
    if(d1.getMonth() === d2.getMonth()){
      if(parseInt(data2Sum[i])){
        sum2return += parseInt(data2Sum[i]);
      }
    }
  }
  return sum2return
}

Em outro momento falo sobre esses comentários estilosos antes do código mesmo da função, e o que eles proporcionam