MonthDiff
Zastosowanie
Dział zatytułowany „Zastosowanie”Funkcja MonthDiff zwraca liczbę pełnych miesięcy między dwiema datami. Każdy rok liczy się jako kolejne 12 miesięcy. Wynik nigdy nie jest ujemny, także wtedy, gdy druga data jest wcześniejsza od pierwszej.
Składnia
Dział zatytułowany „Składnia”MonthDiff("dateFrom","dateTo");Argumenty
Dział zatytułowany „Argumenty”| Argument | Typ | Wymagany | Opis |
|---|---|---|---|
dateFrom |
tekst | Tak | Pierwsza data. |
dateTo |
tekst | Tak | Druga data. |
Zwracana wartość
Dział zatytułowany „Zwracana wartość”Funkcja zwraca liczbę: całkowitą liczbę miesięcy między dwiema datami.
Przykłady
Dział zatytułowany „Przykłady”Przykład 1: kilka miesięcy w jednym roku
Dział zatytułowany „Przykład 1: kilka miesięcy w jednym roku”Wynik: 5.
months = MonthDiff(2015-06-04, 2015-11-16);Przykład 2: daty w tym samym miesiącu
Dział zatytułowany „Przykład 2: daty w tym samym miesiącu”Wynik: 0.
months = MonthDiff(2015-06-01, 2015-06-30);Przykład 3: przejście na kolejny miesiąc
Dział zatytułowany „Przykład 3: przejście na kolejny miesiąc”Wynik: 0.
months = MonthDiff(2015-06-30, 2015-07-01);Przykład 4: daty w różnych latach
Dział zatytułowany „Przykład 4: daty w różnych latach”Wynik: 9.
months = MonthDiff(2015-06-01, 2016-03-30);Przykład 5: odwrócona kolejność dat
Dział zatytułowany „Przykład 5: odwrócona kolejność dat”Wynik: 9.
months = MonthDiff(2016-06-01, 2015-03-30);Przykład 6: daty z pól sprawy
Dział zatytułowany „Przykład 6: daty z pól sprawy”Funkcja liczy pełne miesiące między datami zapisanymi w polach sprawy Date from i Date to.
result = MonthDiff( [Date from], [Date to] );Dobre praktyki
Dział zatytułowany „Dobre praktyki”- Przed wywołaniem funkcji sprawdź, czy obie daty są poprawne i mają właściwy format.
- Używaj funkcji do obliczeń w pełnych miesiącach, np. okresów rozliczeniowych albo czasu trwania projektu.
Typowe błędy
Dział zatytułowany „Typowe błędy”- Niepoprawne albo źle sformatowane daty. Funkcja może zwrócić 0 albo zgłosić błąd. Sprawdź i popraw format dat przed wywołaniem funkcji.
- Oczekiwanie wyniku zależnego od kolejności dat. Funkcja zawsze zwraca wartość nieujemną, niezależnie od kolejności argumentów. Jeżeli kolejność dat ma znaczenie w procesie, sprawdź ją osobno.