DateAdd
Zastosowanie
Dział zatytułowany „Zastosowanie”Dodaje określoną liczbę jednostek czasu do wskazanej daty. Podając ujemną wartość uzyskujemy efekt odjęcia.
Składnia
Dział zatytułowany „Składnia”DateAdd("timeUnit", "baseDate", "amount");DateAdd("timeUnit", "baseDate", "amount", "region");Argumenty
Dział zatytułowany „Argumenty”- timeUnit- (string) Określa jednostkę czasu. Dopuszczalne wartości : [year | month | day | hour | minute | second | workday]
- baseDate– (DateTime) Data początkowa
- amount– (Decimal) liczba jednostek czasu
- region (String) [Optional] Używane tylko z timeUnit ==’workday’ . Określa ile dni roboczych ma być dodanych do daty bazowej Obsługiwane regiony : ’PL’ | ’HU’.
Zwracana wartość
Dział zatytułowany „Zwracana wartość”Funkcja zwraca wartość DateTime.
Zwracana nową datę z uwzględnieniem czasu po dodaniu wskazanej liczby jednostek czasu.
W przypadku błędnie podanych argumentów zwraca pusty string.
Elementy powiązane
Dział zatytułowany „Elementy powiązane”- Funkcja Today
- Dla argumentu „day” odpowiednikiem jest funkcja DayDiff
- Dla argumentu „hour” odpowiednikiem jest funkcja HourDiff
- Zobacz też YearDiff, MonthDiff,
Przykłady
Dział zatytułowany „Przykłady”Przykład 1
Dział zatytułowany „Przykład 1”nextMonth = DateAdd("month", CurrentDateTime(), 1);Dodaje jeden miesiąc do bieżącej daty i zapamiętuje wynik w zmiennej o nazwie nextMonth.
Przykład 2
Dział zatytułowany „Przykład 2”reminder = DateAdd("workday", CurrentDateTime(), 5, "PL");Dodaje 5 dni roboczych do bieżącej daty uwzględniając dni wolne i święta dla Polski i zapamiętuje nową datę w zmiennej o nazwie ’reminder’.
Przykład 3
Dział zatytułowany „Przykład 3”previousMonthDate = DateAdd("month", Today(), -1);Wyznacza datę poprzedniego miesiąca odpowiadającą dacie dzisiejszej.