Vorige onderwerpVolgende onderwerp


Klasse DateTimeSpan

De statische klasse DateTimeSpan biedt functies voor het bepalen van de hoeveelheid tijd tussen twee datums of tijdstippen en voor het groter of kleiner maken van perioden. Deze klasse biedt een set functies om te werken met het verschil tussen twee datums. Aangezien tijdsperioden gewoon getallen zijn, kan de toepassing er normale wiskundige berekeningen mee uitvoeren: vermenigvuldigen, delen, optellen, aftrekken, etc. Dit is een statische klasse. De toepassing kan geen instances maken van de klasse.

DateTimeSpan.addDate

Deze functie resulteert in een nieuwe datum, die de som is van de begindatum en het opgegeven aantal jaren, maanden en dagen. Het aantal maanden kan groter zijn dan 12 en het aantal dagen kan groter zijn dan het aantal dagen van een maand. Het gaat hier feitelijk om drie afzonderlijke bewerkingen. Eerst worden de jaren opgeteld. Vervolgens wordt aan de resulterende datum het aantal maanden toegevoegd. Vervolgens wordt aan de resulterende datum het aantal dagen toegevoegd.

Bij het toevoegen van een maand kan de resulterende datum ongeldig blijken te zijn. Als u bijvoorbeeld een maand optelt bij 31 Januari, levert dat de ongeldige datum van 31 februari op. De functie corrigeert de datum tot een geldige datum, in dit geval, als het niet om een schrikkeljaar gaat en februari 28 dagen telt, is de resulterende datum dan 3 maart.

Elk van de argumenten voor jaren, maanden en dagen kan null of niet-gedefinieerd zijn. In dergelijke gevallen wordt de waarde beschouwd als zijnde gelijk aan nul.

Elk van de argumenten voor jaren, maanden en dagen kan negatief zijn. In zo'n geval wordt de waarde afgetrokken van de basisdatum.

Syntaxis

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

Argumenten

Resultaat

Een datum die het resultaat is van het optellen van de jaren, maanden en dagen bij de basisdatum.

Voorbeeld

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

Zie ook

DateTimeSpan.addTime-functie

DateTimeSpan.subDate-functie

DateTimeSpan.addTime

Deze functie resulteert in een nieuwe datum, die de som is van de begindatum en het opgegeven aantal uren, minuten en seconden. Het aantal uren kan groter zijn dan 24 en het aantal minuten en seconden kan groter zijn dan 60. Het gaat hier feitelijk om drie afzonderlijke bewerkingen: eerst worden de uren toegevoegd. Vervolgens wordt aan de resulterende datum het aantal minuten toegevoegd. Tenslotte worden de seconden toegevoegd aan de resulterende datum.

Elk van de argumenten voor uren, minuten en seconden kan null of niet-gedefinieerd zijn. In dergelijke gevallen wordt de waarde beschouwd als zijnde gelijk aan nul.

Elk van de argumenten voor uren, minuten en seconden kan negatief zijn. In zo'n geval wordt de waarde afgetrokken van de basisdatum.

Syntaxis

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

Argumenten

Resultaat

Een datum die het resultaat is van het optellen van de uren, minuten en seconden bij de basisdatum.

Zie ook

DateTimeSpan.addDate-functie

DateTimeSpan.subTime-functie

DateTimeSpan.days

Hiermee wordt het aantal dagen tussen twee datums berekend. Een nieuwe dag begint bij een wijziging in de kalender. Zo is 11:59:59 PM op 27 februari tot middernacht op 28 februari één dag, net als middernacht op 28 februari tot 11:59:59 op 28 februari.

Syntaxis

DateTimeSpan.days( startDate, endDate )

Argumenten

Resultaat

Hiermee wordt het aantal dagen tussen twee datums berekend.

DateTimeSpan.hours

Deze functie berekent het aantal gehele uren tussen twee tijdstippen. Een geheel uur wordt gezien als de periode tussen een minuut van het uur tot aan dezelfde minuut in het eerstvolgende uur. Zo is de periode tussen 1:23:00 en 2:23:00 een vol uur, maar wordt de periode tussen 1:23:00 en 2:22:59 gezien als nul gehele uren.

Syntaxis

DateTimeSpan.hours( startDate, endDate )

Argumenten

Resultaat

Het aantal gehele uren tussen twee datums.

DateTimeSpan.minutes

Deze functie berekent het aantal gehele minuten tussen twee tijdstippen. Een gehele minuut wordt gezien als de periode tussen een bepaalde seconde van de minuut tot aan dezelfde seconde in de eerstvolgende minuut. Zo is de periode tussen 1:23:00 en 1:24:00 een volle minuut maar wordt de periode tussen 1:23:00 en 1:22:59 gezien als nul gehele minuten.

Syntaxis

DateTimeSpan.minutes( startDate, endDate )

Argumenten

Resultaat

Het aantal gehele minuten tussen twee datums.

DateTimeSpan.months

Deze functie berekent het aantal gehele maanden tussen twee datums. Een gehele maand wordt gezien als de periode tussen een dag van de maand en dezelfde dag in de eerstvolgende maand. Zo is 28 februari tot 28 maart een volledige maand terwijl 28 februari tot 26 maart wordt beschouwd als nul volledige maanden.

Syntaxis

DateTimeSpan.months( startDate, endDate )

Argumenten

Resultaat

Hiermee wordt het aantal maanden tussen twee datums berekend.

DateTimeSpan.seconds

Deze functie berekent het aantal seconden tussen twee tijdstippen.

Syntaxis

DateTimeSpan.seconds( startDate, endDate )

Argumenten

Resultaat

Het aantal gehele minuten tussen twee datums.

DateTimeSpan.subDate

Deze functie resulteert in een nieuwe datum, die gelijk is aan begindatum minus het opgegeven aantal jaren, maanden en dagen. Het aantal maanden kan groter zijn dan 12 en het aantal dagen kan groter zijn dan het aantal dagen van een maand. Het gaat hier feitelijk om drie afzonderlijke bewerkingen. Eerst worden de jaren afgetrokken. Vervolgens wordt van de resulterende datum het aantal maanden afgetrokken. Vervolgens wordt van de resulterende datum het aantal dagen afgetrokken.

Bij het aftrekken van een maand kan de resulterende datum ongeldig blijken te zijn. Als u bijvoorbeeld een maand aftrekt van 30 maart, levert dat de ongeldige datum van 30 februari op. De functie wijzigt de datum in een geldige datum, door de datum in te stellen op de laatste geldige dag van de maand. Als het niet om een schrikkeljaar gaat, wordt de datum aangepast tot 28 februari.

Elk van de argumenten voor jaren, maanden en dagen kan null of niet-gedefinieerd zijn. In dergelijke gevallen wordt de waarde beschouwd als zijnde gelijk aan nul.

Elk van de argumenten voor jaren, maanden en dagen kan negatief zijn. In zo'n geval wordt de waarde opgeteld bij de basisdatum.

Syntaxis

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

Argumenten

Resultaat

Een datum die het resultaat is van het aftrekken van de jaren, maanden en dagen van de begindatum.

Zie ook

DateTimeSpan.addDate-functie

DateTimeSpan.subTime-functie

DateTimeSpan.subTime

Deze functie resulteert in een nieuwe datum, die het resultaat is van het aftrekken van de begindatum van het opgegeven aantal uren, minuten en seconden. Het aantal uren kan groter zijn dan 24 en het aantal minuten en seconden kan groter zijn dan 60. Het gaat hier feitelijk om drie afzonderlijke bewerkingen. Eerst worden de uren afgetrokken. Vervolgens wordt van de resulterende datum het aantal minuten afgetrokken. Tenslotte worden de seconden afgetrokken van de resulterende datum.

Elk van de argumenten voor uren, minuten en seconden kan null of niet-gedefinieerd zijn. In dergelijke gevallen wordt de waarde beschouwd als zijnde gelijk aan nul.

Elk van de argumenten voor uren, minuten en seconden kan negatief zijn. In zo'n geval wordt de waarde opgeteld bij de basisdatum.

Syntaxis

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

Argumenten

Resultaat

Een datum die het resultaat is van het aftrekken van de uren, minuten en seconden van de begindatum.

Zie ook

DateTimeSpan.addTime-functie

DateTimeSpan.subDate-functie

DateTimeSpan.years

Deze functie berekent het aantal gehele jaren tussen twee datums. Een heel jaar wordt gezien als de periode tussen een bepaalde maand, dag en tijdstip en dezelfde maand, dag en tijdstip in het eerstvolgende jaar. Vanwege de schrikkeljaren bestaat een jaar uit 365 of 366 dagen.

Als een van beide argumenten niet een datum is, wordt de functie verworpen. Als een van beide argumenten NULL is is het resultaat ook NULL.

Syntaxis

DateTimeSpan.years( startDate, endDate )

Argumenten

Resultaat

Het aantal volledige jaren tussen de twee datums.


(c) Copyright Actuate Corporation 2006

Vorige onderwerpVolgende onderwerp