---
schema_version: "1"
id: 2b0eb5ee819a3d893d2997f1062156f3593ea4de68a643afe6c500f858ec67b7
title: acos
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/dataweave/2.11/dw-math-functions-acos.md
canonical_url: https://docs.mulesoft.com/dataweave/2.11/dw-math-functions-acos
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 3677529aae2895cdf08d8e4043ffef35530224f64a10b75ad668e2b10cb93d0a
description: MuleSoft Documentation Site
release: "2.11"
latest: false
---
---
product: DataWeave
version: 2.11
---

# acos

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

## acos(angle: Number): Number | NaN

Returns an arc cosine value that can range from `0.0` through pi.

If the absolute value of the input is greater than `1`, the result is `null`.

_Introduced in DataWeave version 2.4.0._

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>angle</code></p></td><td><div><div><p>Number to convert into it arc cosine value.</p></div></div></td></tr></tbody></table>

### Example

This example shows how `acos` behaves with different inputs.

#### Source

```DataWeave
%dw 2.0
import * from dw::util::Math
output application/json
---
{
  "acos0": acos(0),
  "acos13": acos(0.13),
  "acos-1": acos(-1),
  "acos1": acos(1),
  "acos1.1": acos(1.1)
}
```

#### Output

```Json
{
   "acos0": 1.5707963267948966,
   "acos13": 1.440427347091751,
   "acos-1": 3.141592653589793,
   "acos1": 0.0,
   "acos1.1": null
 }
```