Valores voláteis nas funções

Uma função volátil é recalculada sempre que o Excel é recalculado, mesmo que nenhum dos argumentos da função tenha sido alterado. Use uma função personalizada volátil para valores que podem mudar independentemente de suas entradas, como datas, horas, números aleatórios e resultados de simulações.

Observação

Várias funções internas do Excel são voláteis, como RAND, TODAY, e NOW.

Para marcar uma função personalizada como volátil, adicione a @volatile tag ao seu comentário JSDoc. Para obter mais informações sobre metadados JSON de funções personalizadas, consulte Gerar metadados JSON automaticamente para funções personalizadas.

Criar uma função personalizada volátil

O exemplo a seguir usa @volatile para criar uma função personalizada que simula a rolagem de um dado de seis lados.

GIF mostrando uma função personalizada retornando um valor aleatório para simular a rolagem de um dado de seis lados.

/**
 * Simulates rolling a six-sided die.
 * @customfunction
 * @volatile
 */
function roll6sided() {
  return Math.floor(Math.random() * 6) + 1;
}

Próximas etapas

Confira também