Forrige emneNeste emne


Klassen DateTimeSpan

Den statiske DateTimeSpan-klassen har funksjoner som fastsetter hvor mye tid det er mellom to datoer eller klokkeslett, og som legger til eller trekker fra perioder. Den har funksjoner som kan brukes til å arbeide med forskjellen mellom to datoer. Siden datoer bare er tall, kan applikasjonen bruke vanlige regnefunksjoner på dem, det vil si multiplikasjon, divisjon, addisjon, subtraksjon og så videre. Denne klassen er statisk. Applikasjonen kan ikke opprette forekomster av klassen.

DateTimeSpan.addDate

Denne funksjonen returnerer en ny dato som er summen når et gitt antall år, måneder og dager legges til i startdatoen. Antall måneder kan være mer enn 12 og antall dager kan være mer enn antall dager i en måned. Resultatet blir en tredelt operasjon. Legg først til årene. Legg så til månedene med utgangspunkt i datoen som opprettes. Deretter legger du til dagene med utgangspunkt i datoen som opprettes.

Når du legger til en måned, er det ikke sikkert at datoen som opprettes, er gyldig. Hvis du for eksempel legger en måned til 31. januar, vil resultatet være 31. februar, som er en ugyldig dato. Funksjonen justerer ugyldige datoer, i dette tilfellet til 3. mars siden det er 28 dager i februar (hvis det ikke er skuddår).

Argumenter for år, måneder eller dager kan være null eller udefinert. I så fall behandles verdien som en nullverdi.

Argumenter for år, måneder eller dager kan være negative. I så fall er resultatet det samme som om enheten trekkes fra basisdatoen.

Syntaks

DateTimeSpan.addDate( startDate, years, months, days)

Argumenter

Returnerer

Den datoen som opprettes når år, måneder og dager legges til i startdatoen.

Eksempel

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( startDate, 1, 0, 0 ); // returns 2005-12-31 
endDate = DateTimeSpan( startDate, 0, 1, 0 ); // returns 2005-1-31 
endDate = DateTimeSpan( startDate, 0, 0, 1 ); // returns 2005-1-1 
endDate = DateTimeSpan( startDate, 1, 1, 1 ); // returns 2005-3-4 

Se også

Funksjonen DateTimeSpan.addTime

Funksjonen DateTimeSpan.subDate

DateTimeSpan.addTime

Denne funksjonen returnerer en ny dato som er summen når et gitt antall timer, minutter og sekunder legges til i startdatoen. Antall timer kan være mer enn 24 og minutter og sekunder kan være mer enn 60. Resultatet blir en tredelt operasjon. Først tilføyes timene. Legg så til minuttene med utgangspunkt i datoen som opprettes. Deretter legger du til sekundene med utgangspunkt i datoen som opprettes.

Argumenter for timer, minutter eller sekunder kan være null eller udefinert. I så fall behandles verdien som en nullverdi.

Argumenter for timer, minutter og sekunder kan være negative. I så fall er resultatet det samme som om enheten trekkes fra basisdatoen.

Syntaks

DateTimeSpan.addTime( startDate, hours, minutes, seconds )

Argumenter

Returnerer

Den datoen som opprettes når timer, minutter og sekunder legges til i startdatoen.

Se også

Funksjonen DateTimeSpan.addDate

Funksjonen DateTimeSpan.subTime

DateTimeSpan.days

Returnerer antall dager mellom to datoer. En dag er definert som en kalenderendring. Fra 27. februar klokken 23:59:59 til midnatt 28. februar er det ett døgn, og likeledes fra midnatt 27. februar til 28. februar klokken 23:59:59.

Syntaks

DateTimeSpan.days( startDate, endDate )

Argumenter

Returnerer

Returnerer antall dager mellom to datoer.

DateTimeSpan.hours

Denne funksjonen returnerer antall hele timer mellom to klokkeslett. En hel time defineres som perioden fra et gitt minutt i en time, til samme minutt i neste time. For eksempel er det én time mellom 1:23:00 og 2:23:00, mens det er null hele timer mellom 1:23:00 og 2:22:59.

Syntaks

DateTimeSpan.hours( startDate, endDate )

Argumenter

Returnerer

Antall hele timer mellom to datoer.

DateTimeSpan.minutes

Denne funksjonen returnerer antall hele minutter mellom to klokkeslett. Et helt minutt defineres som perioden fra et gitt sekund i et minutt, til samme sekund i neste minutt. For eksempel er det ett minutt mellom 1:23:00 og 1:24:00, mens det er null hele minutter mellom 1:23:00 og 1:22:59.

Syntaks

DateTimeSpan.minutes( startDate, endDate )

Argumenter

Returnerer

Antall hele minutter mellom to datoer.

DateTimeSpan.months

Denne funksjonen returnerer antall hele måneder mellom to datoer. En hel måned defineres som perioden mellom en dato i én måned til samme dato i neste måned. For eksempel er det én måned fra 28. februar til 28. mars, men det er null hele måneder fra 28. februar til 26. mars.

Syntaks

DateTimeSpan.months( startDate, endDate )

Argumenter

Returnerer

Returnerer antall hele måneder mellom to datoer.

DateTimeSpan.seconds

Denne funksjonen returnerer antall sekunder mellom to klokkeslett.

Syntaks

DateTimeSpan.seconds( startDate, endDate )

Argumenter

Returnerer

Antall hele minutter mellom to datoer.

DateTimeSpan.subDate

Denne funksjonen returnerer en ny dato som er resultatet av å trekke fra et gitt antall år, måneder og dager fra startdatoen. Antall måneder kan være mer enn 12 og antall dager kan være mer enn antall dager i en måned. Resultatet blir en tredelt operasjon. Trekk først fra årene. Trekk så fra månedene med utgangspunkt i datoen som opprettes. Deretter trekker du fra dagene med utgangspunkt i datoen som opprettes.

Når du trekker fra en måned, er det ikke sikkert at datoen som opprettes, er gyldig. Hvis du for eksempel trekker en måned fra 30. mars, vil resultatet være 30. februar, som er en ugyldig dato. Denne funksjonen justerer datoen til den siste gyldige dagen i måneden. I dette tilfellet justeres den til 28. februar hvis det ikke er skuddår.

Argumenter for år, måneder eller dager kan være null eller udefinert. I så fall behandles verdien som en nullverdi.

Argumenter for år, måneder eller dager kan være negative. I så fall er resultatet det samme som om enheten legges til i basisdatoen.

Syntaks

DateTimeSpan.subDate( startDate, years, months, days )

Argumenter

Returnerer

Den datoen som opprettes når år, måneder og dager trekkes fra startdatoen.

Se også

Funksjonen DateTimeSpan.addDate

Funksjonen DateTimeSpan.subTime

DateTimeSpan.subTime

Denne funksjonen returnerer en ny dato som er resultatet av å trekke et gitt antall timer, minutter og sekunder fra startdatoen. Antall timer kan være mer enn 24 og minutter og sekunder kan være mer enn 60. Resultatet blir en tredelt operasjon. Trekk først fra timene. Trekk så fra minuttene med utgangspunkt i datoen som opprettes. Deretter trekker du fra sekundene med utgangspunkt i datoen som opprettes.

Argumenter for timer, minutter eller sekunder kan være null eller udefinert. I så fall behandles verdien som en nullverdi.

Argumenter for timer, minutter og sekunder kan være negative. I så fall er resultatet det samme som om enheten legges til i basisdatoen.

Syntaks

DateTimeSpan.subTime( startDate, hours, minutes, seconds )

Argumenter

Returnerer

Den datoen som opprettes når timer, minutter og sekunder trekkes fra startdatoen.

Se også

Funksjonen DateTimeSpan.addTime

Funksjonen DateTimeSpan.subDate

DateTimeSpan.years

Denne funksjonen beregner antall hele år mellom to datoer. Et helt år defineres som tidsrommet fra en gitt måned, dag og klokkeslett ett år, til samme måned, dag og klokkeslett neste år. På grunn av skuddår kan et helt år inneholde både 365 dager og 366 dager.

Hvis et av argumentene ikke er en dato, oppstår et unntak. Hvis et av argumentene er null, er også resultatet null.

Syntaks

DateTimeSpan.years( startDate, endDate )

Argumenter

Returnerer

Antall hele år mellom to datoer.


(c) Copyright Actuate Corporation 2006

Forrige emneNeste emne