# @univerjs/sheets-formula

> Language fallback: requested `zh-CN`; content is `en-US`.

- Human documentation: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs/sheets-formula](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs/sheets-formula)

- Agent Markdown: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs/sheets-formula.md](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs/sheets-formula.md)

- Requested language: `zh-CN`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [packages/plugins/univerjs/sheets-formula.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs/sheets-formula.mdx)

---

Sheet formula services and calculation integration for Univer Sheets.

```typescript
// [!code word:UniverSheetsFormulaPlugin]
// [!code word:IUniverSheetsFormulaBaseConfig]
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'

univer.registerPlugin(UniverSheetsFormulaPlugin, IUniverSheetsFormulaBaseConfig)
```

## Entry Points

* Facade: `@univerjs/sheets-formula/facade`
* Locale: `@univerjs/sheets-formula/locale/*`

## IUniverSheetsFormulaBaseConfig

```ts
import type { Ctor } from '@univerjs/core'
import type { BaseFunction, IFunctionInfo, IFunctionNames } from '@univerjs/engine-formula'

export interface IUniverSheetsFormulaBaseConfig {
  notExecuteFormula?: boolean
  description?: IFunctionInfo[]
  function?: Array<[Ctor<BaseFunction>, IFunctionNames]>

  /**
   * Define the calculation mode during initialization, default is `WHEN_EMPTY`
   */
  initialFormulaComputing?: CalculationMode

  /**
   * If true, the plugin will write array formula results to the snapshot. Normally you should not set this value.
   */
  writeArrayFormulaToSnapshot?: boolean
}
```

## IUniverSheetsFormulaRemoteConfig

```ts
import type { Ctor } from '@univerjs/core'
import type { BaseFunction, IFunctionInfo, IFunctionNames } from '@univerjs/engine-formula'

export interface IUniverSheetsFormulaRemoteConfig {}
```