NextPeriod
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;