SetReminder

Zastosowanie

Funkcja SetReminder ustawia termin realizacji bieżącej sprawy. Działa tak samo jak SetDeadline. Termin możesz podać wprost albo jako liczbę dni i minut od chwili uruchomienia reguły. Jeżeli sprawa ma już ustawiony termin, funkcja go nadpisuje.

Składnia

SetReminder(days,minutes);

SetReminder(reminderDate)

Argumenty

Argument	Typ	Wymagany	Opis
`reminderDate`	data i godzina	Tak	Data (i godzina) terminu.
`days`	liczba	Tak	Liczba dni od bieżącej daty.
`minutes`	liczba	Tak	Liczba minut od bieżącej daty.

W pierwszym wariancie składni podajesz argumenty days i minutes, w drugim tylko reminderDate.

Zwracana wartość

Funkcja zwraca wartość logiczną: true, jeżeli termin został ustawiony, w przeciwnym razie false.

Przykłady

Przykład 1: termin na konkretny dzień

Funkcja ustawia termin sprawy na 20 marca 2017 r.

SetReminder(DateTime(2017,3,20));

Przykład 2: termin za 14 dni

Funkcja ustawia termin bieżącej sprawy za 14 dni i 0 minut od bieżącej daty.

SetReminder(14,0);

Przykład 3: termin za 2 dni i 30 minut

Funkcja ustawia termin bieżącej sprawy za 2 dni i 30 minut od bieżącej daty.

SetReminder(2,30);

Dobre praktyki

Sprawdź, czy data terminu jest poprawna i ma właściwy format.
Do przypomnień względnych używaj argumentów days i minutes, zamiast wpisywać w regule konkretne daty.
Sprawdzaj zwracaną wartość, żeby upewnić się, że termin został ustawiony.

Typowe błędy

Nieprawidłowy format daty w reminderDate. Funkcja nie ustawi terminu. Podaj datę w poprawnym formacie, np. yyyy-MM-dd.
Ujemne wartości days albo minutes. Funkcja może działać nieprzewidywalnie albo zakończyć się niepowodzeniem. Podawaj wartości nieujemne (0 lub więcej).