RoundCeil (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

Numeric values management functions

Math functions

RoundCeil

Presentation

Example

See also

RoundCeil (Function)

In french: ArrondiSupérieur

Warning
From version 28, RoundUp is kept for backward compatibility. This function is replaced by RoundCeil.

Returns:

the value rounded up to the nearest integer.
New in version 28
the duration rounded up to the nearest interval.
Not available.
New in version 28
the datetime rounded up to the nearest interval.
Not available.

Example

ResArrondi = RoundCeil(-16.238167, 2) // Renvoie -16.23
ResArrondi = RoundCeil(3.1) // Renvoie 4 (pas de décimales)
ResArrondi = RoundCeil(3.111, 2) // Renvoie 3.12
ResArrondi = RoundCeil(1.9) // Renvoie 2
ResArrondi = RoundCeil(-1.9) // Renvoie -1

New in version 28

// Arrondi d'une Durée
ResArrondiDurée is Duration
ResArrondiDurée = RoundCeil(13 min, 5 min) // Renvoie 15 min (0001500000)
// La durée est découpée en périodes de 5 minutes.
// Le résultat correspond à la fin de la période qui contient la durée 13 min.

New in version 28

// Arrondi d'une DateHeure
dhMonDateHeure is DateTime = "202211041524"
Trace("dhMonDateHeure: " + dhMonDateHeure)
Trace("ArrondiSupérieur: " + RoundCeil(dhMonDateHeure, 7 min))
// Affiche 20221104153100000

// La journée est découpée en périodes de 7 min.

Syntax

Calculate the upper rounding of a numerical value Hide the details

<Result> = RoundCeil(<Numeric value> [, <Number of decimals>])

<Result>: Integer or real

Value rounded to the greater number.

<Numeric value>: Real or currency

Numeric value to round.

<Number of decimals>: Optional integer

Number of decimals to return. No decimal is returned if this parameter is not specified.

New in version 28

Not available

Calculate the upper rounding of a Duration for a given interval Hide the details

<Result> = RoundCeil(<Duration used> , <Interval>)

<Result>: Duration

Duration corresponding to the end of the given interval.

<Duration used>: Duration

Duration to be rounded off:
Duration variable containing the duration in "+DHHMMSSCCC" format (D corresponds to the number of days, HH to hours, MM to minutes, SS to seconds and CCC to milliseconds).
Duration in a readable format (e.g., 1 d 2 h 3 min 10 s 10 ms).

<Interval>: Duration

Period taken into account for the calculation of the upper rounding:
Duration variable containing the duration in "+DHHMMSSCCC" format (D corresponds to the number of days, HH to hours, MM to minutes, SS to seconds and CCC to milliseconds).
Duration in a readable format (e.g., 1 d 2 h 3 min 10 s 10 ms).

New in version 28

Not available

Calculate the upper rounding of a DateTime for a given interval Hide the details

<Result> = RoundCeil(<Manipulated DateTime> , <Interval>)

<Result>: DateTime

DateTime corresponding to the end of the given interval.

<Manipulated DateTime>: DateTime

Date and time to be rounded.

<Interval>: Duration

Period taken into account for the calculation of the upper rounding:
Duration variable containing the duration in "+DHHMMSSCCC" format (D corresponds to the number of days, HH to hours, MM to minutes, SS to seconds and CCC to milliseconds).
Duration in a readable format (e.g., 1 d 2 h 3 min 10 s 10 ms).

Remarks

The decimal separator for the real numbers is "." (dot).

Business / UI classification: Neutral code

Component: wd280mat.dll