Forrige emneNæste emne


Klassen DateTimeSpan

Den statiske klasse DateTimeSpan indeholder funktioner, der kan vise tidsrummet mellem to datoer eller klokkeslæt og addere og subtrahere tidsrum. Den har et sæt funktioner, der kan håndtere forskellen mellem to datoer. Eftersom tidsrum blot er tal, kan programmet anvende almindelig aritmetik til dem: multiplikation, division, addition, subtraktion osv. Klassen er statisk. Programmet kan ikke oprette forekomster af klassen.

DateTimeSpan.addDate

Funktionen returnerer en ny dato, der er summen af startdatoen plus det angivne antal år, måneder og dage. Måneder kan være større end 12, og dage kan være større end antallet af dage i en måned. Funktionen svarer til at udføre tre forskellige funktioner. Læg først årene til. Læg derefter månederne til resultatdatoen. Læg så dagene til resultatdatoen.

Resultatdatoen er muligvis ikke gyldig, når der lægges en måned til. Hvis der f.eks. lægges en måned til 31. januar, fås den ugyldige dato 31. februar. Funktionen justerer datoen, så den er gyldig. Hvis året ikke er et skudår, har februar 28 dage, og resultatdatoen vil i dette tilfælde være 3. marts.

Et eller flere af argumenterne for år, måneder og dage kan være NULL eller ikke-defineret. I det tilfælde behandles værdien som nul.

Et eller flere af argumenterne for år, måneder og dage kan være negative. I så fald trækkes enheden fra basisdatoen.

Syntaks

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

Argumenter

Returnerer

En dato, der er summen af startdatoen plus det angivne antal år, måneder og dage.

Eksempel

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

Se også

Funktionen DateTimeSpan.addTime

Funktionen DateTimeSpan.subDate

DateTimeSpan.addTime

Funktionen returnerer en ny dato, der er summen af startdatoen plus det angivne antal timer, minutter og sekunder. Timer kan være større end 24, og minutter og sekunder kan være større end 60. Funktionen svarer til at udføre tre forskellige funktioner: Læg først timerne til. Læg derefter minutterne til resultatdatoen. Læg så sekunderne til resultatdatoen.

Et eller flere af argumenterne for timer, minutter og sekunder kan være NULL eller ikke-defineret. I det tilfælde behandles værdien som nul.

Et eller flere af argumenterne for timer, minutter og sekunder kan være negative. I så fald trækkes enheden fra basisdatoen.

Syntaks

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

Argumenter

Returnerer

En dato, der er summen af startdatoen plus det angivne antal timer, minutter og sekunder.

Se også

Funktionen DateTimeSpan.addDate

Funktionen DateTimeSpan.subTime

DateTimeSpan.days

Returnerer antallet af dage mellem to datoer. En dag defineres som et skift i kalenderen. Således er 23:59:59 27. februar til midnat 28. februar en dag på samme måde som midnat 27. februar til 11:59:59 28. februar er en dag.

Syntaks

DateTimeSpan.days( startDate, endDate )

Argumenter

Returnerer

Returnerer antallet af dage mellem to datoer.

DateTimeSpan.hours

Funktionen returnerer antallet af hele timer mellem to klokkeslæt. En hel time defineres som tidsrummet fra et givet minuttal i en time til samme minuttal i den næste time. For eksempel er 1:23:00 til 2:23:00 én time, mens 1:23:00 til 2:22:59 er nul hele timer.

Syntaks

DateTimeSpan.hours( startDate, endDate )

Argumenter

Returnerer

Antallet af hele timer mellem to datoer.

DateTimeSpan.minutes

Funktionen returnerer antallet af hele minutter mellem to klokkeslæt. Et helt minut defineres som tidsrummet fra et givet sekund i et minut til samme sekund i det næste minut. For eksempel er 1:23:00 til 1:24:00 ét minut, mens 1:23:00 til 1:22:59 er nul hele minutter.

Syntaks

DateTimeSpan.minutes( startDate, endDate )

Argumenter

Returnerer

Antallet af hele minutter mellem to datoer.

DateTimeSpan.months

Funktionen returnerer antallet af hele måneder mellem to datoer. En hel måned defineres som tidsrummet fra den n. i en måned til den n. i den følgende måned. For eksempel er 28. februar til 28. marts en måned, mens 28. februar til 26. marts er nul hele måneder.

Syntaks

DateTimeSpan.months( startDate, endDate )

Argumenter

Returnerer

Returnerer antallet af hele måneder mellem to datoer.

DateTimeSpan.seconds

Funktionen returnerer antallet af sekunder mellem to klokkeslæt.

Syntaks

DateTimeSpan.seconds( startDate, endDate )

Argumenter

Returnerer

Antallet af hele minutter mellem to datoer.

DateTimeSpan.subDate

Funktionen returnerer en ny dato, der fremkommer, ved at det angivne antal år, måneder og dage trækkes fra startdatoen. Måneder kan være større end 12, og dage kan være større end antallet af dage i en måned. Funktionen svarer til at udføre tre forskellige funktioner. Træk først årene fra. Træk derefter månederne fra resultatdatoen. Træk så dagene fra resultatdatoen.

Resultatdatoen er muligvis ikke gyldig, når der trækkes en måned fra. Hvis der f.eks. trækkes en måned fra 30. marts, fås den ugyldige dato 30. februar. Funktionen justerer datoen til den sidste gyldige dag i måneden, så datoværdien er gyldig. I dette tilfælde justeres datoen til 28. februar, hvis året ikke er et skudår.

Et eller flere af argumenterne for år, måneder og dage kan være NULL eller ikke-defineret. I det tilfælde behandles værdien som nul.

Et eller flere af argumenterne for år, måneder og dage kan være negative. I så fald lægges enheden til basisdatoen.

Syntaks

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

Argumenter

Returnerer

En dato, der er resultatet af startdatoen minus det angivne antal år, måneder og dage.

Se også

Funktionen DateTimeSpan.addDate

Funktionen DateTimeSpan.subTime

DateTimeSpan.subTime

Funktionen returnerer en ny dato, der fremkommer, ved at det angivne antal timer, minutter og sekunder trækkes fra startdatoen. Timer kan være større end 24, og minutter og sekunder kan være større end 60. Funktionen svarer til at udføre tre forskellige funktioner. Træk først timerne fra. Træk derefter minutterne fra resultatdatoen. Træk så sekunderne fra resultatdatoen.

Et eller flere af argumenterne for timer, minutter og sekunder kan være NULL eller ikke-defineret. I det tilfælde behandles værdien som nul.

Et eller flere af argumenterne for timer, minutter og sekunder kan være negative. I så fald lægges enheden til basisdatoen.

Syntaks

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

Argumenter

Returnerer

En dato, der er resultatet af startdatoen minus det angivne antal timer, minutter og sekunder.

Se også

Funktionen DateTimeSpan.addTime

Funktionen DateTimeSpan.subDate

DateTimeSpan.years

Funktionen beregner antallet af hele år mellem to datoer. Et helt år defineres som tidsrummet fra et bestemt tidspunkt (måned, dag, klokkeslæt) et år til samme tidspunkt det følgende år. På grund af skudår inkluderer et helt år enten 365 eller 366 dage.

Hvis et af argumenterne ikke er en dato, registreres en undtagelse. Hvis et af argumenterne er NULL, er resultatet også NULL.

Syntaks

DateTimeSpan.years( startDate, endDate )

Argumenter

Returnerer

Antallet af hele år mellem de to datoer.


(c) Copyright Actuate Corporation 2006

Forrige emneNæste emne