Forrige Neste

Klassen BirtDateTime

BirtDateTime-klassen har funksjoner som fastsetter hvor mye tid det er mellom to datoer eller klokkeslett, for å legge til eller trekke fra tidsrom, og for å hente deler av en dato. Siden datoer bare er tall, kan applikasjonen bruke vanlige regnefunksjoner på dem, det vil si multiplikasjon, divisjon, addisjon, subtraksjon og så videre. Denne klassen er statisk. Applikasjonen kan ikke opprette forekomster av klassen.

BirtDateTime.addDay

Denne funksjonen returnerer en ny dato som er summen når et gitt antall dager legges til en dato. Antall dager som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addDay( Date date, Number n )

Parametere

date

Datoobjekt. Et datoobjekt som representerer startdatoen.

n

Number-objekt. Antall dager som skal legges til datoen. Desimaltall behandles som heltall, avrundet ned til nærmeste heltall.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall dager legges til startdatoen.

Eksempler

Det følgende eksempelet legger dager til en bestemt dato:

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

Det følgende eksempelet legger 15 dager til hver datoverdi i InvoiceDate-feltet:

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

BirtDateTime.addHour

Denne funksjonen returnerer en ny dato som er summen når et gitt antall timer legges til en dato. Antall timer som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addHour( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

n

Number-objekt. Antall timer som skal legges til datoen.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall timer legges til startdatoen.

Eksempler

Det følgende eksempelet legger timer til en bestemt dato:

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

Det følgende eksempelet legger 36 dager til hver datoverdi i StartTime-feltet:

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

BirtDateTime.addMinute

Denne funksjonen returnerer en ny dato som er summen når et gitt antall minutter legges til en dato. Antall minutter som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addMinute( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

n

Number-objekt. Antall minutter som skal legges til datoen.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall minutter legges til startdatoen.

Eksempler

Det følgende eksempelet legger minutter til en bestemt dato:

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

Det følgende eksempelet legger 15 minutter til hver datoverdi i StartTime-feltet:

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

BirtDateTime.addMonth

Denne funksjonen returnerer en ny dato som er summen når et gitt antall måneder legges til en dato. Antall måneder som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Denne funksjonen returnerer alltid en gyldig dato. Hvis det er nødvendig, vil dagdelen av den resulterende datoen bli justert nedover til den siste dagen i den resulterende måneden i det resulterende året. Hvis du for eksempel legger 1 måned til 31. januar 2008, returnerer addMonth( ) 29. februar 2008 (2008 var et skuddår), ikke 31. februar 2008.

Syntaks

Date BirtDateTime.addMonth( Date date, Number n )

Parametere

date

Datoobjekt. Et datoobjekt som representerer startdatoen.

n

Number-objekt. Antall måneder som skal legges til datoen. Desimaltall behandles som heltall, avrundet nedover.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall måneder legges til startdatoen.

Eksempler

Det følgende eksempelet legger måneder til en bestemt dato:

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

Det følgende eksempelet legger 10 måneder til hver datoverdi i InvoiceDate-feltet:

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

BirtDateTime.addQuarter

Denne funksjonen returnerer en ny dato som er summen når et gitt antall kvartaler legges til en dato. Et kvartal er lik tre måneder. Hvis du for eksempel legger 2 kvartaler til 10. september 2008, returnerer funksjonen 10. mars 2009. Antall kvartaler som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addQuarter( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen.

n

Number-objekt. Antall kvartaler som skal legges til datoen.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall kvartaler legges til startdatoen.

Eksempler

Det følgende eksempelet legger kvartaler til en bestemt dato:

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

Det følgende eksempelet legger 2 kvartaler til hver datoverdi i ForecastClosing-feltet:

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

BirtDateTime.addSecond

Denne funksjonen returnerer en ny dato som er summen når et gitt antall sekunder legges til en dato. Antall sekunder som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addSecond( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

n

Number-objekt. Antall sekunder som skal legges til datoen.

Returnerer

Datoobjekt. Resultatet når det oppgitte antall sekunder legges til startdatoen.

Eksempler

Det følgende eksempelet legger sekunder til en bestemt dato:

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

Det følgende eksempelet legger 6000 sekunder til hver datoverdi i StartTime-feltet:

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

BirtDateTime.addWeek

Denne funksjonen returnerer en ny dato som er summen når et gitt antall uker legges til en dato. Antall uker som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addWeek( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen.

n

Number-objekt. Antall uker som skal legges til datoen.

Returnerer

Datoobjekt. Den datoen som opprettes når det oppgitte antall uker legges til startdatoen.

Eksempler

Det følgende eksempelet legger uker til en bestemt dato:

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

Det følgende eksempelet legger 2 uker til hver datoverdi i InvoiceDate-feltet:

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

BirtDateTime.addYear

Denne funksjonen returnerer en ny dato som er summen når et gitt antall år legges til en dato. Antall år som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.

Syntaks

Date BirtDateTime.addYear( Date date, Number n )

Parametere

date

Et datoobjekt som representerer startdatoen.

n

Number-objekt. Antall år som skal legges til datoen. Desimaltall behandles som heltall, avrundet nedover.

Returnerer

Den datoen som opprettes når det oppgitte antall år legges til startdatoen.

Eksempler

Det følgende eksempelet legger år til en bestemt dato:

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

Det følgende eksempelet legger 5 år til hver datoverdi i HireDate-feltet:

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

BirtDateTime.day

Denne funksjonen returnerer et tall fra 1 til 31 som representerer dagen i måneden for en gitt dato. Hvis datoen for eksempel er 2009-01-19, returnerer funksjonen 19.

Syntaks

integer BirtDateTime.day( Date date )

Parameter

date

Datoobjekt. Et datoobjekt som dagen hentes fra.

Returnerer

Et heltall som representerer dagen i måneden for en gitt dato.

Eksempler

Det følgende eksempelet returnerer dagen i måneden for hver verdi i ShipDate-feltet:

BirtDateTime.day( row["ShipDate"] )

Det følgende eksempelet returnerer dagen i måneden for den gjeldende datoen:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Denne funksjonen returnerer antall dager mellom to datoer. En dag beregnes ved å trekke dagverdien for den første datoen fra dagverdien for den andre datoen. Hvis den første datoen for eksempel er 2008-12-30 23:59:59, og den andre datoen er 2008-12-31 00:00:00, returnerer funksjonen 1 dag, selv om bare ett sekund skiller de to datoene.

Syntaks

integer BirtDateTime.diffDay( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall dager mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall dager mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall dager fra gjeldende dato til slutten av 2009:

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

Det følgende eksempelet returnerer antall dager mellom verdier i InvoiceDate- og PaymentDate-feltet:

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

BirtDateTime.diffHour

Denne funksjonen returnerer antall timer mellom to datoer. En time beregnes ved å trekke timeverdien for den første datoen fra timeverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31 1:30:00, og den andre datoen er 2009-01-31 2:00:00, returnerer funksjonen 1 time, selv om bare 30 minutter skiller de to datoene. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

Syntaks

integer BirtDateTime.diffHour( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall timer mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall timer mellom bestemte datoer:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// returns 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// returns 36. Because the first date does not have a time, midnight is assumed.

Det følgende eksempelet returnerer antall timer fra gjeldende dato og klokkeslett til slutten av 2009:

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

Det følgende eksempelet returnerer antall timer mellom verdier i StartTime- og FinishTime-feltet:

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

BirtDateTime.diffMinute

Denne funksjonen returnerer antall minutter mellom to datoer. Et minutt beregnes ved å trekke minuttverdien for den første datoen fra minuttverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31 1:30:59, og den andre datoen er 2009-01-31 1:31:00, returnerer funksjonen 1 minutt, selv om bare ett sekund skiller de to datoene. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

Syntaks

integer BirtDateTime.diffMinute( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall minutter mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall minutter mellom bestemte datoer:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// returns 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// returns 720. Because the first date does not have a time, midnight is assumed.

Det følgende eksempelet returnerer antall minutter fra gjeldende dato og klokkeslett til begynnelsen av 2010:

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

Det følgende eksempelet returnerer antall minutter mellom verdier i StartTime- og FinishTime-feltet:

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

BirtDateTime.diffMonth

Denne funksjonen returnerer antall måneder mellom to datoer. En måned beregnes ved å trekke månedsverdien for den første datoen fra månedsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31, og den andre datoen er 2009-02-01, returnerer funksjonen 1 måned, selv om bare en dag skiller de to datoene.

Syntaks

integer BirtDateTime.diffMonth( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall måneder mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall måneder mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall måneder fra gjeldende dato til begynnelsen av 2010:

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

Det følgende eksempelet returnerer antall måneder mellom verdier i ProjectStart- og ProjectComplete-feltet:

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

BirtDateTime.diffQuarter

Denne funksjonen returnerer antall kvartaler mellom to datoer. Et kvartal beregnes ved å trekke månedsverdien for den første datoen fra månedsverdien for den andre datoen. En differanse på 3 måneder er lik 1 kvartal. Hvis den første datoen for eksempel er 2009-01-31, og den andre datoen er 2009-07-01, returnerer funksjonen 2. Hvis den første datoen er 2009-01-01, og den andre datoen er 2009-09-30, returnerer funksjonen også 2.

Syntaks

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall kvartaler mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall kvartaler mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall kvartaler fra gjeldende dato til begynnelsen av 2010:

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

Det følgende eksempelet returnerer antall kvartaler mellom verdier i ProjectStart- og ProjectComplete-feltet:

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

BirtDateTime.diffSecond

Denne funksjonen returnerer antall sekunder mellom to datoer. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).

Syntaks

integer BirtDateTime.diffSecond( date1, date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall sekunder mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall sekunder mellom bestemte datoer:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// returns 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// returns 3600. Because the first date does not have a time, midnight is assumed.

Det følgende eksempelet returnerer antall sekunder fra gjeldende dato og klokkeslett til begynnelsen av 2010:

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

Det følgende eksempelet returnerer antall sekunder mellom verdier i StartTime- og FinishTime-feltet:

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

BirtDateTime.diffWeek

Denne funksjonen returnerer antall uker mellom to datoer. En uke beregnes ved å trekke ukeverdien for den første datoen fra ukeverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-02 (uke 1 i året), og den andre datoen er 2009-01-05 (uke 2 i året), returnerer funksjonen 1 uke, selv om bare tre dager skiller de to datoene.

Syntaks

integer BirtDateTime.diffWeek( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall uker mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall uker mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall uker fra gjeldende dato til begynnelsen av 2010:

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

Det følgende eksempelet returnerer antall uker mellom verdier i ProjectStart- og ProjectComplete-feltet:

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

BirtDateTime.diffYear

Denne funksjonen returnerer antall år mellom to datoer. Et år beregnes ved å trekke årsverdien for den første datoen fra årsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-01, og den andre datoen er 2009-12-31, returnerer funksjonen 0. Hvis den første datoen er 2008-11-15, og den andre datoen er 2009-01-15, returnerer funksjonen 1.

Syntaks

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall år mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall år mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall år mellom hver verdi i HireDate-feltet og den gjeldende datoen:

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

BirtDateTime.diffYear

Denne funksjonen returnerer antall år mellom to datoer. Et år beregnes ved å trekke årsverdien for den første datoen fra årsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-01, og den andre datoen er 2009-12-31, returnerer funksjonen 0. Hvis den første datoen er 2008-11-15, og den andre datoen er 2009-01-15, returnerer funksjonen 1.

Syntaks

integer BirtDateTime.diffYear( Date date1, Date date2 )

Parametere

date1

Et datoobjekt som representerer starten av tidsrommet.

date2

Et datoobjekt som representerer slutten av tidsrommet.

Returnerer

Heltall. Antall år mellom to datoer.

Eksempler

Det følgende eksempelet returnerer antall år mellom bestemte datoer:

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

Det følgende eksempelet returnerer antall år mellom hver verdi i HireDate-feltet og den gjeldende datoen:

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

BirtDateTime.firstDayOfMonth

Denne funksjonen returnerer datoen for den første dagen i måneden som oppgitt dato tilhører.

Syntaks

Date BirtDateTime.firstDayOfMonth( Date date)

Parametere

date

Et datoobjekt som måneden hentes fra.

Returnerer

Datoobjekt. Den første dagen i måneden for en gitt dato.

Eksempler

Det følgende eksempelet viser månedsverdier som er returnert for en bestemt dato:

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

BirtDateTime.firstDayOfQuarter

Denne funksjonen returnerer datoen for den første dagen i kvartalet som oppgitt dato tilhører.

Syntaks

Date BirtDateTime.firstDayOfQuarter( Date date)

Parametere

date

Et datoobjekt som kvartalet hentes fra.

Returnerer

Datoobjekt. Den første dagen i kvartalet for en gitt dato.

Eksempler

Det følgende eksempelet viser kvartalsverdier som er returnert for en bestemt dato:

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

BirtDateTime.firstDayOfWeek

Denne funksjonen returnerer datoen for den første dagen i uken som oppgitt dato tilhører.

Syntaks

Date BirtDateTime.firstDayOfWeek( Date date)

Parametere

date

Et datoobjekt som uken hentes fra.

Returnerer

Datoobjekt. Den første dagen i uken for en gitt dato.

Eksempler

Det følgende eksempelet viser ukeverdier som er returnert for en bestemt dato:

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

BirtDateTime.firstDayOfYear

Denne funksjonen returnerer datoen for den første dagen i året som oppgitt dato tilhører.

Syntaks

Date BirtDateTime.firstDayOfYear( Date date)

Parametere

date

Et datoobjekt som året hentes fra.

Returnerer

Datoobjekt. Den første dagen i året for en gitt dato.

Eksempler

Det følgende eksempelet viser årsverdier som er returnert for en bestemt dato:

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

BirtDateTime.month

Denne funksjonen returnerer måneden for en gitt dato. Avhengig av hvilket alternativ du oppgir, returnerer funksjonen måneden som månedsnummeret, det fullstendige månedsnavnet eller det forkortede månedsnavnet. Månedsnavnet er språkmiljøspesifikt.

Syntaks

string BirtDateTime.month( Date date, integer option )

Parametere

date

Et datoobjekt som måneden hentes fra.

option

Heltall. Valgfri. Et tall som representerer månedsformatet som skal returneres. Bruk en av de følgende verdiene:

*
*
*

Hvis du utelater dette argumentet, returnerer funksjonen måneden som et nummer.

Returnerer

Streng. Måneden for en gitt dato.

Eksempler

Det følgende eksempelet viser månedsverdier som er returnert for en bestemt dato:

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

Det følgende eksempelet returnerer måneden for den gjeldende datoen:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Denne funksjonen returnerer gjeldende dato og klokkeslett, for eksempel Feb 2, 2009 2:05 PM.

Syntaks

Date BirtDateTime.now( )

Returnerer

Datoobjekt. Gjeldende dato og klokkeslett.

Eksempel

Det følgende eksempelet returnerer hvor mange timer det er fra gjeldende dato og klokkeslett til jul:

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

BirtDateTime.quarter

Denne funksjonen returnerer et tall fra 1 til 4 som representerer kvartalet som en gitt dato tilhører. Første kvartal begynner 1. januar.

Syntaks

integer BirtDateTime.quarter( Date date )

Parameter

date

Et datoobjekt som kvartalsnummeret hentes fra.

Returnerer

Heltall. Kvartalsnummeret for en gitt dato.

Eksempler

Det følgende eksempelet viser kvartalsnumrene som er returnert for bestemte datoer:

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

Det følgende eksempelet returnerer kvartalsnummeret for hver verdi i CloseDate-feltet:

BirtDateTime.quarter( row["CloseDate"] )

Det følgende eksempelet returnerer kvartalsnummeret for den gjeldende datoen:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Denne funksjonen returnerer gjeldende dato, inkludert en klokkeslettverdi for midnatt, for eksempel Feb 2, 2009 12:00 AM.

Syntaks

Date BirtDateTime.today( )

Returnerer

Datoobjekt. Gjeldende dato med en klokkeslettverdi for midnatt.

Eksempler

Det følgende eksempelet returnerer antall dager fra gjeldende dato til jul:

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

Det følgende eksempelet beregner antall år fra hver verdi i HireDate-feltet til gjeldende dato.

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

BirtDateTime.week

Denne funksjonen returnerer et tall fra 1 til 52 som representerer ukenummeret for en gitt dato.

Syntaks

integer BirtDateTime.week( date )

Parameter

date

Et datoobjekt som ukenummeret hentes fra.

Returnerer

Heltall. Ukenummeret for en gitt dato.

Eksempler

Det følgende eksempelet viser ukenumrene som er returnert for bestemte datoer:

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

Det følgende eksempelet returnerer ukenummeret for hver verdi i CloseDate-feltet:

BirtDateTime.week( row["CloseDate"] )

Det følgende eksempelet returnerer ukenummeret for den gjeldende datoen:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Denne funksjonen returnerer ukedagen for en gitt dato. Avhengig av hvilket alternativ du oppgir, returnerer funksjonen ukedagen som et nummer, det fullstendige dagnavnet eller det forkortede dagnavnet. Navnet på ukedagen er språkmiljøspesifikt.

Syntaks

string BirtDateTime.weekDay( Date date, integer option )

Parametere

date

Et datoobjekt som ukedagen hentes fra.

option

Heltall. Valgfri. Et tall som representerer formatet som skal returneres. Bruk en av de følgende verdiene:

*
*
*
*
*

Hvis du utelater dette argumentet, antar funksjonen alternativ 1.

Returnerer

Streng. Ukedagen for en gitt dato.

Eksempler

Det følgende eksempelet viser ukedagverdier som er returnert for en bestemt dato:

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

Det følgende eksempelet returnerer ukedagen for den gjeldende datoen:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Denne funksjonen returnerer den firesifrede årsverdien for en gitt dato. Hvis datoen for eksempel er 2009-01-19, returnerer funksjonen 2009.

Syntaks

integer BirtDateTime.year( date )

Parameter

date

Et datoobjekt som året hentes fra.

Returnerer

Heltall. Den firesifrede verdien for en gitt dato.

Eksempler

Det følgende eksempelet returnerer året for hver verdi i HireDate-feltet:

BirtDateTime.year( row["HireDate"] )

Det følgende eksempelet returnerer året for den gjeldende datoen:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013