Forrige Næste

Klassen BirtDateTime

Klassen BirtDateTime indeholder funktioner, der kan bestemme tidsrummet mellem to klokkeslæt eller datoer, lægge tidsrum til eller trække dem fra og hente dele i en dato. Eftersom tidsrum blot er tal, kan programmet anvende almindelig aritmetik til dem: multiplikation, division, addition, subtraktion osv. Klassen er statisk. Programmet kan ikke oprette forekomster af klassen.

BirtDateTime.addDay

Funktionen returnerer en ny dato, der er resultatet af, at et antal dage lægges til en dato. Et negativt antal dage kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addDay( Date date, Number n )

Parametre

date

Datoobjekt. Et datoobjekt, der repræsenterer startdatoen.

n

Talobjekt. Det antal dage, der skal lægges til datoen. Et decimaltal behandles som det nærmeste heltal, decimaltallet er rundet ned til.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal dage.

Eksempler

I følgende eksempel lægges dage til en bestemt dato:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // returnerer 1. januar 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // returnerer 30. december 2008

Følgende eksempel lægger 15 dage til datoværdien i feltet InvoiceDate:

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

BirtDateTime.addHour

Funktionen returnerer en ny dato, der er resultatet af, at et antal timer lægges til en dato. Et negativt antal timer kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addHour( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen. Hvis en startdato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

n

Talobjekt. Det antal timer, der skal lægges til datoen.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal timer.

Eksempler

I følgende eksempel lægges timer til en bestemt dato og et bestemt klokkeslæt:

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

Følgende eksempel lægger 36 timer til hver datoværdi i feltet StartTime:

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

BirtDateTime.addMinute

Funktionen returnerer en ny dato, der er resultatet af, at et antal minutter lægges til en dato. Et negativt antal minutter kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addMinute( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen. Hvis en startdato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

n

Talobjekt. Det antal minutter, der skal lægges til datoen.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal minutter.

Eksempler

I følgende eksempel lægges minutter til en bestemt dato og et bestemt klokkeslæt:

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

Følgende eksempel lægger 15 minutter til hver datoværdi i feltet StartTime:

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

BirtDateTime.addMonth

Funktionen returnerer en ny dato, der er resultatet af, at et antal måneder lægges til en dato. Et negativt antal måneder kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Funktionen returnerer altid en gyldig dato. Om nødvendigt justeres delen dag i resultatdatoen nedad til den sidste dag i resultatmåneden i resultatåret. Eksempel: Hvis du lægger 1 måned til 31. januar 2008, returnerer addMonth( ) 29. februar 2008 (2008 er et skudår), ikke 31. februar 2008.

Syntaks

Date BirtDateTime.addMonth( Date date, Number n )

Parametre

date

Datoobjekt. Et datoobjekt, der repræsenterer startdatoen.

n

Talobjekt. Det antal måneder, der skal lægges til datoen. Et decimaltal behandles som et heltal, decimaltallet er rundet ned til.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal måneder.

Eksempler

I følgende eksempel lægges måneder til en bestemt dato:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // returnerer 31. januar 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // returnerer 30. november 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // returnerer 28. februar 2009

Følgende eksempel lægger 10 måneder til datoværdien i feltet InvoiceDate:

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

BirtDateTime.addQuarter

Funktionen returnerer en ny dato, der er resultatet af, at et antal kvartaler lægges til en dato. Et kvartal er det samme som tre måneder. Hvis du f.eks. lægger 2 kvartaler til 10. september 2008, returnerer funktionen 10. maj 2009. Et negativt antal kvartaler kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addQuarter( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen.

n

Talobjekt. Det antal kvartaler, der skal lægges til datoen.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal kvartaler.

Eksempler

I følgende eksempel lægges kvartaler til en bestemt dato:

var startDate = "2008-12-15";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); //returnerer 15. marts 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); //returnerer 15. juni 2008

Følgende eksempel lægger 2 kvartaler til hver datoværdi i feltet ForecastClosing:

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

BirtDateTime.addSecond

Funktionen returnerer en ny dato, der er resultatet af, at et antal sekunder lægges til en dato. Et negativt antal sekunder kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addSecond( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen. Hvis en startdato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

n

Talobjekt. Det antal sekunder, der skal lægges til datoen.

Returnerer

Datoobjekt. Resultatet af, at det angivne antal sekunder lægges til startdatoen.

Eksempler

I følgende eksempel lægges sekunder til en bestemt dato og et bestemt klokkeslæt:

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

Følgende eksempel lægger 6000 sekunder til hver datoværdi i feltet StartTime:

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

BirtDateTime.addWeek

Funktionen returnerer en ny dato, der er resultatet af, at et antal uger lægges til en dato. Et negativt antal uger kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addWeek( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen.

n

Talobjekt. Det antal uger, der skal lægges til datoen.

Returnerer

Datoobjekt. En dato, der er summen af startdatoen plus det angivne antal uger.

Eksempler

I følgende eksempel lægges uger til en bestemt dato:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // returnerer 7. januar 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // returnerer 24. december 2008

Følgende eksempel lægger 2 uger til hver datoværdi i feltet InvoiceDate:

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

BirtDateTime.addYear

Funktionen returnerer en ny dato, der er resultatet af, at et antal år lægges til en dato. Et negativt antal år kan lægges til. I det tilfælde fås et resultat, som svarer til, at det pågældende antal trækkes fra datoen.

Syntaks

Date BirtDateTime.addYear( Date date, Number n )

Parametre

date

Et datoobjekt, der repræsenterer startdatoen.

n

Talobjekt. Det antal år, der skal lægges til datoen. Et decimaltal behandles som et heltal, decimaltallet er rundet ned til.

Returnerer

En dato, der er summen af startdatoen plus det angivne antal år.

Eksempler

I følgende eksempel lægges år til en bestemt dato:

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

Følgende eksempel lægger 5 år til hver datoværdi i feltet HireDate:

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

BirtDateTime.day

Funktionen returnerer et tal fra 1 til 31, der repræsenterer dagen i måneden for en given dato. Eksempel: Hvis datoen er 2009-01-19, returnerer funktionen 19.

Syntaks

integer BirtDateTime.day( Date date )

Parameter

date

Datoobjekt. Et datoobjekt, som dagen skal udtrækkes fra.

Returnerer

Et heltal, der repræsenterer dagen i måneden for en given dato.

Eksempler

Følgende eksempel returnerer dagen i måneden for hver værdi i feltet ShipDate:

BirtDateTime.day( row["ShipDate"] )

Følgende eksempel returnerer dagen i måneden for dags dato:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Funktionen returnerer antallet af dage mellem to datoer. En dag beregnes, ved at værdien for dagen i den første dato trækkes fra værdien for dagen i den anden dato. Eksempel: Hvis den første dato er 2008-12-30 23:59:59, og den anden dato er 2008-12-31 00:00:00, returnerer funktionen 1 dag, selvom der kun er ét sekund mellem de to værdier.

Syntaks

integer BirtDateTime.diffDay( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af dage mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af dage mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af dage fra dags dato til slutningen af 2009:

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

Følgende eksempel returnerer antallet af dage mellem værdier i felterne InvoiceDate og PaymentDate:

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

BirtDateTime.diffHour

Funktionen returnerer antallet af timer mellem to datoer. En time beregnes, ved at timeværdien i den første dato trækkes fra timeværdien i den anden dato. Eksempel: Hvis den første dato er 2009-01-31 1:30:00, og den anden dato er 2009-01-31 2:00:00, returnerer funktionen 1 time, selvom der kun er 30 minutter mellem de to værdier. Hvis en dato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

Syntaks

integer BirtDateTime.diffHour( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af timer mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af timer mellem bestemte datoer:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// returnerer 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// returnerer 36. Da den første dato ikke har et klokkeslæt, antages det, at det er midnat.

Følgende eksempel returnerer antallet af timer fra nu til slutningen af 2009:

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

Følgende eksempel returnerer antallet af timer mellem værdier i felterne StartTime og FinishTime:

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

BirtDateTime.diffMinute

Funktionen returnerer antallet af minutter mellem to datoer. Et minut beregnes, ved at minutværdien i den første dato trækkes fra minutværdien i den anden dato. Eksempel: Hvis den første dato er 2009-01-31 1:30:59, og den anden dato er 2009-01-31 1:31:00, returnerer funktionen 1 minut, selvom der kun er ét sekund mellem de to værdier. Hvis en dato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

Syntaks

integer BirtDateTime.diffMinute( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af minutter mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af minutter mellem bestemte datoer:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// returnerer 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// returnerer 720. Da den første dato ikke har et klokkeslæt, antages det, at det er midnat.

Følgende eksempel returnerer antallet af minutter fra nu til begyndelsen af 2010:

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

Følgende eksempel returnerer antallet af minutter mellem værdier i felterne StartTime og FinishTime:

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

BirtDateTime.diffMonth

Funktionen returnerer antallet af måneder mellem to datoer. En måned beregnes, ved at værdien for måned i den første dato trækkes fra værdien for måned i den anden dato. Eksempel: Hvis den første dato er 2009-01-31, og den anden dato er 2009-02-01, returnerer funktionen 1 måned, selvom der kun er én dag mellem de to datoer.

Syntaks

integer BirtDateTime.diffMonth( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af måneder mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af måneder mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af måneder fra dags dato til begyndelsen af 2010:

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

Følgende eksempel returnerer antallet af måneder mellem værdier i felterne ProjectStart og ProjectComplete:

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

BirtDateTime.diffQuarter

Funktionen returnerer antallet af kvartaler mellem to datoer. Et kvartal beregnes, ved at værdien for måned i den første dato trækkes fra værdien for måned i den anden dato. En forskel på tre måneder er lig med 1 kvartal. Eksempel: Hvis den første dato er 2009-01-31, og den anden dato er 2009-07-01, returnerer funktionen 2. Hvis den første dato er 2009-01-01, og den anden dato er 2009-09-30, returnerer funktionen også 2.

Syntaks

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af kvartaler mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af kvartaler mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af kvartaler fra dags dato til begyndelsen af 2010:

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

Følgende eksempel returnerer antallet af kvartaler mellem værdier i felterne ProjectStart og ProjectComplete:

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

BirtDateTime.diffSecond

Funktionen returnerer antallet af sekunder mellem to datoer. Hvis en dato ikke har en klokkeslætsværdi, antages det i funktionen, at det er midnat (00:00:00).

Syntaks

integer BirtDateTime.diffSecond( date1, date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af sekunder mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af sekunder mellem bestemte datoer:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// returnerer 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// returnerer 3600. Da den første dato ikke har et klokkeslæt, antages det, at det er midnat.

Følgende eksempel returnerer antallet af sekunder fra nu til begyndelsen af 2010:

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

Følgende eksempel returnerer antallet af sekunder mellem værdier i felterne StartTime og FinishTime:

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

BirtDateTime.diffWeek

Funktionen returnerer antallet af uger mellem to datoer. En uge beregnes, ved at ugenummeret i den første dato trækkes fra ugenummeret i den anden dato. Eksempel: Hvis den første dato er 2009-01-02 (uge 1 i året), og den anden dato er 2009-01-05 (uge 2 i året), returnerer funktionen 1 uge, selvom der kun er tre dage mellem de to datoer.

Syntaks

integer BirtDateTime.diffWeek( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af uger mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af uger mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af uger fra dags dato til begyndelsen af 2010:

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

Følgende eksempel returnerer antallet af uger mellem værdier i felterne ProjectStart og ProjectComplete:

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

BirtDateTime.diffYear

Funktionen returnerer antallet af år mellem to datoer. Et år beregnes, ved at årstallet i den første dato trækkes fra årstallet i den anden dato. Eksempel: Hvis den første dato er 2009-01-01, og den anden dato er 2009-12-31, returnerer funktionen 0. Hvis den første dato er 2008-11-15, og den anden dato er 2009-01-15, returnerer funktionen 1.

Syntaks

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af år mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af år sekunder mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af år mellem hver værdi i feltet HireDate og dags dato:

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

BirtDateTime.diffYear

Funktionen returnerer antallet af år mellem to datoer. Et år beregnes, ved at årstallet i den første dato trækkes fra årstallet i den anden dato. Eksempel: Hvis den første dato er 2009-01-01, og den anden dato er 2009-12-31, returnerer funktionen 0. Hvis den første dato er 2008-11-15, og den anden dato er 2009-01-15, returnerer funktionen 1.

Syntaks

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametre

date1

Et datoobjekt, der repræsenterer tidsrummets start.

date2

Et datoobjekt, der repræsenterer tidsrummets slutning.

Returnerer

Heltal. Antallet af år mellem to datoer.

Eksempler

Følgende eksempel returnerer antallet af år sekunder mellem bestemte datoer:

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

Følgende eksempel returnerer antallet af år mellem hver værdi i feltet HireDate og dags dato:

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

BirtDateTime.firstDayOfMonth

Funktionen returnerer datoen for den første dag i den måned, hvor den angivne dato falder.

Syntaks

Date BirtDateTime.firstDayOfMonth( Date date)

Parametre

date

Et datoobjekt, som måneden skal udtrækkes fra.

Returnerer

Datoobjekt. Den første dag i måneden i en given dato.

Eksempler

Følgende eksempel viser de månedsværdier, der returneres for en bestemt dato:

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

BirtDateTime.firstDayOfQuarter

Funktionen returnerer datoen for den første dag i det kvartal, hvor den angivne dato falder.

Syntaks

Date BirtDateTime.firstDayOfQuarter( Date date)

Parametre

date

Et datoobjekt, som kvartalet skal udtrækkes fra.

Returnerer

Datoobjekt. Den første dag i kvartalet for en given dato.

Eksempler

Følgende eksempel viser den kvartalsværdi, der returneres for en bestemt dato:

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

BirtDateTime.firstDayOfWeek

Funktionen returnerer datoen for den første dag i den uge, hvor den angivne dato falder. Dagen er mandag eller søndag afhængigt af sprogkonventionen.

Syntaks

Date BirtDateTime.firstDayOfWeek( Date date)

Parametre

date

Et datoobjekt, som dagen skal udtrækkes fra.

Returnerer

Datoobjekt. Den første dag i ugen for en given dato.

Eksempler

Følgende eksempel viser den ugeværdi, der returneres for en bestemt dato:

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

BirtDateTime.firstDayOfYear

Funktionen returnerer datoen for den første dag i det år, hvor den angivne dato falder.

Syntaks

Date BirtDateTime.firstDayOfYear( Date date)

Parametre

date

Et datoobjekt, som året skal udtrækkes fra.

Returnerer

Datoobjekt. Den første dag i året i en given dato.

Eksempler

Følgende eksempel viser den årsværdi, der returneres for en bestemt dato:

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

BirtDateTime.month

Funktionen returnerer måneden for en given dato. Afhængigt af den indstilling du angiver, returnerer funktionen måneden som et tal, hele månedsnavnet eller det forkortede månedsnavn. Månedsnavnet afhænger af sprogkonventionen.

Syntaks

string BirtDateTime.month( Date date, integer option )

Parametre

date

Et datoobjekt, som måneden skal udtrækkes fra.

option

Heltal. Valgfrit. Et tal, der repræsenterer det månedsformat, der skal returneres. Brug en af følgende værdier:

*
*
*

Hvis du udelader argumentet, returnerer funktionen måneden som et tal.

Returnerer

Streng. Måneden for en given dato.

Eksempler

Følgende eksempel viser de månedsværdier, der returneres for en bestemt dato:

BirtDateTime.month( "2009-02-15" ) // returnerer 2
BirtDateTime.month( "2009-02-15", 2 ) // returnerer februar
BirtDateTime.month( "2009-02-15", 3) // returnerer feb

Følgende eksempel returnerer måneden for dags dato:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Funktionen returnerer dags dato og det aktuelle klokkeslæt, f.eks. 2. feb 2009 14:05.

Syntaks

Date BirtDateTime.now( )

Returnerer

Datoobjekt. Dags dato og det aktuelle klokkeslæt.

Eksempel

Følgende eksempel returnerer antallet af timer fra nu til jul:

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

BirtDateTime.quarter

Funktionen returnerer et tal fra 1 til 4, der repræsenterer det kvartal, som en given dato falder i. Første kvartal begynder 1. januar.

Syntaks

integer BirtDateTime.quarter( Date date )

Parameter

date

Et datoobjekt, som kvartalsnummeret skal udtrækkes fra.

Returnerer

Heltal. Kvartalsnummeret for en given dato.

Eksempler

Følgende eksempel viser det kvartalsnummer, der returneres for en bestemt dato:

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

Følgende eksempel returnerer kvartalsnummeret for hver værdi i feltet CloseDate:

BirtDateTime.quarter( row["CloseDate"] )

Følgende eksempel returnerer kvartalsnummeret for dags dato:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Funktionen returnerer dags dato inklusive klokkeslætsværdien midnat, f.eks. 2. februar 2009 00:00.

Syntaks

Date BirtDateTime.today( )

Returnerer

Datoobjekt. Dags dato med klokkeslættet midnat.

Eksempler

Følgende eksempel returnerer antallet af dage fra dags dato til jul:

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

Følgende eksempel beregner antallet af år fra hver værdi i datafeltet HireDate til dags dato.

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

BirtDateTime.week

Funktionen returnerer et tal fra 1 til 52, der repræsenterer ugenummeret for en given dato.

Syntaks

integer BirtDateTime.week( date )

Parameter

date

Et datoobjekt, som ugenummeret skal udtrækkes fra.

Returnerer

Heltal. Ugenummeret for en given dato.

Eksempler

Følgende eksempel viser det ugenummer, der returneres for en bestemt dato:

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

Følgende eksempel returnerer ugenummeret for hver værdi i feltet CloseDate:

BirtDateTime.week( row["CloseDate"] )

Følgende eksempel returnerer ugenummeret for dags dato:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Funktionen returnerer ugedagen for en given dato. Afhængigt af den indstilling du angiver, returnerer funktionen ugedagen som et tal, hele ugedagens navn eller det forkortede navn på ugedagen. Ugedagens navn afhænger af sprogkonventionen.

Syntaks

string BirtDateTime.weekDay( Date date, integer option )

Parametre

date

Et datoobjekt, som ugedagen skal udtrækkes fra.

option

Heltal. Valgfrit. Et tal, der repræsenterer det format, der skal returneres. Brug en af følgende værdier:

*
*
*
*
*

Hvis du udelader argumentet, bruges værdien 1 for indstillingen.

Returnerer

Streng. Dagen i ugen for en given dato.

Eksempler

Følgende eksempel viser de ugedagsværdier, der returneres for en bestemt dato:

BirtDateTime.weekDay( "2009-02-02" ) // returnerer 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // returnerer 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // returnerer mandag

Følgende eksempel returnerer ugedagen for dags dato:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Funktionen returnerer en firecifret årstalsværdi for en given dato. Eksempel: Hvis datoen er 2009-01-19, returnerer funktionen 2009.

Syntaks

integer BirtDateTime.year( date )

Parameter

date

Et datoobjekt, som året skal udtrækkes fra.

Returnerer

Heltal. Den firecifrede årstalsværdi for en given dato.

Eksempler

Følgende eksempel returnerer året for hver værdi i feltet HireDate:

BirtDateTime.year( row["HireDate"] )

Følgende eksempel returnerer året for dags dato:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013