Föregående Nästa

Klassen BirtDateTime

Klassen BirtDateTime innehåller funktioner för att bestämma mängden tid mellan två datum eller två tidpunkter, för att addera eller subtrahera tidsintervall och för att hämta delar av ett datum. Eftersom datumintervall endast är siffror kan tillämpningen använda vanlig matematik på dem: multiplikation, division, addition, subtraktion, osv. Klassen är statisk. Tillämpningen kan inte skapa förekomster av klassen.

BirtDateTime.addDay

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal dagar har adderats till ett datum. Antalet dagar som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addDay( Date date, Number n )

Parametrar

date

Datumobjekt. Ett datumobjekt som motsvarar startdatumet.

n

Talobjekt. Antalet dagar som ska adderas till datumet. Decimaler behandlas som heltal avrundade till närmaste heltal.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal dagar har adderats till startdatumet.

Exempel

Följande exempel adderar dagar till ett angivet datum:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // returnerar Jan 01, 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // returnerar Dec 30, 2008

Följande exempel adderar 15 dagar till varje datumvärde i fältet InvoiceDate:

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

BirtDateTime.addHour

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal timmar har adderats till ett datum. Antalet timmar som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addHour( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet. Om ett startdatum inte har ett tid värde förutsätts att klockslaget är midnatt (00:00:00).

n

Talobjekt. Antalet timmar som ska adderas till datumet.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal timmar har adderats till startdatumet.

Exempel

Följande exempel adderar timmar till ett angivet datum och klockslag:

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

Följande exempel adderar 36 timmar till varje datumvärde i fältet StartTime:

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

BirtDateTime.addMinute

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal minuter har adderats till ett datum. Antalet minuter som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addMinute( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet. Om ett startdatum inte har ett tid värde förutsätts att klockslaget är midnatt (00:00:00).

n

Talobjekt. Antalet minuter som ska adderas till datumet.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal minuter har adderats till startdatumet.

Exempel

Följande exempel adderar minuter till ett angivet datum och klockslag:

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

Följande exempel adderar 15 minuter till varje datumvärde i fältet StartTime:

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

BirtDateTime.addMonth

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal månader har adderats till ett datum. Antalet månader som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Funktionen returnerar alltid ett giltigt datum. Om det krävs justeras dagdelen i det resulterande datumet nedåt till den sista dagen i resultatets månad och år. Exempel: Om du lägger till 1 månad till 31 januari 2008, returnerar funktionen addMonth( ) 29 febrari 2008 (2008 är ett skottår) i stället för den 28 februari.

Syntax

Date BirtDateTime.addMonth( Date date, Number n )

Parametrar

date

Datumobjekt. Ett datumobjekt som motsvarar startdatumet.

n

Talobjekt. Antalet månader som ska läggas till i datumet. Decimaler behandlas som heltal avrundat nedåt.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal månader har adderats till startdatumet.

Exempel

Följande exempel adderar månader till ett angivet datum:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // returnerar Jan 31, 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // returnerar Nov 30, 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // returnerar Feb 28, 2009

Följande exempel adderar 10 månader till varje datumvärde i fältet InvoiceDate:

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

BirtDateTime.addQuarter

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal kvartal har adderats till ett datum. Ett kvartal är lika med tre månader. Exempel: Om du lägger till 2 kvartal till 10 september 2008, returnerar funktionen 10 mars 2009. Antalet kvartal som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addQuarter( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet.

n

Talobjekt. Antalet kvartal som ska adderas till datumet.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal kvartal har adderats till startdatumet.

Exempel

Följande exempel adderar kvartal till ett angivet datum:

var startDate = "2008-12-15";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); //returnerar Mar 15, 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); //returnerar Jun 15, 2008

Följande exempel adderar 2 kvartal till varje datumvärde i fältet ForecastClosing:

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

BirtDateTime.addSecond

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal sekunder har adderats till ett datum. Antalet sekunder som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addSecond( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet. Om ett startdatum inte har ett tid värde förutsätts att klockslaget är midnatt (00:00:00).

n

Talobjekt. Antalet sekunder som ska adderas till datumet.

Returnerar

Datumobjekt. Resultatet av att lägga till det angivna antalet sekunder till startdatumet.

Exempel

Följande exempel adderar sekunder till ett angivet datum och klockslag:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// returnerar Dec 31, 2008 1:16:40 PM
endDate = BirtDateTime.addSecond( startDate, -10000 );
// returnerar Dec 31, 2008 7:43:20 AM

Följande exempel adderar 6000 sekunder till varje datumvärde i fältet StartTime:

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

BirtDateTime.addWeek

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal veckor har adderats till ett datum. Antalet veckor som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addWeek( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet.

n

Talobjekt. Antalet veckor som ska adderas till datumet.

Returnerar

Datumobjekt. Ett datum som är resultatet av att angivet antal veckor har adderats till startdatumet.

Exempel

Följande exempel adderar veckor till ett angivet datum:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // returnerar Jan 07, 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // returnerar Dec 24, 2008

Följande exempel adderar 2 veckor till varje datumvärde i fältet InvoiceDate:

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

BirtDateTime.addYear

Funktionen returnerar ett nytt datum som är resultatet av att ett givet antal år har adderats till ett datum. Antalet år som ska adderas kan vara ett negativt tal. I det här fallet blir resultatet som om antalet hade dragits ifrån datumet.

Syntax

Date BirtDateTime.addYear( Date date, Number n )

Parametrar

date

Ett datumobjekt som motsvarar startdatumet.

n

Talojekt. Antalet år som ska läggas till i datumet. Decimaler behandlas som heltal avrundat nedåt.

Returnerar

Ett datum som är resultatet av att angivet antal år har adderats till startdatumet.

Exempel

Följande exempel adderar år till ett angivet datum:

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

Följande exempel adderar 5 år till varje datumvärde i fältet HireDate:

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

BirtDateTime.day

Funktionen returnerar ett tal från 1 till 31 som motsvarar dagen i månaden för ett givet datum. Exempel: Om datumet är 2009-01-19, returneras 19.

Syntax

integer BirtDateTime.day( Date date )

Parameter

date

Datumobjekt. Ett datumobjekt som dagen ska hämtas ifrån.

Returnerar

Ett heltal som motsvarar dagen i månaden för ett givet datum.

Exempel

Följande exempel returnerar dagen i månader för varje värde i fältet ShipDate:

BirtDateTime.day( row["ShipDate"] )

Följande exempel returnerar dagen i månaden för innevarande datum:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Funktionen returnerar antalet dagar mellan två datum. En dag beräknas genom att subtrahera dagvärdet för det första datumet från dagvärdet för det andra datumet. Exempel: Om det första datumet är 2008-12-30 23:59:59 och det andra datumet är 2008-12-31 00:00:00, returneras 1 dag, även om endast en sekund skiljer mellan de två datumen.

Syntax

integer BirtDateTime.diffDay( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet dagar mellan två datum.

Exempel

Följande exempel returnerar antalet dagar mellan angivna datum:

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

Följande exempel returnerar antalet dagar från innevarande datum till slutet av 2009:

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

Följande exempel returnerar antalet dagar mellan värdena i fälten InvoiceDate och PaymentDate:

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

BirtDateTime.diffHour

Funktionen returnerar antalet timmar mellan två datum. En timme beräknas genom att subtrahera timvärdet för det första datumet från timvärdet för det andra datumet. Exempel: Om det första datumet är 2009-01-31 1:30:00 och det andra datumet är 2009-01-31 2:00:00, retunerars 1 timme, även om endast 30 minuter skiljer mellan de två datumen. Om ett datum inte har ett tidsvärde förutsätts att klockslaget är midnatt (00:00:00).

Syntax

integer BirtDateTime.diffHour( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet timmar mellan två datum.

Exempel

Följande exempel returnerar antalet timmar mellan angivna datum:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// returnerar 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// returnerar 36. Eftersom det första datumet inte har något tidsvärde förutsätts att det är midnatt.

Följande exempel returnerar antalet timmar från innevarande datum och klockslag till slutet av 2009:

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

Följande exempel returnerar antalet timmar mellan värdena i fälten StartTime och FinishTime:

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

BirtDateTime.diffMinute

Funktionen returnerar antalet minuter mellan två datum. En minut beräknas genom att subtrahera minutvärdet för det första datumet från minutvärdet för det andra datumet. Exempel: Om det första datumet är 2009-01-31 1:30:59 och det andra datumet är 2009-01-31 1:31:00, returneras 1 minut, även om endast en sekund skiljer mellan de två datumen. Om ett datum inte har ett tidsvärde förutsätts att klockslaget är midnatt (00:00:00).

Syntax

integer BirtDateTime.diffMinute( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet minuter mellan två datum.

Exempel

Följande exempel returnerar antalet minuter mellan angivna datum:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// returnerar 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// returnerar 720. Eftersom det första datumet inte har något tidsvärde förutsätts att det är midnatt.

Följande exempel returnerar antalet minuter från innevarande datum och klockslag till början av 2010:

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

Följande exempel returnerar antalet minuter mellan värdena i fälten StartTime och FinishTime:

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

BirtDateTime.diffMonth

Funktionen returnerar antalet månader mellan två datum. En månad beräknas genom att subtrahera månadsvärdet för det första datumet från månadsvärdet för det andra datumet. Exempel: Om det första datumet är 2009-01-31 och det andra datumet är 2009-02-01, returneras 1 månad, även om endast en dag skiljer mellan de två datumen.

Syntax

integer BirtDateTime.diffMonth( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet månader mellan två datum.

Exempel

Följande exempel returnerar antalet månader mellan angivna datum:

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

Följande exempel returnerar antalet månader från innevarande datum till början av 2010:

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

Följande exempel returnerar antalet månader mellan värdena i fälten ProjectStart och ProjectComplete:

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

BirtDateTime.diffQuarter

Funktionen returnerar antalet kvartal mellan två datum. Ett kvartal beräknas genom att subtrahera månadsvärdet för det första datumet från månadsvärdet för det andra datumet. En skillnad på 3 månader är lika med 1 kvartal. Exempel: Om det första datumet är 2009-01-31 och det andra datumet är 2009-07-01, returneras 2. Om det första datumet är 2009-01-01 och det andra datumet är 2009-09-30, returneras också 2.

Syntax

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet kvartal mellan två datum.

Exempel

Följande exempel returnerar antalet kvartal mellan angivna datum:

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

Följande exempel returnerar antalet kvartal från innevarande datum till början av 2010:

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

Följande exempel returnerar antalet kvartal mellan värdena i fälten ProjectStart och ProjectComplete:

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

BirtDateTime.diffSecond

Funktionen returnerar antalet sekunder mellan två datum. Om ett datum inte har ett tidsvärde förutsätts att klockslaget är midnatt (00:00:00).

Syntax

integer BirtDateTime.diffSecond( date1, date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet sekunder mellan två datum.

Exempel

Följande exempel returnerar antalet sekunder mellan angivna datum:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// returnerar 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// returnerar 3600. Eftersom det första datumet inte har något tidsvärde förutsätts att det är midnatt.

Följande exempel returnerar antalet sekunder från innevarande datum och klockslag till början av 2010:

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

Följande exempel returnerar antalet sekunder mellan värdena i fälten StartTime och FinishTime:

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

BirtDateTime.diffWeek

Funktionen returnerar antalet veckor mellan två datum. En vecka beräknas genom att subtrahera veckonumret för det första datumet från veckonumret för det andra datumet. Exempel: Om det första datumet är 2009-01-02 (vecka 1 på året) och det andra datumet är 2009-01-05 (vecka 2 på året), returneras 1 även om endast tre dagar skiljer mellan de två datumen.

Syntax

integer BirtDateTime.diffWeek( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet veckor mellan två datum.

Exempel

Följande exempel returnerar antalet veckor mellan angivna datum:

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

Följande exempel returnerar antalet veckor från innevarande datum till början av 2010:

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

Följande exempel returnerar antalet veckor mellan värdena i fälten ProjectStart och ProjectComplete:

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

BirtDateTime.diffYear

Funktionen returnerar antalet år mellan två datum. Ett år beräknas genom att subtrahera årsvärdet för det första datumet från årsvärdet för det andra datumet. Exempel. Om det första datumet är 2009-01-01 och det andra datumet är 2009-12-31, returneras 0. Om första datumet är 2008-11-15 och det andra datumet är 2009-01-15, returneras 1.

Syntax

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet år mellan två datum.

Exempel

Följande exempel returnerar antalet år mellan angivna datum:

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

Följande exempel returnerar antalet år mellan värden i fältet HireDate och innevarande datum:

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

BirtDateTime.diffYear

Funktionen returnerar antalet år mellan två datum. Ett år beräknas genom att subtrahera årsvärdet för det första datumet från årsvärdet för det andra datumet. Exempel. Om det första datumet är 2009-01-01 och det andra datumet är 2009-12-31, returneras 0. Om första datumet är 2008-11-15 och det andra datumet är 2009-01-15, returneras 1.

Syntax

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametrar

date1

Ett datumobjekt som motsvarar tidintervallets början.

date2

Ett datumobjekt som representerar tidintervallets slut.

Returnerar

Heltal. Antalet år mellan två datum.

Exempel

Följande exempel returnerar antalet år mellan angivna datum:

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

Följande exempel returnerar antalet år mellan värden i fältet HireDate och innevarande datum:

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

BirtDateTime.firstDayOfMonth

Funktionen returnerar datumet för den första dagen i månaden för angivet datum.

Syntax

Date BirtDateTime.firstDayOfMonth( Date date)

Parametrar

date

Ett datumobjekt som månaden ska hämtas ifrån.

Returnerar

Datumobjekt. Den första dagen i månaden för ett angivet datum.

Exempel

Följande exempel visar de månadsvärden som returneras för ett visst datum:

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

BirtDateTime.firstDayOfQuarter

Funktionen returnerar datumet för den första dagen i kvartalet för angivet datum.

Syntax

Date BirtDateTime.firstDayOfQuarter( Date date)

Parametrar

date

Ett datumobjekt som kvartalet ska hämtas ifrån.

Returnerar

Datumobjekt. Den första dagen i kvartalet för ett angivet datum.

Exempel

Följande exempel visar de kvartalsvärden som returneras för ett visst datum:

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

BirtDateTime.firstDayOfWeek

Funktionen returnerar datumet för den första dagen i veckan för angivet datum.

Syntax

Date BirtDateTime.firstDayOfWeek( Date date)

Parametrar

date

Ett datumobjekt som veckan ska hämtas ifrån.

Returnerar

Datumobjekt. Den första dagen i veckan för ett angivet datum.

Exempel

Följande exempel visar de veckovärden som returneras för ett visst datum:

BirtDateTime.firstDayOfWeek( "2009-02-15" ) // returnerar 2009-02-15

BirtDateTime.firstDayOfYear

Funktionen returnerar datumet för den första dagen i året för angivet datum.

Syntax

Date BirtDateTime.firstDayOfYear( Date date)

Parametrar

date

Ett datumobjekt som året ska hämtas ifrån.

Returnerar

Datumobjekt. Den första dagen i året för ett angivet datum.

Exempel

Följande exempel visar de årsvärden som returneras för ett visst datum:

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

BirtDateTime.month

Funktionen returnerar månaden för ett givet datum. Beroende på vilket alternativ du anger returneras månaden som ett tal, det fullständiga månadsnamnet eller det förkortade månadsnamnet. Månadsnamnet är språkmiljöspecifikt.

Syntax

string BirtDateTime.month( Date date, integer option )

Parametrar

date

Ett datumobjekt som månaden ska hämtas ifrån.

option

Heltal. Valfritt. Ett tal som motsvarar månadsformatet som ska returneras. Välj ett av följande värden:

*
*
*

Om du utesluter det här argumentet returneras månaden som ett tal.

Returnerar

Sträng. Månaden för ett givet datum.

Exempel

Följande exempel visar de månadsvärden som returneras för ett visst datum:

BirtDateTime.month( "2009-02-15" ) // returnerar 2
BirtDateTime.month( "2009-02-15", 2 ) // returnerar February
BirtDateTime.month( "2009-02-15", 3) // returnerar Feb

Följande exempel returnerar månaden för innevarande datum:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Funktionen returnerar innevarande datum och klockslag, t.ex. 2 februari 2009 02:05.

Syntax

Date BirtDateTime.now( )

Returnerar

Datumobjekt. Innevarande datum och klockslag.

Exempel

Följande exempel returnerar antalet timmar från innevarande datum och klockslag till jul.

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

BirtDateTime.quarter

Funktionen returnerar ett tal från 1 till 4 som motsvar kvartalet för ett givet datum. Det första kvartalet börjar 1 januari.

Syntax

integer BirtDateTime.quarter( Date date )

Parameter

date

Ett datumobjekt som kvartalet ska hämtas ifrån.

Returnerar

Heltal. Kvartalet för ett givet datum.

Exempel

Följande exempel visar kvartalsvärdet som returneras för angivna datum:

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

Följande exempel returnerar kvartalsvärdet för varje värde i fältet CloseDate:

BirtDateTime.quarter( row["CloseDate"] )

Följande exempel returnerar kvartalsvärdet för innevarande datum:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Funktionen returnerar innevarande datum och innefattar ett tidsvärde t.ex. 2 februari 2009 12:00.

Syntax

Date BirtDateTime.today( )

Returnerar

Datumobjekt. Innevarande datum med ett tidsvärde.

Exempel

Följande exempel returnerar antalet dagar från innevarande datum till jul:

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

Följande exempel beräknar antalet år från varje värde i datafältet HireDate till innevarande datum.

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

BirtDateTime.week

Funktionen returnerar ett tal från 1 till 52 som motsvarar veckonumret för ett givet datum.

Syntax

integer BirtDateTime.week( date )

Parameter

date

Ett datumobjekt som veckonumret ska hämtas ifrån.

Returnerar

Heltal. Veckonumret för ett givet datum.

Exempel

Följande exempel visar veckonumren som returneras för angivna datum:

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

Följande exempel returnerar veckonumret för varje värde i fältet CloseDate:

BirtDateTime.week( row["CloseDate"] )

Följande exempel returnerar veckonumret för innevarande datum:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Funktionen returnerar veckodagen för ett givet datum. Beroende på vilket alternativ du anger returneras veckodagen som ett tal, det fullständiga veckodagsnamnet eller det förkortade veckodagsnamnet. Veckodagsnamnet är språkmiljöspecifikt.

Syntax

string BirtDateTime.weekDay( Date date, integer option )

Parametrar

date

Ett datumobjekt som veckodagen ska hämtas ifrån.

option

Heltal. Valfritt. Ett tal som motsvarar formatet som ska returneras. Välj ett av följande värden:

*
*
*
*
*

Om du utesluter argumentet förutsätts 1

Returnerar

Sträng. Veckodagen för ett givet datum.

Exempel

Följande exempel visar de dagvärdena som returneras för ett visst datum:

BirtDateTime.weekDay( "2009-02-02" ) // returnerar 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // returnerar 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // returnerar Monday

Följande exempel returnerar veckodagen för innevarande datum:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Funktionen returnerar det fyrställiga årsvärdet för ett givet datum. Om datumet är 2009-01-19, returneras 2009.

Syntax

integer BirtDateTime.year( date )

Parameter

date

Ett datumobjekt som året ska hämtas ifrån.

Returnerar

Heltal. Det fyrställiga årsvärdet för ett givet datum.

Exempel

Följande exempel returnerar året för varje värde i fältet HireDate:

BirtDateTime.year( row["HireDate"] )

Följande exempel returnerar året för innevarande datum:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013