Funkcia %NextPeriod


Popis

Funkcia vráti čas zarovnaný na začiatok nasledujúcej periódy.

Deklarácia

TIME %NextPeriod(
	TIME		_time, 
	INT|TEXT	_period
	[, INT		_count := 1]
)

Parametre

_time

Čas na zarovnanie

_period

Perióda. Môže byť zadaná ako jedna zo %STEP_* konštánt, ako _STEP pre použitie periódy vypočítaného vektora, ako id periódy vytvorenej funkciou %CreatePeriod alebo ako id/kód preddefinovanej periódy.

_count

Počet nasledujúcich periód. Napr. pri zadaní 2, bude vrátený čas zarovnaný na druhú najbližšiu periódu. 

Príklad

VECTOR _v;
INT _period;

-- vytvorí 2-hodinovú periódu
_period := %CreatePeriod(%TimeFromItems(2016, 1, 1, 0, 0, 0),
%StepBase_Second, 7200);

-- vytvorí výstupný vektor s dvoma hodnotami, ktorých časy pokryjú celý interval <_BT, _ET> zarovnaný podľa vytvorenej periódy
%CreateVector(_v, 2);
%SetItemTime(_v, 1, %BeginPeriod(_BT, _period));
%SetItemTime(_v, 2, %NextPeriod(_ET, _period) - 1);

RETURN _v;
Napíšte komentár