![]() ![]() |
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.
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.
DateTimeSpan.addDate( startDate, years, months, days )
Ett datum som är resultatet av att år, månader och dagar adderas till startdatum.
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
Funktionen DateTimeSpan.addTime
Funktionen DateTimeSpan.subDate
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.
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
Ett datum som är resultatet av att timmar, minuter och sekunder adderas till startdatum.
Funktionen DateTimeSpan.addDate
Funktionen DateTimeSpan.subTime
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.
DateTimeSpan.days( startDate, endDate )
Returnerar antalet dagar mellan två datum.
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.
DateTimeSpan.hours( startDate, endDate )
Antalet hela timmar mellan två datum.
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.
DateTimeSpan.minutes( startDate, endDate )
Antalet hela minuter mellan två datum.
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.
DateTimeSpan.months( startDate, endDate )
Returnerar antal hela månader mellan två datum.
Den här funktionen returnerar antalet sekunder mellan två klockslag.
DateTimeSpan.seconds( startDate, endDate )
Antalet hela minuter mellan två datum.
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.
DateTimeSpan.subDate( startDate, years, months, days )
Ett datum som är resultatet av att år, månader och dagar subtraheras från startdatum.
Funktionen DateTimeSpan.addDate
Funktionen 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.
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
Ett datum som är resultatet av att timmar, minuter och sekunder subtraheras från startdatum.
Funktionen DateTimeSpan.addTime
Funktionen DateTimeSpan.subDate
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.
DateTimeSpan.years( startDate, endDate )
Antalet hela år mellan två datum.
![]() ![]() |