Fonctions Date

Ajouter/Soustraire un nombre de jours spécifié à une date

Renvoyer l'année et le jour Julien

Renvoyer le jour du mois

Renvoyer le mois

Renvoyer l'année

Renvoyer la date courante

Renvoyer le nombre de jours entre 2 dates

À propos des fonctions Date

Vous utilisez les fonctions Date pour convertir et manipuler des expressions de type Date :

  • ajouter/soustraire un nombre de jours spécifié à une date
  • renvoyer un entier représentant le jour de la semaine ou de l'année
  • renvoyer une partie spécifique d'une date
  • renvoyer la date de traitement ou la date courante du système d'exploitation
  • calculer le nombre de jours entre 2 dates

La syntaxe à utiliser dépend de la fonction que vous voulez activer.


$DATEPLUS et $DATEMINUS

Description

$DATEPLUS ajoute le nombre de jours spécifié à une date.

$DATEMINUS soustrait le nombre de jours spécifié d'une date.

La fonction renvoie une date. Le type de données du champ cible doit être :

  • Date
  • Numérique (La longueur doit être compatible avec une Date, c'est-à-dire N(6), N(7) ou N(8)).

Syntaxe

$DATEPLUS(date;nombre_de_jours)

$DATEMINUS(date;nombre_de_jours)

Valeur de retour

Date

Paramètres

Vous pouvez utiliser n'importe quelle expression qui renvoie une valeur sauf un appel aux fonctions DATEPLUS ou DATEMINUS.

Date
Spécifiez la valeur initiale de la date

Le type de données utilisé pour la date doit être l'un des suivants :

  • Date
  • Numérique (La longueur doit être compatible avec une Date, c'est-à-dire N(6), N(7) ou N(8)).

nombre_de_jours
Entrez un <Integer (Numérique, Signé ou Packé) qui spécifie le nombre de jours à ajouter ($DATEPLUS) ou soustraire ($DATEMINUS) de la date.

Vous pouvez utiliser n'importe quelle expression sauf un appel aux fonctions JULIAN ou CHECK.

Exemple

L'exemple suivant ajoute cinq jours à la date spécifiée.

$DATEPLUS(20000328; 5) renvoie 20000402

L'exemple suivant retranche cinq jours de la date spécifiée.

$DATEMINUS(20000328; 5) renvoie 20000323

$JULIAN

Description

$JULIAN renvoie l'année et le jour Julien d'une expression Date. (1 Janvier est égal à 1).

Syntaxe

$JULIAN(date)

Valeur de retour

Integer sur 5 chiffres si la longueur de la date est 6, 6 chiffres si la longueur de la date est 7, 7 chiffres si la longueur de la date est 8

Paramètres

Vous pouvez utiliser n'importe quelle expression qui renvoie une valeur.

date
Spécifiez la date pour laquelle vous souhaitez connaître le jour de l'année.

Le type de données utilisé pour la date doit être l'un des suivants :

  • Date
  • Numérique (La longueur doit être compatible avec une date, c'est-à-dire N(6), N(7) ou N(8)).

Exemple

L'exemple suivant utilise la fonction $JULIAN dans un garnissage pour calculer le jour de l'année d'une certaine date et le convertir en <Integer>. L'expression est écrite dans le champ cible.

NOTE : si le champ cible est numérique et défini sur une longueur de trois caractères, le résultat de la fonction est simplement le numéro du jour, sans la valeur de l'année.

Champ cible

Garnissage

OEFIELD1

$JULIAN(DATEIE1)

Si la valeur de DATEIE1 est 20030114, représentant le 14 Janvier 2003, OEFIELD1 contient 2003014 indiquant le 14ème jour de l'année 2003. De façon similaire, si la valeur de DATEIE1 est 20030714, OEFIELD1 contient 2003195.

$SYSDATE

Description

$SYSDATE renvoie la date courante et l'heure du système d'exploitation. Si vous avez valorisé le paramètre DATE_OPERATION dans le fichier script du Rule Engine AccountingIntegrator Enabler, la fonction renvoie cette date de traitement.

Le champ cible que vous définissez doit être du même type que la valeur fournie par la fonction $SYSDATE. Le type de données du champ cible doit être :

  • Date
  • Numérique (La longueur doit être compatible avec une date, c'est-à-dire N(6), N(7) ou N(8)).

Syntaxe

$SYSDATE()

Valeur de retour

Date (8 chiffres)

Paramètres

Aucune

Exemple

$SYSDATE() renvoie la date système courante.

$DAY

Description

$DAY renvoie le jour du mois, exprimé sous forme de 2 caractères numériques, à partir d'une expression de type date.

Syntaxe

$DAY(date)

Valeur de retour

Integer sur 2 chiffres

Paramètres

date

Spécifiez une Date

Le type de données utilisé pour la date doit être l'un des suivants :

  • Date
  • Numérique (La longueur doit être compatible avec une date, c'est-à-dire N(6), N(7) ou N(8)).

Seul un champ <Business-Document> ou un Pré-Calcul de longueur 6, 7 ou 8 est autorisé.

Le champ cible que vous définissez doit être compatible avec le type de données <Integer>.

Exemple

L'exemple suivant renvoie le jour à partir d'une expression date et heure.

$DAY(FIELD1) où FIELD1 =20040323, renvoie 23

$MONTH

Description

$MONTH renvoie le mois, exprimé sous forme de 2 caractères numériques, à partir d'une expression qui spécifie la date.

Syntaxe

$MONTH(date)

Valeur de retour

Integer sur 2 chiffres

Paramètres

date
Spécifiez une Date

Le type de données utilisé pour la date doit être l'un des suivants :

  • Date
  • Numérique (La longueur doit être compatible avec une date, c'est-à-dire N(6), N(7) ou N(8)).

Seul un champ <Business-Document> ou un Pré-Calcul de longueur 6, 7 ou 8 est autorisé.

Le champ cible que vous définissez doit être compatible avec le type de données <Integer>.

Exemple

L'exemple suivant renvoie le mois à partir d'une expression date et heure.

$MONTH(FIELD1) où FIELD1 =20040323, renvoie 03

$YEAR et $YEAR4

Description

$YEAR renvoie l'année, exprimée sous forme de 2 caractères numériques, à partir d'une expression de type Date.

$YEAR4 renvoie l'année, exprimée sous forme de 4 caractères numériques, à partir d'une expression de type Date.

Syntaxe

$YEAR(date)

$YEAR4(date)

Valeur de retour

Integer sur 2 chiffres si $YEAR ou 4 chiffres si $YEAR4

Paramètres

date
Spécifiez une Date

Pour la fonction $YEAR, le type de données utilisé pour date doit être:

  • Date
  • Numérique (La longueur doit être compatible avec une date, c'est-à-dire N(6), N(7) ou N(8)).

Pour la fonction $YEAR, seul un champ <Business-Document> ou un Pré-Calcul de longueur 6, 7 ou 8 est autorisé.

Pour la fonction $YEAR4, seul un champ <Business-Document> ou un Pré-Calcul de longueur 8 est autorisé.

Le champ cible que vous définissez doit être compatible avec le type de données <Integer>.

Exemple

L'exemple suivant renvoie l'année à partir d'une expression date et heure.

$YEAR(FIELD1) où FIELD1 =20040323, renvoie 04

$YEAR4(FIELD1) où FIELD1 =20040323, renvoie 2004

$NBDAYS

Description

$NBDAYS calcule la différence entre 2 dates (sans distinction de jours ouvrables/ouvrés ou non).

$NBDAYS renvoie une valeur numérique sur 5 caractères à partir d'une expression de type Date. Le champ cible recommandé est N(5).

Syntaxe

$NBDAYS(date_debut;date_fin)

Valeur de retour

Integer sur 5 chiffres

Paramètres

Vous pouvez utiliser n'importe quelle expression qui renvoie une valeur dont le type de données est Date, sauf un appel aux fonctions DATEPLUS ou DATEMINUS.

date_debut
Spécifiez une date de début

Le type de donnée utilisé pour la date_début doit être l'un des suivants :

  • Date

date_fin
Spécifiez une date de fin

Le type de données utilisé pour date_fin doit être :

  • Date

Exemple

L'exemple suivant calcule le nombre de jours entre la première et la seconde date.

$NBDAYS(20000328; 20000402) renvoie 5

Retour

Related Links