Accelerating the pace of engineering and science

# ceil

Round toward positive infinity

## Description

example

Y = ceil(X) rounds each element of X to the nearest integer greater than or equal to that element.

example

Y = ceil(t) rounds each element of the duration array t to the nearest number of seconds greater than or equal to that element.

example

Y = ceil(t,unit) rounds each element of t to the nearest number of the specified unit of time greater than or equal to that element.

## Examples

expand all

### Round Matrix Elements Toward Positive Infinity

```X = [-1.9 -0.2 3.4; 5.6 7 2.4+3.6i];
Y = ceil(X)
```
```Y =

-1.0000 + 0.0000i   0.0000 + 0.0000i   4.0000 + 0.0000i
6.0000 + 0.0000i   7.0000 + 0.0000i   3.0000 + 4.0000i

```

### Round Duration Values Toward Positive Infinity

Round each value in a duration array to the nearest number of seconds greater than or equal to that value.

```t = hours(8) + minutes(29:31) + seconds(1.23);
t.Format = 'hh:mm:ss.SS'
```
```t =

08:29:01.22   08:30:01.22   08:31:01.22

```
```Y1 = ceil(t)
```
```Y1 =

08:29:02.00   08:30:02.00   08:31:02.00

```

Round each value in t to the nearest number of hours greater than or equal to that value.

```Y2 = ceil(t,'hours')
```
```Y2 =

09:00:00.00   09:00:00.00   09:00:00.00

```

## Input Arguments

expand all

### X — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array. For complex X, ceil treats the real and imaginary parts independently.

ceil converts char elements of X into double values.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char
Complex Number Support: Yes

### t — Input durationduration array

Input duration, specified as a duration array.

### unit — Unit of time'seconds' (default) | 'minutes' | 'hours' | 'days'

Unit of time, specified as 'seconds', 'minutes', 'hours', or 'days'.