Certum monstrat diem

 

Horloge milésienne
CERTUM MONSTRAT DIEM am

Aide fonctions des tableurs

La présente page décrit les fonctions supplémentaires destinées aux tableurs. Elle peut servir de page d'aide aux utilisateurs de ces fonctions.


Installation


Les procédures d'installation sont spécifiques selon l'environnement d'accueil. Référez-vous à la documentation correspondante. Généralement vous pouvez configurer le module:

  • soit comme élément complémentaire, dans ce cas vous disposez des fonctions sur toutes vos feuilles , mais les autres personnes qui lisent vos feuilles n'ont pas les fonctions, et ne peuvent que lire les dernières valeurs;
  • soit comme module inséré dans la feuille de calcul; les fonctions sont disponibles pour toute personne qui lit la feuille, mais celle-ci doit être sauvegardé "avec macro" (sous Excel), et généralement un avertissement vous demande de confirmer l'usage des macros.


Les fonctions, communes aux différentes implémentations, sont décrites ci-après.


 DATE_Exceltype


Seulement pour MS Excel.

Fonction proposée à titre conservatoire. Convertit le résultat d'un calcul en date Excel affichable. En particulier, convertit correctement les calculs de dates effectués sur des feuilles utilisant comme origine le 1er janvier 1904.

  • Date (résultat de calcul) résultat de calcul à convertir.


DATE_PARSE


Fonction disponible uniquement avec la version Premium.

Valeur de type Date, affichable avec un format date, ou date et heure, correspondant à l'expression de date et d'heure donnée en argument.

  • Chaîne: chaîne de caractères réputée représenter une date grégorienne ou milésienne.


L'originalité de cette fonction, par rapport à DATEVAL, consiste en ce qu'elle peut indifféremment analyser une chaîne "classique" comme 15/07/1815, ou une chaîne milésienne comme 24 7m 1815 ou M1815-7-24. Toutefois, si l'heure existe, elle doit être séparée de la date par un espace.

Sous Excel, pour les dates inférieures à 1900, la fonction ajoute correctement l'heure à la date.

Sous LibreOffice Calc, la fonction manipule sans erreur les dates d'années 0 ou négatives.


DAYOFWEEK_Ext


Chiffre de 0 à 6 ou de 1 à 7 donnant le jour de la semaine. Extension de la fonction JOURSEM.

  • Date: la date dont on cherche le jour;
  • Type, optionnel, 0 par défaut: convention pour le résultat.

0 ou absent: 0=Dimanche, 1=Lundi etc.

Les autres options sont les mêmes que pour la fonction JOURSEM dans Excel, notamment 1, l'option par défaut de la fonction standard.


EASTER_SUNDAY


Uniquement sur MS Excel.

Date du dimanche de Pâques selon le comput grégorien, pour l'année donnée.

  • Année, nombre entier supérieur à 1582: l'année dont on cherche Pâques.


LibreOffice Calc propose une fonction donnant ce résultat.


JULIAN_EPOCH_COUNT


Numéro de jour julien décimal à partir d'un objet Date. La date donnée est réputée UTC. Sous Google Sheets, la date données est une date en heure locale, Google Sheets la traduit en date UTC d'une manière pas totalement contrôlée.
  • Date: la date à convertir.

JULIAN_EPOCH_DATE


Date (et heure) correspondant à un jour julien entier ou décimal. Réciproque de la fonction précédente.

  • Numéro: entier ou décimal correspondant au jour julien à décodée.. La date restituée est UTC (GMT si vous préférez).


MILESIAN_IS_LONG_YEAR


Valeur booléenne qui indique si l'année est abondante (366 jours) ou cave (365 jours). Rappel: une année milésienne abondante est une année précédent immédiatement une année bissextile selon les règles du calendrier grégorien (avec de rares exceptions, comme -801 et 2399).

  • Année: entier positif, négatif ou nul indiquant l'année à analyser.


MILESIAN_DATE


Date selon le format du tableur, que l'on peut formater pour la voir sous forme de date, à partir des éléments milésiens,

  • année milésienne
  • mois milésien
  • quantième milésien
L'année est en notation relative, donc 0 et des valeurs négatives sont possibles sauf avec Excel qui interdit les années antérieures à 100. L'heure est minuit.


MILESIAN_YEAR_BASE


Date précédent immédiatement le 1 1m de l'année donnée en argument. Pour les calcul du clavedi (jour de semaine clé) et de l'épacte milésienne.

  • Année: entier représentant l'année milésienne.

MILESIAN_YEAR, MILESIAN_MONTH, MILESIAN_DAY


Correspondent aux fonctions ANNEE, MOIS, JOUR. Appliquées à une date, elles donnent respectivement l'année, le mois et le jour selon le calendrier milésien. Elles donnent un résultat sur toute valeur interprétable en tant que date. Avec Excel, la limite inférieure est le 1er janvier 100 grégorien proleptique.

Paramètre unique:

  • Date: date du tableur à convertir.


Les variantes MILESIAN_UTCYEAR, MILESIAN_UTCMONTH et MILESIAN_UTCDAY sont disponibles avec Google Sheets, et donnent les coordonnées de la date UTC.


MILESIAN_DISPLAY


Chaîne de caractères correspondant à la date en notation milésienne jour mois année, avec éventuellement l'heure.

  • Date: date du tableur à convertir.
  • Option (Booléen sous Excel, nombre pour les autres, par défaut 0 ou FAUX). Si VRAI ou 1, l'heure est ajoutée à la chaîne.


Avec Google Sheet existe la variante MILESIAN_UTCDISPLAY qui donne la date et l'heure UTC, étant entendu que la date et heure de la feuille sont en heure locale. Toutefois l'interprétation de l'heure locale est problématique.


 TIMEZONE_OFFSET


Cette fonction n'est disponible qu'avec Google Sheets. Elle donne l'écart en minutes entre la date locale et la date UTC. Comme pour la fonction de Javascript, cet écart est négatif pour les fuseaux positifs (par exemple -60 pour UTC+1, fuseau de Paris en hiver), et réciproquement.


MILESIAN_TIME


A partir d'une date ou expression de date avec heure, donne la partie heure dans la journée.

  • Date (avec heure)


Cette fonction n'est pas particulièrement milésienne, elle permet d'extraire l'heure du jour de n'importe quelle date.


MILESIAN_MONTH_SHIFT


Date au même jour du mois, plusieurs mois avant ou après une date donnée.

  • Date de départ.
  • Nombre de mois, entier. Si positif, après la date donnée, si négatif, avant.


Si la date de départ est un 31, la date d'arrivée est si nécessaire convertie en 30. En revanche, si la date de départ est le dernier jour du mois tombant le 30, elle ne sera pas transformée en 31.


Une erreur peut être levée si la date finale est en dehors du domaine de définition des dates pour le tableur.


MILESIAN_MONTH_END

 

Date de fin de mois, plusieurs mois avant ou après une date donnée.

  • Date de départ.
  • Nombre de mois, entier. Si positif, après la date donnée, si négatif, avant.


La date d'arrivée est toujours la dernière du mois, 30 ou 31 selon le cas.


Une erreur peut être levée si la date finale est en dehors du domaine de définition des dates pour le tableur.


MOON_PHASE_LAST :


Date de la dernière phase de lune spécifiée.

  • Date à partir de laquelle on fait le calcul.
  • Phase cherchée:
    • 0 ou absent: nouvelle lune
    • 1: premier quartier
    • 2: pleine lune
    • 3: dernier quartier
    • Tout autre chiffre provoque une erreur.


La date et l'heure sont réputées UTC. Cette fonction n'est pas disponible sous Google Sheets, en raison de la gestion de l'heure locale.


MOON_PHASE_NEXT


Date de la prochaine phase de lune spécifiée.

  • Date à partir de laquelle on fait le calcul.
  • Phase cherchée:
    • 0 ou absent: nouvelle lune
    • 1: premier quartier
    • 2: pleine lune
    • 3: dernier quartier
    • Tout autre chiffre provoque une erreur.


La date et l'heure sont réputées UTC. Cette fonction n'est pas disponible sous Google Sheets, en raison de la gestion de l'heure locale.


Vous trouvez cela utile ? Faites-le faire savoir !