![]() ![]() |
Klasa statyczna DateTimeSpan udostępnia funkcje pozwalające określać długość odstępu czasu, jaki upłynął między dwoma datami lub godzinami, oraz dodawać i odejmować odstępy czasu. Klasa udostępnia też zestaw funkcji do operacji na różnicy dwóch dat. Odstępy czasu są zwykłymi liczbami, więc aplikacja może wykonywać na nich normalne działania matematyczne: mnożenie, dzielenie, dodawanie, odejmowanie itd. Jest to klasa statyczna. Aplikacja nie może utworzyć instancji tej klasy.
Funkcja zwraca nową datę, będącą sumą daty początkowej i przekazanej funkcji liczby lat, miesięcy i dni. Liczba miesięcy może przekraczać 12, a liczba dni może przekraczać liczbę dni w miesiącu. Efekt ostateczny odpowiada wykonaniu trzech osobnych operacji. Najpierw dodawane są lata. Następnie do wynikowej daty dodawane są miesiące. Na koniec do wyniku dodawane są dni.
Data powstała w wyniku dodania miesiąca może nie być poprawna. Na przykład wynikiem dodania jednego miesiąca do 31 stycznia byłaby niepoprawna data 31 lutego. Funkcja koryguje datę na prawidłową. W tym przypadku, jeśli rok nie jest przestępny, to luty ma 28 dni i wynikową datą będzie 3 marca.
Każdy z argumentów lat, miesięcy i dni może mieć wartość null lub być niezdefiniowany. W takim przypadku wartość argumentu jest interpretowana jako zero.
Każdy z argumentów lat, miesięcy lub dni może mieć wartość ujemną. Wartość taka jest podczas obliczeń odejmowana od daty bazowej.
DateTimeSpan.addDate( dataPoczątkowa, lata, miesiące, dni )
Data będąca wynikiem dodania przekazanej liczby lat, miesięcy i dni do daty początkowej.
var startDate = date.parse( "2004-12-31" ); var endDate; endDate = DateTimeSpan( startDate, 1, 0, 0 ); // zwraca 2005-12-31 endDate = DateTimeSpan( startDate, 0, 1, 0 ); // zwraca 2005-1-31 endDate = DateTimeSpan( startDate, 0, 0, 1 ); // zwraca 2005-1-1 endDate = DateTimeSpan( startDate, 1, 1, 1 ); // zwraca 2005-3-4
Funkcja DateTimeSpan.addTime
Funkcja DateTimeSpan.subDate
Funkcja zwraca nową datę, będącą sumą daty początkowej i przekazanej funkcji liczby godzin, minut i sekund. Liczba godzin może przekraczać 24, a liczby minut i sekund mogą przekraczać 60. Efekt ostateczny odpowiada wykonaniu trzech osobnych operacji. Najpierw dodawane są godziny. Następnie do wynikowej daty dodawane są minuty. Na koniec do wyniku dodawane są sekundy.
Każdy z argumentów godzin, minut i sekund może mieć wartość null lub być niezdefiniowany. W takim przypadku wartość argumentu jest interpretowana jako zero.
Każdy z argumentów godzin, minut i sekund może mieć wartość ujemną. Wartość taka jest podczas obliczeń odejmowana od daty bazowej.
DateTimeSpan.addTime( dataPoczątkowa, godziny, minuty, sekundy )
Data będąca wynikiem dodania przekazanej liczby godzin, minut i sekund do daty początkowej.
Funkcja DateTimeSpan.addDate
Funkcja DateTimeSpan.subTime
Zwraca liczbę dni między dwoma datami. Dzień jest definiowany jako wystąpienie zmiany daty. Oznacza to, że jako jeden dzień liczy się zarówno okres od 24:59:59 27 lutego do północy 28 lutego, jak i okres od północy 27 lutego do 23:59:59 28 lutego.
DateTimeSpan.days( dataPoczątkowa, dataKońcowa )
Zwraca liczbę dni między dwoma datami.
Funkcja zwraca liczbę pełnych godzin pomiędzy dwoma datami. Pełna godzina jest zdefiniowana jako okres od określonej minuty danej godziny do tej samej minuty kolejnej godziny. Na przykład okres od 1:23:00 do 2:23:00 to jedna pełna godzina, a okres od 1:23:00 do 2:22:59 to zero pełnych godzin.
DateTimeSpan.hours( dataPoczątkowa, dataKońcowa )
Zwraca liczbę pełnych godzin między dwoma datami.
Funkcja zwraca liczbę pełnych minut pomiędzy dwoma datami. Pełna minuta jest zdefiniowana jako okres od określonej sekundy danej minuty do tej samej sekundy kolejnej minuty. Na przykład okres od 1:23:00 do 1:24:00 to jedna pełna minuta, a okres od 1:23:00 do 1:22:59 to zero pełnych minut.
DateTimeSpan.minutes( dataPoczątkowa, dataKońcowa )
Zwraca liczbę pełnych minut między dwoma datami.
Funkcja zwraca liczbę pełnych miesięcy między dwoma datami. Pełny miesiąc jest definiowany jako okres od n-tego dnia danego miesiąca do n-tego dnia następnego miesiąca. Na przykład okres od 28 lutego do 28 marca to jeden pełny miesiąc, a okres od 28 lutego do 26 marca to zero pełnych miesięcy.
DateTimeSpan.months( dataPoczątkowa, dataKońcowa )
Zwraca liczbę pełnych miesięcy między dwoma datami.
Funkcja zwraca liczbę sekund między dwoma datami.
DateTimeSpan.seconds( dataPoczątkowa, dataKońcowa )
Zwraca liczbę pełnych minut między dwoma datami.
Funkcja zwraca nową datę, będącą wynikiem odjęcia przekazanej funkcji liczby lat, miesięcy i dni od daty początkowej. Liczba miesięcy może przekraczać 12, a liczba dni może przekraczać liczbę dni w miesiącu. Efekt ostateczny odpowiada wykonaniu trzech osobnych operacji. Najpierw odejmowane są lata. Następnie od wynikowej daty odejmowane są miesiące. Na koniec od wyniku odejmowane są dni.
Data powstała w wyniku odjęcia miesiąca może nie być poprawna. Na przykład wynikiem odjęcia jednego miesiąca do 30 marca byłaby niepoprawna data 30 lutego. Funkcja koryguje datę wynikową tak, by była poprawna, sprowadzając ją do ostatniego poprawnego dnia danego miesiąca. W podanym przykładzie, jeśli rok nie jest przestępny, to data zostanie skorygowana do 28 lutego.
Każdy z argumentów lat, miesięcy i dni może mieć wartość null lub być niezdefiniowany. W takim przypadku wartość argumentu jest interpretowana jako zero.
Każdy z argumentów lat, miesięcy lub dni może mieć wartość ujemną. Wartość taka jest podczas obliczeń dodawana do daty bazowej.
DateTimeSpan.subDate( dataPoczątkowa, lata, miesiące, dni )
Zwraca datę będącą wynikiem odjęcia przekazanej liczby lat, miesięcy i dni od daty początkowej.
Funkcja DateTimeSpan.addDate
Funkcja DateTimeSpan.subTime
Funkcja zwraca nową datę, będącą wynikiem odjęcia przekazanej funkcji liczby godzin, minut i sekund od daty początkowej. Liczba godzin może przekraczać 24, a liczby minut i sekund mogą przekraczać 60. Efekt ostateczny odpowiada wykonaniu trzech osobnych operacji. Najpierw odejmowane są godziny. Następnie od wynikowej daty odejmowane są minuty. Na koniec od wyniku odejmowane są sekundy.
Każdy z argumentów godzin, minut i sekund może mieć wartość null lub być niezdefiniowany. W takim przypadku wartość argumentu jest interpretowana jako zero.
Każdy z argumentów godzin, minut i sekund może mieć wartość ujemną. Wartość taka jest podczas obliczeń dodawana do daty bazowej.
DateTimeSpan.subTime( dataPoczątkowa, godziny, minuty, sekundy )
Zwraca datę będącą wynikiem odjęcia przekazanej liczby godzin, minut i sekund od daty początkowej.
Funkcja DateTimeSpan.addTime
Funkcja DateTimeSpan.subDate
Funkcja oblicza liczbę pełnych lat między dwoma datami. Pełny rok jest zdefiniowany jako okres od określonego miesiąca, dnia i godziny w danym roku do tego samego miesiąca, dnia i godziny w następnym roku. Ze względu na występowanie lat przestępnych, pełny rok może zawierać 365 lub 366 dni.
Przekazanie w argumentach obiektu innego niż obiekt daty spowoduje zgłoszenie wyjątku. Przekazanie wartości null jako jednego z argumentów spowoduje zwrócenie wyniku null.
DateTimeSpan.years( dataPoczątkowa, dataKońcowa )
Zwraca liczbę pełnych lat między dwoma datami.
![]() ![]() |