Compartilhar via


Valores voláteis nas funções

Funções voláteis são funções nas quais o valor é alterado sempre que a célula é calculada. O valor pode ser alterado mesmo se nenhum dos argumentos da função for alterado. Essas funções são recalculadas sempre que o Excel recalcular. Por exemplo, imagine uma célula que chame a função NOW. Toda vez que NOW for chamado, retornará automaticamente a data e a hora atuais.

Importante

Observe que as funções personalizadas do Excel estão disponíveis nas plataformas a seguir.

  • Office na Web
  • Office no Windows
    • Assinatura do Microsoft 365
    • varejo perpétuo Office 2016 e posterior
    • Office 2021 perpétuo licenciado por volume e posterior
  • Office no Mac

No momento, as funções personalizadas do Excel não têm suporte no seguinte:

  • Office no iPad
  • versões perpétuas licenciadas por volume do Office 2019 ou anteriores no Windows

O Excel contém várias funções voláteis internas, como RAND e TODAY. Para ver uma lista mais completa de funções voláteis do Excel, confira Funções voláteis e não voláteis.

As funções personalizadas permitem criar suas próprias funções voláteis, o que pode ser útil ao manipular datas, horários, números aleatórios e modelagem. Por exemplo, simulações de Monte Carlo exigem a geração de entradas aleatórias para determinar uma solução ideal.

Se optar por habilitar automaticamente seu arquivo JSON, declare uma função volátil com a marca @volatilede comentário JSDoc . Em mais informações sobre a regeneração automática, confira Metadados JSON de autogeneração para funções personalizadas.

Segue-se um exemplo de uma função personalizada volátil, 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 6-sided dice.
 * @customfunction
 * @volatile
 */
function roll6sided() {
  return Math.floor(Math.random() * 6) + 1;
}

Próximas etapas

Confira também