DESCRIPTION.

La fonction FN_date$() retourne le nombre de jours entre une date donnée et le Jour Julien Modifié.

SYNTAXE.

kdate$ = FN_date$( mjd , format )

REMARQUES.

mjd doit être un nombre entier correspondant à un Jour Julien Modifié d'une date comprise entre le 01/01/0001 et le 31/12/9999.

format doit être une chaine de caractères indiquant dans quel format la date correspondante à mjd doit être retournée. format dans avoir la forme "jour semaine mois annee", où : 

- jour peut être : 

- d, pour que le jour du mois soit exprimé avec 1 ou 2 chiffres ;

- dd, pour que le jour du mois soit toujours exprimé avec 2 chiffres ;

- semaine peut être : 

- ddd, pour que le jour de la semaine soit exprimé en forme abrégée de 3 lettres, en anglais ;

- dddd, pour que le jour de  la semaine soit exprimé avec son nom complet, en anglais ;

- mois peut être : 

- M, pour que le mois soit exprimé avec 1 ou 2 chiffres ;

- MM, pour que le mois soit toujours exprimé avec 2 chiffres ;

- MMM, pour que le mois soit exprimé en forme abrégée de 3 lettres, en anglais ;

- MMMM, pour que le mois soit exprimé avec son nom complet, en anglais ;

- annee peut être : 

- y, pour que l'année soit exprimé avec 1 ou 2 chiffres ;

- yy, pour que l'année soit toujours exprimé avec 2 chiffres ;

- yyyy, pour que l'année soit toujours exprimé avec 4 chiffres.

La fonction FN_date$() retourne toujour une chaine de caractères.

Rappel : les fonction du module datelib.bbc prennent comme la date origine, ou le moment 0, le Jour Julien Modifié, ou MJD 0, qui est une variante du Jour Julien Astronomique, ou AJD, qui a été définie pour simplifier les calculs. La formule reliant les jours juliens modifiés et les jours juliens astronomiques est la simple translation : MJD = AJD - 2 400 000,5.  Cette formule a pour effet de déplacer la date origine au 17 novembre 1858 à 0 heure (17/11/1858 00:00:00).

Voir la fonction FN_dow() qui retourne le numéro du jour de la semaine d'un Jour Julien Modifié donné.

Voir la fonction FN_day() qui retourne le numéro du jour du mois d'un Jour Julien Modifié donné.

Voir la fonction FN_month() qui retourne le numéro du mois d'un Jour Julien Modifié donné.

Voir la fonction FN_year() qui retourne l'année d'un Jour Julien Modifié donné.

La fonction FN_date$ est importée depuis le module datelib.bbc. 

EXEMPLE.

INSTALL @lib$ + "datelib.bbc"

PRINT FN_date$( FN_today , "d ddd MM yyyy" )

PRINT FN_date$( FN_today , "dd dddd MMMM yy" )

PRINT FN_date$( FN_today , "dd ddd MMM yyyy" )

END