Précédent Suivant

Classe BirtDateTime

La classe statique DateTimeSpan fournit des fonctions permettant de déterminer le temps entre deux dates ou heures, d'ajouter ou de soustraire des intervalles de temps ou d'obtenir des parties d'une date. Puisque les dates ne sont que des nombres, l'application peut leur appliquer des opérations mathématiques simples : multiplication, division, addition, soustraction, etc. Cette classe est statique. L'application ne peut pas créer d'instance de la classe.

BirtDateTime.addDay

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de jours et d'une date. Le nombre de jours à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addDay( Date date, Number n )

Paramètres

date

Objet Date. Objet date qui représente la date de début.

n

Objet Nombre. Le nombre de jours à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers l'entier inférieur le plus proche.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre de jours défini à la date de début.

Exemples

Les exemples suivants ajoutent des jours à une date :

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

Les exemples suivants ajoutent 15 jours à chaque date dans la zone InvoiceDate :

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

BirtDateTime.addHour

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné d'heures et d'une date. Le nombre d'heures à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addHour( Date date, Number n )

Paramètres

date

Un objet date qui représente la date de début. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

n

Objet Nombre. Nombre d'heures à ajouter à la date.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre d'heures défini à la date de début.

Exemples

L'exemple suivant ajoute des heures à une date et une heure :

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

L'exemple suivant ajoute 36 jours à chaque date dans la zone StartTime :

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

BirtDateTime.addMinute

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de minutes et d'une date. Le nombre de minutes à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addMinute( Date date, Number n )

Paramètres

date

Objet date qui représente la date de début. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

n

Objet Nombre. Nombre de minutes à ajouter à la date.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre de minutes défini à la date de début.

Exemples

Les exemples suivants ajoutent des heures à une date et une heure :

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

L'exemple suivant ajoute 15 minutes à chaque date dans la zone StartTime :

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

BirtDateTime.addMonth

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de mois et d'une date. Le nombre de mois à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Cette fonction renvoie toujours une date valide. Si nécessaire, la partie jour de la date résultante est ajustée vers le bas sur le dernier jour du mois résultant de l'année résultante. Par exemple, si vous ajoutez 1 mois à 31 janvier 2008, addMonth( ) renvoie 29 février 2008 (2008 est une année bissextile) et non pas 31 février 2008.

Syntaxe

Date BirtDateTime.addMonth( Date date, Number n )

Paramètres

date

Objet Date. Objet date qui représente la date de début.

n

Objet Nombre. Le nombre de mois à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers le nombre inférieur.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre de mois défini à la date de début.

Exemples

L'exemple suivant ajoute des mois à une date :

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

L'exemple suivant ajoute 10 mois à chaque date dans la zone InvoiceDate :

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

BirtDateTime.addQuarter

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de trimestres et d'une date. Un trimestre est égal à trois mois. Par exemple, si vous ajoutez 2 trimestres à 10 septembre 2008, la fonction retourne 10 mars 2009. Le nombre de trimestres à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addQuarter( Date date, Number n )

Paramètres

date

Un objet date qui représente la date de début.

n

Objet Nombre. Nombre de trimestres à ajouter à la date.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre de trimestres défini à la date de début.

Exemples

L'exemple suivant ajoute des trimestres à une date :

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

L'exemple suivant ajoute 2 trimestres à chaque date dans la zone ForecastClosing :

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

BirtDateTime.addSecond

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de secondes et d'une date. Le nombre de secondes à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addSecond( Date date, Number n )

Paramètres

date

Un objet date qui représente la date de début. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

n

Objet Nombre. Nombre de secondes à ajouter à la date.

Renvoie

Objet Date. Résultat de l'ajout du nombre de secondes défini à la date de début.

Exemples

L'exemple suivant ajoute des secondes à une date et une heure :

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

L'exemple suivant ajoute 6000 secondes à chaque date dans la zone StartTime :

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

BirtDateTime.addWeek

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné de semaines et d'une date. Le nombre de semaines à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addWeek( Date date, Number n )

Paramètres

date

Un objet date qui représente la date de début.

n

Objet Nombre. Nombre de semaines à ajouter à la date.

Renvoie

Objet Date. Date qui résulte de l'ajout du nombre de semaines défini à la date de début.

Exemples

L'exemple suivant ajoute des semaines à une date :

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

L'exemple suivant ajoute 2 semaines à chaque date dans la zone InvoiceDate :

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

BirtDateTime.addYear

Cette fonction renvoie une nouvelle date qui est la somme du nombre donné d'années et d'une date. Le nombre d'années à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.

Syntaxe

Date BirtDateTime.addYear( Date date, Number n )

Paramètres

date

Un objet date qui représente la date de début.

n

Objet Nombre. Nombre d'années à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers le nombre inférieur.

Renvoie

Une date qui résulte de l'ajout du nombre d'années défini à la date de début.

Exemples

L'exemple suivant ajoute des années à une date :

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

L'exemple suivant ajoute 5 années à chaque date dans la zone HireDate :

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

BirtDateTime.day

Cette fonction retourne un nombre compris entre 1 et 31 qui correspond au jour du mois d'une date. Par exemple, si la date est 19 janvier 2009, la fonction retourne 19.

Syntaxe

integer BirtDateTime.day( Date date )

Paramètre

date

Objet Date. Objet date d'obtention du jour.

Renvoie

Entier qui correspond au jour du mois d'une date.

Exemples

L'exemple suivant retourne le jour du mois de chaque valeur dans la zone ShipDate :

BirtDateTime.day( row["ShipDate"] )

L'exemple suivant retourne le jour du mois de la date en cours :

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Cette fonction retourne le nombre de jours entre deux dates. Un jour est calculé en soustrayant la valeur de jour de la première date de la valeur de jour de la seconde date. Par exemple, si la première date est 30 décembre 2008 23:59:59 et la seconde date, 31 décembre 2008 00:00:00, la fonction retourne 1 jour, même si une seule seconde sépare les deux dates.

Syntaxe

integer BirtDateTime.diffDay( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période..

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de jours entre deux dates.

Exemples

Cette fonction retourne le nombre de jours entre deux dates :

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

L'exemple suivant renvoie le nombre de jours entre la date en cours et la fin de l'année 2009 :

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

L'exemple suivant renvoie le nombre de jours entre les valeurs qui figurent dans les zones InvoiceDate et PaymentDate :

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

BirtDateTime.diffHour

Cette fonction retourne le nombre d'heures entre deux dates. Une heure est calculée en soustrayant la valeur heure de la première date de la valeur heure de la seconde date. Par exemple, si la première date est 31 janvier 2009 1:30:00 et la seconde date, 31 janvier 2000 2:00:00, la fonction retourne 1 jour, même si 30 minutes séparent les deux dates. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

Syntaxe

integer BirtDateTime.diffHour( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre d'heures entre deux dates.

Exemples

L'exemple suivant retourne le nombre d'heures entre des dates :

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// retourne 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// retourne 36. Etant donné que la première date n'a pas d'heure, minuit est utilisé par défaut.

L'exemple suivant retourne le nombre d'heures entre la date en cours et la fin de l'année 2009 :

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

L'exemple suivant renvoie le nombre d'heures entre les valeurs figurant dans les zones StartTime et FinishTime :

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

BirtDateTime.diffMinute

Cette fonction retourne le nombre de minutes entre deux dates. Une minute est calculée en soustrayant la valeur minutes de la première date de la valeur minutes de la seconde date. Par exemple, si la première date est 31 janvier 2009 1:30:59 et la seconde date, 31 janvier 2009 1:31:00, la fonction retourne 1 jour, même si une seconde sépare les deux dates. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

Syntaxe

integer BirtDateTime.diffMinute( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de minutes entre deux dates.

Exemples

L'exemple suivant retourne le nombre de minutes entre deux dates :

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// retourne 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// retourne 720. Etant donné que la première date n'a pas d'heure, minuit est utilisé par défaut.

L'exemple suivant retourne le nombre de minutes entre la date et l'heure en cours et le début de l'année 2010 :

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

L'exemple suivant renvoie le nombre de minutes entre les valeurs figurant dans les zones StartTime et FinishTime :

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

BirtDateTime.diffMonth

Cette fonction renvoie le nombre de mois entre deux dates. Un mois est calculé en soustrayant la valeur mois de la première date de la valeur mois de la seconde date. Par exemple, si la première date est 31 janvier 2009 et la seconde date 1er février 2009, la fonction renvoie 1 mois, même si un seul jour sépare les deux dates.

Syntaxe

integer BirtDateTime.diffMonth( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de mois entre deux dates.

Exemples

L'exemple suivant retourne le nombre de mois entre des dates :

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

L'exemple suivant renvoie le nombre de mois entre la date en cours et le début de l'année 2010 :

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

L'exemple suivant renvoie le nombre de mois entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :

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

BirtDateTime.diffQuarter

Cette fonction retourne le nombre de trimestres entre deux dates. Un trimestre est calculé en soustrayant la valeur mois de la première date de la valeur mois de la seconde date. Une différence de 3 mois correspond à 1 trimestre. Par exemple, si la première date est 31 janvier 2009 et la seconde date 1er juillet 2009, la fonction renvoie 2. Si la première date est 1er janvier 2009 et la seconde date 30 septembre 2009, la fonction renvoie aussi 2.

Syntaxe

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de trimestres entre deux dates.

Exemples

L'exemple suivant retourne le nombre de trimestres entre deux dates :

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

L'exemple suivant renvoie le nombre de trimestres entre la date en cours et le début de l'année 2010 :

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

L'exemple suivant renvoie le nombre de trimestres entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :

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

BirtDateTime.diffSecond

Cette fonction retourne le nombre de secondes entre deux dates. Si une date de début n'a pas d'heure, la fonction suppose que l'heure correspond à minuit (00:00:00).

Syntaxe

integer BirtDateTime.diffSecond( date1, date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de secondes entre deux dates.

Exemples

L'exemple suivant retourne le nombre de secondes entre deux dates :

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// retourne 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// retourne 3600. Etant donné que la première date n'a pas d'heure, minuit est utilisé par défaut.

L'exemple suivant retourne le nombre de secondes entre la date et l'heure en cours et le début de l'année 2010 :

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

L'exemple suivant renvoie le nombre de secondes entre les valeurs figurant dans les zones StartTime et FinishTime :

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

BirtDateTime.diffWeek

Cette fonction retourne le nombre de semaines entre deux dates. Une semaine est calculée en soustrayant la valeur semaine de la première date de la valeur semaine de la seconde date. Par exemple, si la première date est 2 janvier 2009 (semaine 1 de l'année) et la seconde date, 5 janvier 2009 (semaine 2 de l'année), la fonction retourne 1 jour, même si seulement 3 jours séparent les deux dates.

Syntaxe

integer BirtDateTime.diffWeek( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre de semaines entre deux dates.

Exemples

L'exemple suivant retourne le nombre de semaines entre deux dates :

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

L'exemple suivant renvoie le nombre de semaines entre la date en cours et le début de l'année 2010 :

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

L'exemple suivant renvoie le nombre de semaines entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :

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

BirtDateTime.diffYear

Cette fonction renvoie le nombre d'années entre deux dates. Une année est calculée en soustrayant la valeur année de la première date de la valeur année de la seconde date. Par exemple, si la première date est 1er janvier 2009 et la seconde date 31 décembre 2009, la fonction renvoie 0. Si la première date est 15 novembre 2008 et la seconde date 15 janvier 2009, la fonction renvoie 1.

Syntaxe

integer BirtDateTime.diffYear( Date date1, Date date2 )

Paramètres

date1

Un objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre d'années entre deux dates.

Exemples

L'exemple suivant retourne le nombre d'années entre deux dates :

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

L'exemple suivant retourne le nombre d'années entre la valeur figurant dans la zone HireDate et la date en cours :

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

BirtDateTime.diffYear

Cette fonction renvoie le nombre d'années entre deux dates. Une année est calculée en soustrayant la valeur année de la première date de la valeur année de la seconde date. Par exemple, si la première date est 1er janvier 2009 et la seconde date 31 décembre 2009, la fonction renvoie 0. Si la première date est 15 novembre 2008 et la seconde date 15 janvier 2009, la fonction renvoie 1.

Syntaxe

integer BirtDateTime.diffYear( Date date1, Date date2 )

Paramètres

date1

Objet date qui représente le début de la période.

date2

Un objet date qui représente la fin de la période.

Renvoie

Entier. Nombre d'années entre deux dates.

Exemples

L'exemple suivant retourne le nombre d'années entre deux dates :

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

L'exemple suivant retourne le nombre d'années entre la valeur figurant dans la zone HireDate et la date en cours :

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

BirtDateTime.firstDayOfMonth

Cette fonction renvoie la date du premier jour du mois auquel la date d'entrée appartient.

Syntaxe

Date BirtDateTime.firstDayOfMonth( Date date)

Paramètres

date

Objet date d'obtention du mois.

Renvoie

Objet Date. Premier jour du mois pour une date donnée.

Exemples

L'exemple suivant montre les valeurs mois retournées pour une date données :

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

BirtDateTime.firstDayOfQuarter

Cette fonction renvoie la date du premier jour du trimestre auquel la date d'entrée appartient.

Syntaxe

Date BirtDateTime.firstDayOfQuarter( Date date)

Paramètres

date

Objet date d'obtention du trimestre.

Renvoie

Objet Date. Premier jour du trimestre pour une date donnée.

Exemples

L'exemple suivant montre les valeurs trimestre retournées pour une date donnée :

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

BirtDateTime.firstDayOfWeek

Cette fonction renvoie la date du premier jour de la semaine à laquelle appartient la date d'entrée, qui est toujours un lundi.

Syntaxe

Date BirtDateTime.firstDayOfWeek( Date date)

Paramètres

date

Objet date d'obtention de la semaine.

Renvoie

Objet Date. Premier jour de la semaine pour une date donnée.

Exemples

L'exemple suivant montre les valeurs semaine retournées pour une date donnée :

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

BirtDateTime.firstDayOfYear

Cette fonction renvoie la date du premier jour de l'année à laquelle la date d'entrée appartient.

Syntaxe

Date BirtDateTime.firstDayOfYear( Date date)

Paramètres

date

Objet date d'obtention de l'année.

Renvoie

Objet Date. Premier jour de l'année pour une date donnée.

Exemples

L'exemple suivant montre les valeurs année retournées pour une date donnée :

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

BirtDateTime.month

Cette fonction retourne le mois d'une date. Selon l'option que vous spécifiez, cette fonction retourne le mois sous la forme d'un nombre, le nom complet du mois ou le nom abrégé du mois. Le nom du mois est propre à l'environnement local.

Syntaxe

string BirtDateTime.month( Date date, integer option )

Paramètres

date

Objet date d'obtention du mois.

option

Entier. Facultatif. Nombre qui représente le format de mois à retourner. Utilisez l'une des valeurs suivantes :

*
*
*

Si vous ne définissez pas cet argument, la fonction retourne le mois sous la forme d'un nombre.

Renvoie

Chaîne. Mois pour une date donnée.

Exemples

L'exemple suivant montre les valeurs mois retournées pour une date données :

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

L'exemple suivant retourne le mois de la date en cours :

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Cette fonction retourne la date et l'heure en cours, par exemple Feb 2, 2009 2:05 PM.

Syntaxe

Date BirtDateTime.now( )

Renvoie

Objet Date. Date et heure actuelles.

Exemple

L'exemple suivant retourne le nombre d'heures entre la date et l'heure actuelles et Noël :

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

BirtDateTime.quarter

Cette fonction retourne un nombre compris entre 1 et 4 qui correspond au trimestre auquel appartient une date. Le premier trimestre commence le 1er janvier.

Syntaxe

integer BirtDateTime.quarter( Date date )

Paramètre

date

Objet date d'obtention du trimestre.

Renvoie

Entier. Nombre de trimestres pour une date donnée.

Exemples

L'exemple suivant indique le nombre de trimestres retourné pour des dates spécifiques :

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

L'exemple suivant retourne le numéro du trimestre de chaque valeur dans la zone CloseDate :

BirtDateTime.quarter( row["CloseDate"] )

L'exemple suivant retourne le numéro du trimestre de la date en cours :

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Cette fonction retourne la date en cours qui inclut la valeur temps minuit, par exemple, Feb 2, 2009 12:00 AM.

Syntaxe

Date BirtDateTime.today( )

Renvoie

Objet Date. Date en cours avec la valeur temps minuit.

Exemples

L'exemple suivant renvoie le nombre de jours entre la date en cours et Noël :

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

L'exemple suivant calcule le nombre d'années entre la valeur figurant dans la zone de données HireDate et la date en cours.

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

BirtDateTime.week

Cette fonction retourne un nombre compris entre 1 et 52 qui correspond au numéro de la semaine d'une date.

Syntaxe

integer BirtDateTime.week( date )

Paramètre

date

Objet date d'obtention du numéro de semaine.

Renvoie

Entier. Numéro de la semaine pour une date données.

Exemples

L'exemple suivant indique le nombre de semaines retourné pour des dates spécifiques :

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

L'exemple suivant retourne le numéro de la semaine pour chaque valeur dans la zone CloseDate :

BirtDateTime.week( row["CloseDate"] )

L'exemple suivant retourne le numéro de semaine de la date en cours :

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Cette fonction retourne le jour de la semaine d'une date. Selon l'option que vous spécifiez, cette fonction retourne le jour de la semaine sous la forme d'un nombre, le nom complet du jour ou le nom abrégé du jour. Le nom du jour de la semaine est propre à l'environnement local.

Syntaxe

string BirtDateTime.weekDay( Date date, integer option )

Paramètres

date

Objet date d'obtention du jour de la semaine.

option

Entier. Facultatif. Nombre qui représente le format à retourner. Utilisez l'une des valeurs suivantes :

*
*
*
*
*

Si vous ne définissez pas cet argument, la fonction utilise l'option 1 par défaut.

Renvoie

Chaîne. Jour de la semaine pour une date donnée.

Exemples

L'exemple suivant indique les valeurs jour de semaine retournées pour une date donnée :

BirtDateTime.weekDay( "2009-02-02" ) // retourne 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // retourne 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // retourne lundi

L'exemple suivant retourne le jour de la semaine de la date en cours :

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Cette fonction retourne la valeur année à quatre chiffres d'une date. Par exemple, si la date est 19 janvier 2009, la fonction retourne 2009.

Syntaxe

integer BirtDateTime.year( date )

Paramètre

date

Objet date d'obtention de l'année.

Renvoie

Entier. Valeur d'année à quatre chiffres pour une date donnée.

Exemples

L'exemple suivant retourne l'année de chaque valeur dans la zone HireDate :

BirtDateTime.year( row["HireDate"] )

L'exemple suivant retourne l'année de la date en cours :

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013