Föregående avsnittNästa avsnitt


Klassen DateTimeSpan

Den statiska klassen DateTimeSpan ger funktioner att fastställa tidsmängden mellan två datum eller klockslag och att addera eller subtrahera tidsintervall. Den har en uppsättning funktioner för arbete med skillnaden mellan två datum. Eftersom datumintervall endast är siffror kan tillämpningen använda vanlig matematik på dem: multiplikation, division, addition, subtraktion, osv. Den här klassen är statisk. Tillämpningen kan inte skapa förekomster av klassen.

DateTimeSpan.addDate

Den här funktionen returnerar ett nytt datum som är summan av att det angivna antalet år, månader och dagar adderas till startdatumet. Antalet månader kan vara större än 12, och antalet dagar kan vara större än antalet dagar i en månad. Nettoeffekten är som om det vore tre olika operationer. Lägg till åren först. Med det datum som blir resultatet lägger du sedan till månaderna. Med det datum som blir resultatet lägger du sedan till dagarna.

När du lägger till månader kanske det resulterande datumet inte är giltigt. Om du till exempel lägger till en månad till 31 januari blir resultatet det ogiltiga datumet 31 februari. Funktionen justerar datumet så att det blir giltigt. I det här fallet gäller, om det inte är skottår, att februari har 28 dagar, och resultatet blir 3 mars.

Alla argument för år, månader och dagar kan vara null eller odefinierade. I så fall behandlas värdet som om det vore noll.

Alla argument för år, månader och dagar kan vara negativa. I det här fallet blir resultatet som om enheten hade dragits ifrån basdatumet.

Syntax

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

Argument

Returnering

Ett datum som är resultatet av att år, månader och dagar adderas till startdatum.

Exempel

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

Se även

Funktionen DateTimeSpan.addTime

Funktionen DateTimeSpan.subDate

DateTimeSpan.addTime

Den här funktionen returnerar ett nytt datum som är summan av att det angivna antalet timmar, minuter och sekunder adderas till startdatumet. Antalet timmar kan vara större än 24, och antalet minuter och sekunder kan vara större än 60. Nettoeffekten är som om det vore tre olika operationer. Lägg till timmarna först. Med det datum som blir resultatet lägger du sedan till minuterna. Med det datum som blir resultatet lägger du sedan till sekunderna.

Alla argument för timmar, minuter och sekunder kan vara null eller odefinierade. I så fall behandlas värdet som om det vore noll.

Alla argument för timmar, minuter och sekunder kan vara negativa. I det här fallet blir resultatet som om enheten hade dragits ifrån basdatumet.

Syntax

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

Argument

Returnering

Ett datum som är resultatet av att timmar, minuter och sekunder adderas till startdatum.

Se även

Funktionen DateTimeSpan.addDate

Funktionen DateTimeSpan.subTime

DateTimeSpan.days

Returnerar antal dagar mellan två datum. En dag definieras som datumskifte i almanackan. Det innebär att 23:59:59 den 27 februari till midnatt den 28 februari är en dag, liksom midnatt den 27 februari till 23:59:59 den 28 februari.

Syntax

DateTimeSpan.days( startDate, endDate )

Argument

Returnering

Returnerar antalet dagar mellan två datum.

DateTimeSpan.hours

Den här funktionen returnerar antalet hela timmar mellan två klockslag. En hel timme definieras som ett intervall från en viss minut under en timme till samma minut under nästa timme. Exempel: 1:23:00 till 2:23:00 är en timme, medan 1:23:00 till 2:22:59 är noll hela timmar.

Syntax

DateTimeSpan.hours( startDate, endDate )

Argument

Returnering

Antalet hela timmar mellan två datum.

DateTimeSpan.minutes

Den här funktionen returnerar antalet hela minuter mellan två klockslag. En hel minut definieras som ett intervall från en viss sekund under en minut till samma sekund under nästa minut. Exempel: 1:23:00 till 1:24:00 är en minut, medan 1:23:00 till 1:22:59 är noll hela minuter.

Syntax

DateTimeSpan.minutes( startDate, endDate )

Argument

Returnering

Antalet hela minuter mellan två datum.

DateTimeSpan.months

Den här funktionen returnerar antalet hela månader mellan två datum. En hel månad definieras som intervallet från den n:te i en månad till den n:te i nästa månad. Exempel: Den 28 februari till den 28 mars är en månad, medan 28 februari till den 26 mars är noll hela månader.

Syntax

DateTimeSpan.months( startDate, endDate )

Argument

Returnering

Returnerar antal hela månader mellan två datum.

DateTimeSpan.seconds

Den här funktionen returnerar antalet sekunder mellan två klockslag.

Syntax

DateTimeSpan.seconds( startDate, endDate )

Argument

Returnering

Antalet hela minuter mellan två datum.

DateTimeSpan.subDate

Den här funktionen returnerar ett nytt datum som är resultatet av att det angivna antalet år, månader och dagar subtraheras från startdatumet. Antalet månader kan vara större än 12, och antalet dagar kan vara större än antalet dagar i en månad. Nettoeffekten är som om det vore tre olika operationer. Subtrahera åren först. Med det datum som blir resultatet drar du sedan från månaderna. Med det datum som blir resultatet drar du sedan från dagarna.

När du drar från månader kanske det resulterande datumet inte är giltigt. Om du till exempel subtraherar en månad från 30 mars blir resultatet det ogiltiga datumet 30 februari. Funktionen justerar datumet så att det blir giltigt, och resultatet blir det sista giltiga datumet i månaden. I det här fallet gäller, om det inte är skottår, att datumet justeras till 28 februari.

Alla argument för år, månader och dagar kan vara null eller odefinierade. I det här fallet behandlas värdet som om det vore noll.

Alla argument för år, månader och dagar kan vara negativa. I det här fallet blir resultatet som om enheten hade lagts till basdatumet.

Syntax

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

Argument

Returnering

Ett datum som är resultatet av att år, månader och dagar subtraheras från startdatum.

Se även

Funktionen DateTimeSpan.addDate

Funktionen DateTimeSpan.subTime

DateTimeSpan.subTime

Den här funktionen returnerar ett nytt datum som är resultatet av att det angivna antalet timmar, minuter och sekunder subtraheras från startdatumet. Antalet timmar kan vara större än 24, och antalet minuter och sekunder kan vara större än 60. Nettoeffekten är som om det vore tre olika operationer. Subtrahera timmarna först. Med det datum som blir resultatet drar du sedan från minuterna. Med det datum som blir resultatet drar du sedan från sekunderna.

Alla argument för timmar, minuter och sekunder kan vara null eller odefinierade. I det här fallet behandlas värdet som om det vore noll.

Alla argument för timmar, minuter och sekunder kan vara negativa. I det här fallet blir resultatet som om enheten hade lagts till basdatumet.

Syntax

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

Argument

Returnering

Ett datum som är resultatet av att timmar, minuter och sekunder subtraheras från startdatum.

Se även

Funktionen DateTimeSpan.addTime

Funktionen DateTimeSpan.subDate

DateTimeSpan.years

Den här funktionen returnerar antalet hela år mellan två datum. Ett helt år definieras som intervallet mellan en viss månad, dag och klockslag under ett år till samma månad, dag och klockslag nästa år. På grund av skottår består ett helt år ibland av 365 dagar och ibland av 366 dagar.

Om något av argumenten är något annat än ett datum returneras ett undantag. Om något av argumenten är null blir resultatet också null.

Syntax

DateTimeSpan.years( startDate, endDate )

Argument

Returnering

Antalet hela år mellan två datum.


(c) Copyright Actuate Corporation 2006

Föregående avsnittNästa avsnitt