Funkcja DATEDIFF

Funkcja DATEDIFF oblicza różnicę pomiędzy dwiema datami wyrażoną w wybranej jednostce czasu.

Funkcja DATEDIFF — czym jest i do czego służy

Funkcja DATEDIFF służy do porównywania dwóch wartości daty lub czasu i określania odstępu między nimi według wskazanego sposobu liczenia. W zależności od używanego systemu baz danych wynikiem może być liczba dni, miesięcy, lat, godzin, minut albo innych jednostek obsługiwanych przez daną składnię. Dzięki temu można sprawdzać między innymi, ile czasu minęło od utworzenia rekordu, jak długo trwa realizacja zgłoszenia, czy termin płatności już upłynął oraz ile dni dzieli dwa zdarzenia zapisane w tabeli.

Warto pamiętać, że DATEDIFF nie jest zwykłym odejmowaniem dwóch znaczników czasu. Funkcja korzysta z określonych granic jednostek kalendarzowych. Oznacza to, że wynik zależy nie tylko od dokładnej liczby godzin lub minut, lecz także od tego, ile razy podczas porównywanego okresu przekroczono granicę dnia, miesiąca, kwartału albo roku. Z tego powodu prawidłowa interpretacja wyniku wymaga znajomości konkretnego silnika SQL i jego reguł.

Najczęściej funkcję spotyka się w zapytaniach raportowych, filtrach, warunkach wyboru rekordów i obliczeniach wykonywanych na danych historycznych. Może być stosowana zarówno na kolumnach tabeli, jak i na wartościach zapisanych bezpośrednio w zapytaniu. Szczególną ostrożność zaleca się przy danych zawierających godzinę, strefę czasową lub wartości puste.

DATEDIFF w SQL — kontekst techniczny i porównania

W wielu popularnych systemach składnia funkcji obejmuje jednostkę czasu oraz dwie daty, lecz kolejność argumentów i dostępne jednostki mogą się różnić. W jednym środowisku jednostka jest pierwszym argumentem, w innym funkcja może przyjmować tylko dwie wartości albo mieć nazwę i zachowanie właściwe dla konkretnego producenta. Przed użyciem należy sprawdzić dokumentację wybranej bazy, ponieważ przeniesienie zapytania między systemami bez zmian może prowadzić do błędnego wyniku lub błędu składni.

W uproszczonym przykładzie różnicę dni można zapisać w formie zbliżonej do:

DATEDIFF(day, data_poczatkowa, data_koncowa)

Taki zapis ma charakter poglądowy. W praktycznym zapytaniu nazwy kolumn, sposób oznaczania jednostki i format dat powinny odpowiadać używanemu systemowi. Jeżeli porównywane są wartości „2026-03-01 23:50” oraz „2026-03-02 00:10”, różnica w godzinach wynosi mniej niż jedną godzinę, ale różnica liczona według granic dni może wynieść jeden dzień. To właśnie odróżnia DATEDIFF od obliczenia polegającego na bezpośrednim odjęciu znaczników czasu.

Podobne zadania można realizować przez odejmowanie dat, funkcje dodawania interwałów, konwersję do liczby dni lub wykorzystanie funkcji związanych z przedziałami czasowymi. DATEDIFF jest zwykle czytelniejszy, gdy intencją jest porównanie konkretnej jednostki. Bezpośrednie odejmowanie może lepiej sprawdzić się wtedy, gdy potrzebna jest dokładna długość przedziału z zachowaniem godzin, minut i sekund. Przy miesiącach oraz latach trzeba uwzględnić zmienną długość miesięcy, lata przestępne i różne zasady zaokrąglania.

Funkcja DATEDIFF — typowe problemy w zapytaniach

Jednym z częstych problemów jest odwrócenie dat początkowej i końcowej. W zależności od implementacji wynik może wtedy być ujemny. Nie musi to oznaczać awarii, ponieważ wartość ujemna może prawidłowo wskazywać, że zdarzenie planowane jest przed punktem odniesienia. Jeżeli raport ma prezentować wyłącznie czas, który upłynął, należy świadomie zdecydować, czy wartości ujemne powinny zostać odfiltrowane, zamienione na zero, czy pokazane użytkownikowi.

Drugim problemem są wartości puste. Gdy jedna z dat ma wartość NULL, wynik często także staje się NULL. Taki rezultat może zostać pominięty przez filtr lub spowodować brak danych w kolumnie obliczeniowej. Przed zastosowaniem DATEDIFF należy ustalić, co oznacza brak daty: nieznany termin, jeszcze nierozpoczęty proces, brak zakończenia czy błąd w danych. Dopiero potem można dobrać właściwą obsługę wartości pustych.

Ryzyko błędu zwiększa również mieszanie typu DATE z typem DATETIME albo TIMESTAMP. Data bez godziny i znacznik czasu nie opisują informacji z taką samą dokładnością. Jeżeli raport ma analizować pełne dni, można celowo pominąć część godzinową. Jeżeli natomiast mierzone jest rzeczywiste trwanie procesu, usunięcie godziny może zafałszować rezultat. Podobnej uwagi wymagają strefy czasowe: ten sam moment może być zapisany pod różną godziną w zależności od ustawień serwera, aplikacji i użytkownika.

Nieprawidłowo użyta funkcja może też obciążyć zapytanie. Warunek, w którym DATEDIFF jest wykonywany na kolumnie dla każdego wiersza, może utrudnić wykorzystanie indeksu. W dużych tabelach korzystniejsze bywa przekształcenie warunku do postaci porównującej kolumnę z wyliczoną datą graniczną. Wymaga to jednak sprawdzenia planu wykonania i przetestowania zapytania na danych o rzeczywistym rozmiarze.

DATEDIFF — praktyczne wskazówki stosowania

Przed napisaniem zapytania należy określić, co dokładnie ma oznaczać „różnica”. Może chodzić o liczbę pełnych dób, liczbę przekroczonych dni kalendarzowych, liczbę rozpoczętych miesięcy albo czas trwania wyrażony w minutach. Te pojęcia nie zawsze dają taki sam wynik. Wymaganie warto zapisać słownie, a następnie przełożyć je na jednostkę obsługiwaną przez bazę.

• Należy jednoznacznie wskazać, która data jest początkiem, a która końcem porównania.
• Warto sprawdzić zachowanie funkcji dla tego samego dnia, końca miesiąca, początku nowego roku i daty przestępnej.
• Przy danych zawierających godzinę trzeba zdecydować, czy ma być uwzględniana, czy pomijana.
• W przypadku wartości NULL należy zdefiniować oczekiwany wynik zamiast pozostawiać zachowanie przypadkowi.
• Zapytanie powinno być testowane na datach wcześniejszych i późniejszych od daty odniesienia.
• Przy filtrach używanych często lub na dużych tabelach warto sprawdzić wpływ funkcji na indeksy i plan wykonania.
• W raporcie dobrze jest opisać jednostkę wyniku, aby odbiorca nie pomylił dni kalendarzowych z pełnymi okresami trwającymi dwadzieścia cztery godziny.

Przydatne jest także rozdzielenie warstwy obliczeniowej od prezentacyjnej. Baza może zwracać liczbę dni jako wartość liczbową, natomiast aplikacja może dopiero później wyświetlać odpowiedni opis. Dzięki temu łatwiej sortować, filtrować i agregować wyniki. Należy też unikać konwersji dat do tekstu przed wykonaniem obliczeń, ponieważ format tekstowy może zależeć od ustawień regionalnych i utrudniać prawidłowe porównanie.

Funkcja DATEDIFF — kiedy zgłosić się do serwisu

Problemy z DATEDIFF mogą wyglądać jak błąd aplikacji, mimo że ich źródłem jest format danych, ustawienie strefy czasowej, niejednoznaczna składnia albo nieprawidłowy typ kolumny. Zgłoszenie do serwisu może być zasadne, gdy raport pokazuje różne wartości na poszczególnych stanowiskach, filtry dat nie zwracają oczekiwanych rekordów, obliczenia działają wyraźnie wolniej po zmianie zapytania albo po migracji bazy pojawiły się rozbieżności w wynikach.

W ramach przygotowania warto zebrać przykładowe daty, fragment zapytania, nazwę używanego systemu baz danych oraz opis oczekiwanego rezultatu. Pomocne jest również wskazanie, czy problem występuje dla wszystkich rekordów, czy tylko dla końca miesiąca, zmiany czasu lub wartości pustych. Warszawskie Pogotowie Komputerowe 24/7 może zostać uwzględnione jako punkt kontaktu przy analizie problemów z komputerem, aplikacją lub środowiskiem, w którym wykonywane są zapytania. Im dokładniej opisany zostanie przypadek, tym łatwiej odróżnić błąd funkcji od błędu danych, konfiguracji albo logiki raportu.