Vorige Volgende

Klasse BirtDateTime

De klasse BirtDateTime biedt functies voor het bepalen van de hoeveelheid tijd tussen twee datums of tijdstippen, voor het groter of kleiner maken van perioden en voor het ophalen van delen van een datum. 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 van de klasse maken.

BirtDateTime.addDay

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal dagen en een bepaalde datum. Het aantal toe te voegen dagen kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addDay( datum, n )

Parameters

datum

Datumobject. Een datumobject dat de begindatum aangeeft.

n

Getalsobject. Het aantal dagen dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, afgerond op het onderliggende gehele getal.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal dagen bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden er dagen opgeteld bij een specifieke datum:

var startDate = "31-12-2008";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // retourneert 01 jan 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // retourneert 30 dec 2008

In het volgende voorbeeld worden 15 dagen opgeteld bij elke datumwaarde in het veld RekeningDatum:

BirtDateTime.addDay( row["RekeningDatum"], 15 )

BirtDateTime.addHour

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal uren en een bepaalde datum. Het aantal toe te voegen uren kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addHour( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

n

Getalsobject. Het aantal uren dat bij de datum moet worden opgeteld.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal uren bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden uren opgeteld bij een specifieke datum en tijd:

var startDate = "31-12-2008 15:00:00";
var endDate;
endDate = BirtDateTime.addHour( startDate, 8 ); // retourneert 31 dec 2008 11:00 PM
endDate = BirtDateTime.addHour( startDate, -8 ); // retourneert 31 dec 2008 7:00 AM

In het volgende voorbeeld worden 36 uren opgeteld bij elke datumwaarde in het veld StartTijd:

BirtDateTime.addHour( row["StartTijd"], 36 )

BirtDateTime.addMinute

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal minuten en een bepaalde datum. Het aantal toe te voegen minuten kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addMinute( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

n

Getalsobject. Het aantal minuten dat bij de datum moet worden opgeteld.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal minuten bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden minuten opgeteld bij een specifieke datum en tijd:

var startDate = "31-12-2008 10:30:00";
var endDate;
endDate = BirtDateTime.addMinute( startDate, 45 );
// retourneert 31 dec 2008 11:15 AM
endDate = BirtDateTime.addMinute( startDate, -30 );
// retourneert 31 dec 2008 10:00 AM

In het volgende voorbeeld worden 15 minuten opgeteld bij elke datumwaarde in het veld StartTijd:

BirtDateTime.addMinute( row["StartTijd"], 15 )

BirtDateTime.addMonth

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal maanden en een bepaalde datum. Het aantal toe te voegen maanden kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Deze functie levert altijd een geldige datum op. Als het nodig is, kan het daggedeelte van de geretourneerde datum worden vervangen door de laatste dag van de geretourneerde maand in het geretourneerde jaar. U kunt bijvoorbeeld een maand optellen bij 31 januari 2008, addMonth( ) retourneert 29 februari 2008 (2008 is een schrikkeljaar), in plaats van 31 februari 2008.

Syntaxis

BirtDateTime.addMonth( datum, n )

Parameters

datum

Datumobject. Een datumobject dat de begindatum aangeeft.

n

Getalsobject. Het aantal maanden dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, naar beneden afgerond.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal maanden bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden er maanden opgeteld bij een specifieke datum:

var startDate = "31-12-2008";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // retourneert 31 jan 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // retourneert 30 nov 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // retourneert 28 feb 2009

In het volgende voorbeeld worden 10 maanden opgeteld bij elke datumwaarde in het veld RekeningDatum:

BirtDateTime.addMonth( row["RekeningDatum"], 10 )

BirtDateTime.addQuarter

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal kwartalen en een bepaalde datum. Een kwartaal is gelijk aan drie maanden. Als u bijvoorbeeld twee kwartalen optelt bij 10 september 2008, geeft de functie het resultaat 10 maart 2009. Het aantal toe te voegen kwartalen kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addQuarter( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft.

n

Getalsobject. Het aantal kwartalen dat bij de datum moet worden opgeteld.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal kwartalen bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden kwartalen opgeteld bij een specifieke datum:

var startDate = "15-12-2008";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); //retourneert 15 mrt 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); //retourneert 15 jun 2008

In het volgende voorbeeld worden 2 kwartalen opgeteld bij elke datumwaarde in het veld ForecastClosing:

BirtDateTime.addQuarter( row["ForecastClosing"], 2 )

BirtDateTime.addSecond

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal seconden en een bepaalde datum. Het aantal toe te voegen seconden kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addSecond( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

n

Getalsobject. Het aantal seconden dat bij de datum moet worden opgeteld.

Resultaat

Datumobject. Het resultaat van het optellen van het gespecificeerde aantal seconden bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden er seconden opgeteld bij een specifieke datum en tijd:

var startDate = "31-12-2008 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// retourneert 31 dec 2008 13:16:40
endDate = BirtDateTime.addSecond( startDate, -10000 );
// retourneert 31 dec 2008 7:43:20

In het volgende voorbeeld worden 6000 seconden opgeteld bij elke datumwaarde in het veld StartTime:

BirtDateTime.addSecond( row["StartTime"], 6000 )

BirtDateTime.addWeek

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal weken en een bepaalde datum. Het aantal toe te voegen weken kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addWeek( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft.

n

Getalsobject. Het aantal weken dat bij de datum moet worden opgeteld.

Resultaat

Datumobject. Een datum die het resultaat is van het optellen van het aantal weken bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden weken opgeteld bij een specifieke datum:

var startDate = "31-12-2008";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // retourneert 07 jan 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // retourneert 24 dec 2008

In het volgende voorbeeld worden 2 weken opgeteld bij elke datumwaarde in het veld RekeningDatum:

BirtDateTime.addWeek( row["RekeningDatum"], 2 )

BirtDateTime.addYear

Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal jaren en een bepaalde datum. Het aantal toe te voegen jaren kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.

Syntaxis

BirtDateTime.addYear( datum, n )

Parameters

datum

Een datumobject dat de begindatum aangeeft.

n

Getalsobject. Het aantal jaren dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, naar beneden afgerond.

Resultaat

Een datum die het resultaat is van het optellen van het aantal jaren bij de begindatum.

Voorbeelden

In het volgende voorbeeld worden jaren opgeteld bij een specifieke datum:

var startDate = "31-12-2008";
var endDate;
endDate = BirtDateTime.addYear( startDate, 1 ); // retourneert 31 dec 2009
endDate = BirtDateTime.addYear( startDate, -1 ); // retourneert 31 dec 2007

In het volgende voorbeeld worden 5 jaren opgeteld bij elke datumwaarde in het veld HireDate:

BirtDateTime.addYear( row["HireDate"], 5 )

BirtDateTime.day

Deze functie geeft als resultaat een getal van 1 tot 31 dat de dag van de maand voor een bepaalde datum aangeeft. Als de datum bijvoorbeeld 19-01-2009 is, retourneert de functie de waarde 19.

Syntaxis

BirtDateTime.day( datum )

Parameter

datum

Datumobject. Een datumobject waaruit de dag wordt opgehaald.

Resultaat

Een geheel getal dat voor een bepaalde de dag van de maand datum aangeeft.

Voorbeelden

In het volgende voorbeeld is het resultaat de dag van de maand voor elke waarde in het veld ShipDate:

BirtDateTime.day( row["ShipDate"] )

In het volgende voorbeeld is het resultaat de dag van de maand voor de huidige datum:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Deze functie berekent het aantal dagen tussen twee datums. Een dag wordt berekend door de dagwaarde van de eerste datum af te trekken van de dagwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 30-12-2008 23:59:59 is en de tweede datum 31-12-2008 00:00:00, geeft de functie als resultaat 1 dag, ondanks dat er slechts één seconde tussen de tijdstippen ligt.

Syntaxis

BirtDateTime.diffDay( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal dagen tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal dagen tussen specifieke datums:

BirtDateTime.diffDay( "01-01-2009", "15-04-2009" ) // retourneert 104

Het resultaat van het volgende voorbeeld is het aantal dagen tussen de huidige datum en het einde van 2009:

BirtDateTime.diffDay( BirtDateTime.today(), "31-12-2009" )

Het resultaat van het volgende voorbeeld is het aantal dagen tussen de velden InvoiceDate en PaymentDate:

BirtDateTime.diffDay( row["InvoiceDate"], row["PaymentDate"] )

BirtDateTime.diffHour

Deze functie berekent het aantal uren tussen twee datums. Een uur wordt berekend door de uurwaarde van de eerste datum af te trekken van de uurwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 1:30:00 is en de tweede datum 31-01-2008 2:00:00, geeft de functie als resultaat 1 uur, ondanks dat er slechts 30 minuten tussen de datums liggen. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

Syntaxis

BirtDateTime.diffHour( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal uren tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal uren tussen specifieke datums:

BirtDateTime.diffHour( "31-01-2009 12:00:00", "01-02-2009 12:00:00")
// retourneert 24
BirtDateTime.diffHour( "31-01-2009", "01-02-2009 12:00:00")
// retourneert 36. Omdat de eerste datum geen tijdwaarde heeft, wordt ervan uitgegaan dat het middernacht is.

Het resultaat van het volgende voorbeeld is het aantal uren tussen de huidige datum en tijd en het einde van 2009:

BirtDateTime.diffHour( BirtDateTime.now(), "31-12-2009" );

Het resultaat van het volgende voorbeeld is het aantal uren tussen de velden StartTime en FinishTime:

BirtDateTime.diffHour( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMinute

Deze functie berekent het aantal minuten tussen twee datums. Een minuut wordt berekend door de minuutwaarde van de eerste datum af te trekken van de minuutwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 1:30:59 is en de tweede datum 31-01-2009 1:31:00, geeft de functie als resultaat 1 minuut, ondanks dat er slechts één seconde tussen de datums ligt. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

Syntaxis

BirtDateTime.diffMinute( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal minuten tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal minuten tussen specifieke datums:

BirtDateTime.diffMinute( "31-01-2009 1:30:30", "31-01-2009 10:45:00")
// retourneert 555
BirtDateTime.diffMinute( "31-01-2009", "31-01-2009 12:00:00")
// retourneert 720. Omdat de eerste datum geen tijdwaarde heeft, wordt ervan uitgegaan dat het middernacht is.

Het resultaat van het volgende voorbeeld is het aantal minuten tussen de huidige datum en tijd en het begin van 2010:

BirtDateTime.diffMinute( BirtDateTime.now(), "01-01-2010" )

Het resultaat van het volgende voorbeeld is het aantal minuten tussen de velden StartTime en FinishTime:

BirtDateTime.diffMinute( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMonth

Deze functie berekent het aantal maanden tussen twee datums. Een maand wordt berekend door de maandwaarde van de eerste datum af te trekken van de maandwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 is en de tweede datum 01-02-2009, geeft de functie als resultaat 1 maand, ondanks dat er slechts één dag tussen de datums ligt.

Syntaxis

BirtDateTime.diffMonth( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal maanden tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal maanden tussen specifieke datums:

BirtDateTime.diffMonth( "31-01-2009", "15-04-2009") // retourneert 3

Het resultaat van het volgende voorbeeld is het aantal maanden tussen de huidige datum en het begin van 2010:

BirtDateTime.diffMonth( BirtDateTime.today(), "01-01-2010" );

Het resultaat van het volgende voorbeeld is het aantal maanden tussen de velden ProjectStart en ProjectComplete:

BirtDateTime.diffMonth( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffQuarter

Deze functie berekent het aantal kwartalen tussen twee datums. Een kwartaal wordt berekend door de maandwaarde van de eerste datum af te trekken van de maandwaarde van de tweede datum. Een verschil van drie maanden is gelijk aan een kwartaal. Als de eerste datum bijvoorbeeld 31-01-2009 is en de tweede datum 01-07-2009, geeft de functie als resultaat 2. Als de eerste datum 01-01-2008 is en de tweede datum 30-09-2009, retourneert de functie eveneens 2.

Syntaxis

BirtDateTime.diffQuarter( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal kwartalen tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen specifieke datums:

BirtDateTime.diffQuarter( "31-01-2009", "15-04-2009") // retourneert 1

Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen de huidige datum en het begin van 2010:

BirtDateTime.diffQuarter( BirtDateTime.today(), "01-01-2010" );

Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen de velden ProjectStart en ProjectComplete:

BirtDateTime.diffQuarter( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffSecond

Deze functie berekent het aantal seconden tussen twee datums. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).

Syntaxis

BirtDateTime.diffSecond( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal seconden tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal seconden tussen specifieke datums:

BirtDateTime.diffSecond( "31-01-2009 11:30:30", "31-01-2009 12:00:00")
// retourneert 1770
BirtDateTime.diffSecond( "31-01-2009", "31-01-2009 1:00:00")
// retourneert 3600. Omdat de eerste datum geen tijdwaarde heeft, wordt ervan uitgegaan dat het middernacht is.

Het resultaat van het volgende voorbeeld is het aantal seconden tussen de huidige datum en tijd en het begin van 2010:

BirtDateTime.diffSecond( BirtDateTime.now(), "01-01-2010" )

Het resultaat van het volgende voorbeeld is het aantal seconden tussen de velden StartTime en FinishTime:

BirtDateTime.diffSecond( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffWeek

Deze functie berekent het aantal weken tussen twee datums. Een week wordt berekend door het weeknummer van de eerste datum af te trekken van het weeknummer van de tweede datum. Als de eerste datum bijvoorbeeld 02-01-2009 is (week 1 van het jaar) en de tweede datum 05-01-2009 (week 2 van het jaar), geeft de functie als resultaat 1 week, ondanks dat er slechts drie dagen tussen de datums liggen.

Syntaxis

BirtDateTime.diffWeek( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal weken tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal weken tussen specifieke datums:

BirtDateTime.diffWeek( "01-01-2009", "01-02-2009" ) // retourneert 5

Het resultaat van het volgende voorbeeld is het aantal weken tussen de huidige datum en het begin van 2010:

BirtDateTime.diffWeek( BirtDateTime.today(), "01-01-2010" );

Het resultaat van het volgende voorbeeld is het aantal weken tussen de velden ProjectStart en ProjectComplete:

BirtDateTime.diffWeek( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffYear

Deze functie berekent het aantal jaren tussen twee datums. Een jaar wordt berekend door de jaarwaarde van de eerste datum af te trekken van de jaarwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 01-01-2009 is en de tweede datum 31-12-2009, geeft de functie als resultaat 0. Als de eerste datum 15-11-2008 is en de tweede datum 15-01-2009, retourneert de functie 1.

Syntaxis

BirtDateTime.diffYear( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal jaren tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal jaren tussen specifieke datums:

BirtDateTime.diffYear( "01-01-2005", "01-06-2009") // retourneert 4

Het resultaat van het volgende voorbeeld is het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.diffYear

Deze functie berekent het aantal jaren tussen twee datums. Een jaar wordt berekend door de jaarwaarde van de eerste datum af te trekken van de jaarwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 01-01-2009 is en de tweede datum 31-12-2009, geeft de functie als resultaat 0. Als de eerste datum 15-11-2008 is en de tweede datum 15-01-2009, retourneert de functie 1.

Syntaxis

BirtDateTime.diffYear( datum1, datum2 )

Parameters

datum1

Een datumobject dat het begin van een tijdsperiode aangeeft.

datum2

Een datumobject dat het einde van een tijdsperiode aangeeft.

Resultaat

Geheel getal. Het aantal jaren tussen twee datums.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal jaren tussen specifieke datums:

BirtDateTime.diffYear( "01-01-2005", "01-06-2009") // retourneert 4

Het resultaat van het volgende voorbeeld is het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.firstDayOfMonth

Deze functie retourneert de datum van de eerste dag van de maand waarin de invoerdatum valt.

Syntaxis

BirtDateTime.firstDayOfMonth( datum )

Parameters

datum

Een datumobject waaruit de maand wordt opgehaald.

Resultaat

Datumobject. De eerste dag van de maand voor een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de maandwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.firstDayOfMonth( "15-02-2009" ) // levert 01-02-2009 op

BirtDateTime.firstDayOfQuarter

Deze functie retourneert de datum van de eerste dag van het kwartaal waarin de invoerdatum valt.

Syntaxis

BirtDateTime.firstDayOfQuarter( datum )

Parameters

datum

Een datumobject waaruit het kwartaalwordt opgehaald.

Resultaat

Datumobject. De eerste dag van het kwartaal voor een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de kwartaalwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.firstDayOfQuarter( "15-02-2009" ) // retourneert 01-01-2009

BirtDateTime.firstDayOfWeek

Deze functie retourneert de datum van de eerste dag van de week waarin de invoerdatum valt. De eerste dag van de week is altijd een zondag.

Syntaxis

BirtDateTime.firstDayOfWeek( datum )

Parameters

datum

Een datumobject waaruit de week wordt opgehaald.

Resultaat

Datumobject. De eerste dag van de week voor een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de weekwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.firstDayOfWeek( "15-02-2009" ) // levert 15-02-2009 op

BirtDateTime.firstDayOfYear

Deze functie retourneert de datum van de eerste dag van het jaar waarin de invoerdatum valt.

Syntaxis

BirtDateTime.firstDayOfYear( datum )

Parameters

datum

Een datumobject waaruit het jaar wordt opgehaald.

Resultaat

Datumobject. De eerste dag van het jaar voor een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de jaarwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.firstDayOfYear( "15-02-2009" ) // retourneert 01-01-2009

BirtDateTime.month

Het resultaat van deze functie is de maand van een bepaalde datum. Afhankelijk van de gekozen optie, kan de functie de maand retourneren als getal, als volledige naam van de maand of als afgekorte naam. De naam van de maand is specifiek voor de gebruikte locale.

Syntaxis

BirtDateTime.month( datum, optie )

Parameters

datum

Een datumobject waaruit de maand wordt opgehaald.

optie

Geheel getal. Optioneel. Een getal dat de geretourneerde maandnotatie aangeeft. Geef een van de volgende waarden op:

*
*
*

Als u dit argument weglaat, retourneert de functie de maand als getal.

Resultaat

Tekenreeks. De maand van een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de maandwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.month( "15-02-2009" ) // retourneert 2
BirtDateTime.month( "15-02-2009", 2 ) // retourneert februari
BirtDateTime.month( "15-02-2009", 3) // retourneert feb

In het volgende voorbeeld is het resultaat de maand voor de huidige datum:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Deze functie geeft als resultaat de huidige datum en tijd, bijvoorbeeld 2 feb 2009 2:05 PM.

Syntaxis

BirtDateTime.now( )

Resultaat

Datumobject. De actuele datum en tijd.

Voorbeeld

Het resultaat van het volgende voorbeeld is het aantal uren tussen de huidige datum en tijd en Kerstmis:

BirtDateTime.diffHour( BirtDateTime.now(), "25-12-2009" )

BirtDateTime.quarter

Deze functie geeft als resultaat een getal van 1 tot 4 dat het kwartaal voor een bepaalde datum aangeeft. Het eerste kwartaal begint op 1 januari.

Syntaxis

BirtDateTime.quarter( datum )

Parameter

date

Een datumobject waaruit het kwartaalnummer wordt opgehaald.

Resultaat

Geheel getal. Het kwartaalnummer van een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de kwartaalnummers die worden geretourneerd voor bepaalde datums:

BirtDateTime.quarter( "15-02-2009" ) // retourneert 1
BirtDateTime.quarter( "10-07-2009" ) // retourneert 3

In het volgende voorbeeld is het resultaat het kwartaal voor elke waarde in het veld CloseDate:

BirtDateTime.quarter( row["CloseDate"] )

In het volgende voorbeeld is het resultaat het kwartaalnummer voor de huidige datum:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Deze functie geeft als resultaat de huidige datum die de tijdwaarde van middernacht bevat, bijvoorbeeld 2 feb 2009 00:00.

Syntaxis

BirtDateTime.today( )

Resultaat

Datumobject. De actuele datum, met als tijdswaarde middernacht.

Voorbeelden

Het resultaat van het volgende voorbeeld is het aantal dagen tussen de actuele datum en Kerstmis:

BirtDateTime.diffDay( BirtDateTime.today(), "25-12-2009" )

Het volgende voorbeeld berekent het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum.

BirtDateTime.diffYear( [HireDate], BirtDateTime.today() )

BirtDateTime.week

Deze functie geeft als resultaat een getal van 1 tot 52 dat het weeknummer van een bepaalde datum aangeeft.

Syntaxis

BirtDateTime.week( datum )

Parameter

datum

Een datumobject waaruit het weeknummer wordt opgehaald.

Resultaat

Geheel getal. Het weeknummer van een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de weeknummers die worden geretourneerd voor bepaalde datums:

BirtDateTime.week( "15-02-2009" ) // retourneert 8
BirtDateTime.week( "12-10-2009" ) // retourneert 42

In het volgende voorbeeld is het resultaat de week voor elke waarde in het veld CloseDate:

BirtDateTime.week( row["CloseDate"] )

In het volgende voorbeeld is het resultaat het weeknummer voor de huidige datum:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Het resultaat van deze functie is de week van een bepaalde datum. Afhankelijk van de gekozen optie, kan de functie de dag van de week retourneren als getal, als volledige weekdagnaam of als afgekorte weekdagnaam. De naam van de weekdag is specifiek voor de gebruikte locale.

Syntaxis

BirtDateTime.weekDay( datum, optie )

Parameters

datum

Een datumobject waaruit de dag van de week wordt opgehaald.

optie

Geheel getal. Optioneel. Een getal dat de te retourneren notatie aangeeft. Geef een van de volgende waarden op:

*
*
*
*
*

Als u dit argument weglaat, maakt de functie gebruik van optie 1.

Resultaat

Tekenreeks. De dag van de week voor een bepaalde datum.

Voorbeelden

Het volgende voorbeeld toont de weekdagwaarden die worden geretourneerd voor een bepaalde datum:

BirtDateTime.weekDay( "02-02-2009" ) // retourneert 2
BirtDateTime.weekDay( "02-02-2009", 2 ) // retourneert 1
BirtDateTime.weekDay( "02-02-2009", 4 ) // retourneert maandag

In het volgende voorbeeld is het resultaat de weekdag voor de huidige datum:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Het resultaat van deze functie is het jaar in vier cijfers van een bepaalde datum. Als de datum bijvoorbeeld 19-01-2009 is, retourneert de functie de waarde 2009.

Syntaxis

BirtDateTime.year( datum )

Parameter

datum

Een datumobject waaruit het jaar wordt opgehaald.

Resultaat

Geheel getal. De uit vier cijfers bestaande waarde voor het jaar van een bepaalde datum.

Voorbeelden

In het volgende voorbeeld is het resultaat het jaar voor elke waarde in het veld HireDate:

BirtDateTime.year( row["HireDate"] )

In het volgende voorbeeld is het resultaat het jaar voor de huidige datum:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013