# Math

* [`bytes`](#bytes)
* [`ceil`](#ceil)
* [`floor`](#floor)
* [`round`](#round)
* [`degrees`](#degrees)
* [`radians`](#degrees)
* [`random`](#random)
* [`pow`](#pow)
* [`sqrt`](#sqrt)
* [`abs`](#abs)
* [`ordinal`](#ordinal)

You can check the module import [`here`](https://fknop.gitbook.io/angular-pipes/documentation/modules).

## bytes

Returns the bytes to an human-readable format.

### File

```typescript
import { NgBytesPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 150 | bytes }}
<!-- 150 B -->
{{ 1024 | bytes }}
<!-- 1 KB -->
{{ 1048576 | bytes }}
<!-- 1 MB -->
{{ 1024 | bytes: 0 : 'KB' }}
<!-- 1 MB -->
{{ 1073741824 | bytes }}
<!-- 1 GB -->
{{ 1099511627776 | bytes }}
<!-- 1 TB -->
{{ 1073741824 | bytes : 0 : 'B' : 'MB' }}
<!-- 1024 MB -->
```

### Todo

* Be able to change the input unit.

## ceil

Ceils a number with a given precision. Take a look at the official documentation on ceil.

### File

```typescript
import { NgCeilPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 3.4 | ceil }}
<!-- 4 -->
{{ 1.5 | ceil: 1 }}
<!-- 1.5 -->
{{ 1.5444 | ceil: 2 }}
<!-- 1.55 -->
```

## floor

Floor a number with a given precision. Take a look at the official documentation on floor.

### File

```typescript
import { NgFloorPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 3.4 | floor }}
<!-- 3 -->
{{ 1.5 | floor: 1 }}
<!-- 1.5 -->
{{ 1.5444 | floor: 2 }}
<!-- 1.54 -->
```

## round

Rounds a number with a given precision. Take a look at the official documentation on round.

### File

```typescript
import { NgRoundPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 3.4 | round }}
<!-- 3 -->
{{ 3.5 | round }}
<!-- 4 -->
{{ 1.5 | round: 1 }}
<!-- 1.5 -->
{{ 1.5444 | round: 2 }}
<!-- 1.54 -->
{{ 1.345 | round: 2 }}
<!-- 1.35 -->
```

## degrees

Converts radians to degrees.

### File

```typescript
import { NgDegreesPipeModule } from 'angular-pipes';
```

### Usage

```javascript
this.value = Math.PI;
```

```markup
{{ value | degrees }}
<!-- 180 -->
```

## radians

Converts degrees to radians

### File

```typescript
import { NgRadiansPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 180 | radians }}
<!-- PI -->
```

## random

Returns a random number between a minimum (default: 0) and a maximum (default: 1). The input is ignored. If only one argument is given, it will be the maximum.

### File

```typescript
import { NgRandomPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ {} | random: 0: 1 }}
<!-- Random number between 0 and 1 -->
{{ {} | random: 0: 10 }}
<!-- Random number between 0 and 10 -->
{{ {} | random: 10 }}
<!-- Random number between 0 and 10 -->
```

## sqrt

Returns the square root of a number.

### File

```typescript
import { NgSqrtPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 81 | sqrt }}
<!-- 9 -->
```

## pow

Returns the power of a number.

### File

```typescript
import { NgPowPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 2 | pow }}
<!-- 4 -->
{{ 2 | pow: 3 }}
<!-- 8 -->
```

## abs

Returns the absolute of a number.

### File

```typescript
import { NgAbsPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ -2 | abs }}
<!-- 2 -->
```

## ordinal

Returns the number with a suffix indicating the ordinal.

### File

```typescript
import { NgOrdinalPipeModule } from 'angular-pipes';
```

### Usage

```markup
{{ 1 | ordinal }}
<!-- 1st -->
{{ 523 | ordinal }}
<!-- 523rd -->
{{ 15 | ordinal }}
<!-- 15th -->
```