Poprzedni tematNastępny temat


Klasa DateTimeSpan

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 DateTimeSpan.addDate

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.

Składnia

DateTimeSpan.addDate( dataPoczątkowa, lata, miesiące, dni )

Argumenty

Wartości zwracane:

Data będąca wynikiem dodania przekazanej liczby lat, miesięcy i dni do daty początkowej.

Przykład

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 

Patrz także:

Funkcja DateTimeSpan.addTime

Funkcja DateTimeSpan.subDate

Funkcja DateTimeSpan.addTime

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.

Składnia

DateTimeSpan.addTime( dataPoczątkowa, godziny, minuty, sekundy )

Argumenty

Wartości zwracane:

Data będąca wynikiem dodania przekazanej liczby godzin, minut i sekund do daty początkowej.

Patrz także:

Funkcja DateTimeSpan.addDate

Funkcja DateTimeSpan.subTime

Funkcja DateTimeSpan.days

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.

Składnia

DateTimeSpan.days( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę dni między dwoma datami.

Funkcja DateTimeSpan.hours

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.

Składnia

DateTimeSpan.hours( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę pełnych godzin między dwoma datami.

Funkcja DateTimeSpan.minutes

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.

Składnia

DateTimeSpan.minutes( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę pełnych minut między dwoma datami.

Funkcja DateTimeSpan.months

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.

Składnia

DateTimeSpan.months( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę pełnych miesięcy między dwoma datami.

Funkcja DateTimeSpan.seconds

Funkcja zwraca liczbę sekund między dwoma datami.

Składnia

DateTimeSpan.seconds( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę pełnych minut między dwoma datami.

Funkcja DateTimeSpan.subDate

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.

Składnia

DateTimeSpan.subDate( dataPoczątkowa, lata, miesiące, dni )

Argumenty

Wartości zwracane:

Zwraca datę będącą wynikiem odjęcia przekazanej liczby lat, miesięcy i dni od daty początkowej.

Patrz także:

Funkcja DateTimeSpan.addDate

Funkcja DateTimeSpan.subTime

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.

Składnia

DateTimeSpan.subTime( dataPoczątkowa, godziny, minuty, sekundy )

Argumenty

Wartości zwracane:

Zwraca datę będącą wynikiem odjęcia przekazanej liczby godzin, minut i sekund od daty początkowej.

Patrz także:

Funkcja DateTimeSpan.addTime

Funkcja DateTimeSpan.subDate

Funkcja DateTimeSpan.years

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.

Składnia

DateTimeSpan.years( dataPoczątkowa, dataKońcowa )

Argumenty

Wartości zwracane:

Zwraca liczbę pełnych lat między dwoma datami.


(c) Copyright Actuate Corporation 2006

Poprzedni tematNastępny temat