![]() ![]() |
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.
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.
DateTimeSpan.addDate( startDate, years, months, days )
En dato, der er summen af startdatoen plus det angivne antal år, måneder og dage.
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
Funktionen DateTimeSpan.addTime
Funktionen DateTimeSpan.subDate
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.
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
En dato, der er summen af startdatoen plus det angivne antal timer, minutter og sekunder.
Funktionen DateTimeSpan.addDate
Funktionen DateTimeSpan.subTime
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.
DateTimeSpan.days( startDate, endDate )
Returnerer antallet af dage mellem to datoer.
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.
DateTimeSpan.hours( startDate, endDate )
Antallet af hele timer mellem to datoer.
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.
DateTimeSpan.minutes( startDate, endDate )
Antallet af hele minutter mellem to datoer.
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.
DateTimeSpan.months( startDate, endDate )
Returnerer antallet af hele måneder mellem to datoer.
Funktionen returnerer antallet af sekunder mellem to klokkeslæt.
DateTimeSpan.seconds( startDate, endDate )
Antallet af hele minutter mellem to datoer.
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.
DateTimeSpan.subDate( startDate, years, months, days )
En dato, der er resultatet af startdatoen minus det angivne antal år, måneder og dage.
Funktionen DateTimeSpan.addDate
Funktionen 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.
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
En dato, der er resultatet af startdatoen minus det angivne antal timer, minutter og sekunder.
Funktionen DateTimeSpan.addTime
Funktionen DateTimeSpan.subDate
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.
DateTimeSpan.years( startDate, endDate )
Antallet af hele år mellem de to datoer.
![]() ![]() |