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

# 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
 }
```