-
Notifications
You must be signed in to change notification settings - Fork 0
/
Composants OpenOffice Milesian.html
656 lines (651 loc) · 39.3 KB
/
Composants OpenOffice Milesian.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1252"/>
<title></title>
<meta name="generator" content="LibreOffice 7.0.3.1 (Windows)"/>
<meta name="author" content="Louis-Aimé de Fouquières"/>
<meta name="created" content="2018-01-29T23:12:43.662000000"/>
<meta name="changed" content="2021-01-12T21:20:46.820000000"/>
<style type="text/css">
@page { size: 21cm 29.7cm; margin: 2cm }
p { margin-top: 0.25cm; margin-bottom: 0cm; line-height: 120%; orphans: 2; widows: 2; background: transparent }
h1 { margin-bottom: 0.21cm; orphans: 2; widows: 2; background: transparent; page-break-after: avoid }
h1.western { font-family: "Liberation Serif", serif; font-size: 24pt; font-weight: bold }
h1.cjk { font-family: "SimSun"; font-size: 24pt; font-weight: bold }
h1.ctl { font-family: "Lucida Sans"; font-size: 24pt; font-weight: bold }
h2 { margin-top: 0.35cm; margin-bottom: 0.21cm; orphans: 2; widows: 2; background: transparent; page-break-after: avoid }
h2.western { font-family: "Liberation Serif", serif; font-size: 18pt; font-weight: bold }
h2.cjk { font-family: "SimSun"; font-size: 18pt; font-weight: bold }
h2.ctl { font-family: "Lucida Sans"; font-size: 18pt; font-weight: bold }
h3 { margin-top: 0.25cm; margin-bottom: 0.21cm; orphans: 2; widows: 2; background: transparent; page-break-after: avoid }
h3.western { font-family: "Liberation Sans", sans-serif; font-size: 14pt; font-weight: bold }
h3.cjk { font-family: "Microsoft YaHei"; font-size: 14pt; font-weight: bold }
h3.ctl { font-family: "Lucida Sans"; font-size: 14pt; font-weight: bold }
a:link { color: #000080; so-language: zxx; text-decoration: underline }
a:visited { color: #800000; so-language: zxx; text-decoration: underline }
</style>
</head>
<body lang="fr-FR" link="#000080" vlink="#800000" dir="ltr"><p align="center" style="margin-top: 0cm; line-height: 100%; page-break-after: avoid">
<font face="Liberation Sans, sans-serif"><font size="6" style="font-size: 28pt"><b>Composants
OpenOffice Milesian et OpenOffice Milesian Premium</b></font></font></p>
<h1 class="western"> Identification</h1>
<h2 class="western">Fonctions</h2>
<p>Fonctions de calculs calendaires en langage Basic pour LibreOffice
Calc et équivalents Open Office.
</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Toutes
fonctions calendaires de base pour la gestion du <font color="#000080"><span lang="zxx"><u><span lang="fr-FR">calendrier
milésien</span></u></span></font> compatible avec la gestion
des dates Open Office.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Jour
de semaine avec une option supplémentaire.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Calcul
de phases de lune moyenne.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">(Premium)
analyse d’une chaîne de caractères représentant
une date milésienne ou grégorienne et conversion en
objet de date Excel.</font></font></p>
</ul>
<h2 class="western"> Environnement et codage</h2>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Version
présente M2021-01-22.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Code
source et leurs commentaires rédigés en anglais.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Auteur :
Louis-Aimé de Fouquières, Miletus SARL 2017-2021
(www.calendriermilesien.org).</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Testé
sur LibreOffice <font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt"><span lang="fr-FR">7</span></font></font>.0
français sous Windows 10.</font></font></p>
<li><p style="margin-top: 0cm; line-height: 100%">Pas de certificat
(Libre Office ne permet plus de signer un document).</p>
</ul>
<h2 class="western">Versions</h2>
<p>M2021-01-22</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">MILESIAN_DISPLAY
affiche par défaut : </font></font>
</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">la
date seule, si l’heure associée et 0 h</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">la
date et l’heure, si l’heure associée à la
date n’est pas 0 h</font></font></p>
</ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Le
2<sup>e</sup> paramètre, facultatif, associé à
MILESIAN_DISPLAY permet de ne jamais imprimer l’heure si le
paramètre vaut 0, ou de l’imprimer toujours si le
paramètre est différent de 0.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Désormais,
MILESIAN_YEAR_BASE désigne la veille du premier de l’an
milésien à 0 h (et non à 7 h 30). L’objectif
est de séparer totalement la gestion des jours et celle des
heures.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Les
fonctions GREGORIAN_EPACT et MILESIAN_EPACT sont ajoutées.</font></font></p>
</ul>
<p>M2020-02-08</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Plus
d’information sur le fichier de description et d’aide.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Correction
du fichier de démonstration <i>Jours remarquables, </i><span style="font-style: normal">certaines
fêtes étant mal restituées.</span></font></font></p>
<li><p align="left" style="margin-top: 0cm; font-style: normal; line-height: 100%">
<font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Aucune
modification des fonctions depuis M2019-06-30</font></font></p>
</ul>
<p>M2019-06-30</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Résultat
de YEAR_BASE est date précédant 1 1m à 7:30
UTC.</font></font></p>
</ul>
<p>M2019-01 et antérieures</p>
<ul>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Calendrier
milésien avec intercalation solaire selon règles
grégoriennes.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Années
affichées avec 3 chiffres au moins.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Gestion
d’erreur.</font></font></p>
<li><p align="left" style="margin-top: 0cm; line-height: 100%"><font face="Liberation Serif, serif"><font size="3" style="font-size: 12pt">Contrôle
de plage de valeurs compatible avec la gestion Calc de base.</font></font></p>
</ul>
<h2 class="western">Licence</h2>
<p>Pour la version de base :</p>
<p style="text-indent: 1.25cm">Libre utilisation et transmission sans
coût, sous réserve de citation de l’auteur.</p>
<p>Pour la version Premium :</p>
<p style="text-indent: 1.25cm">Transformations et adaptations
soumises à autorisation expresse de l'auteur.</p>
<p style="text-indent: 1.25cm">Usage en équipe (10 personnes)
autorisé. Au-dessus : consulter
www.calendriermilesien.org.</p>
<p style="text-indent: 1.25cm">Ni diffusion ni revente.</p>
<p>Aucune garantie de conformité à des objectifs
commerciaux ou autres.</p>
<p>Signalement d’erreurs et réclamations : contact
sur <a href="http://www.calendriermilesien.org/">www.calendriermilesien.org</a>
</p>
<p> </p>
<h1 class="western">Mise en service</h1>
<h2 class="western">Avertissements liminaires</h2>
<h3 class="western">Recul fonctionnel de la gestion des bibliothèques
de macros
</h3>
<p>La gestion des <i>bibliothèques de </i><i>macros</i> et des
<i>extensions</i> souffre de reculs fonctionnels observés
apparemment depuis la version 6, certains depuis la version 6.0.6.2
sous Windows 10 (observations du 8m 2018), et confirmés sur la
version 7.0 (janvier 2021). Il semble que les seuls modules
utilisables d’une bibliothèque de macros ou de fonctions
sont ceux insérés dans la bibliothèque <i>Standard</i><span style="font-style: normal">
associée à un document ou à l’instance
Libre Office. Les modules des autres bibliothèques paraissent
inconnus ou inaccessibles. </span>
</p>
<p><span style="font-style: normal">C</span>eci nous conduit à
ne proposer ni création d’extensions, ni sauvegarde de
bibliothèque de fonctions. Nous invitons les utilisateurs
vigilants à nous informer dès que les modules de
fonctions ou macros pourront rester fonctionnels sans être
nécessairement groupés dans la bibliothèque
« Standard » d’un fichier ou d’une
instance Open Office.</p>
<h3 class="western">Sécurité des macros</h3>
<p>La sécurité des macros d’Open Office est par
défaut fixée au niveau <i>élevé</i>.
Seules les macros et fonctions <i>signées</i><span style="font-style: normal">
peuvent être autorisées, sous réserve d’avoir
accordé confiance au signataire de ces macros. </span><span style="font-style: normal">Mais
comme par ailleurs il n’est plus possible de signer un
document, la seule solution est d’abaisser le niveau de
sécurité des macros à </span><i>Moyen </i><span style="font-style: normal">et
d’autoriser les macros.</span><span style="font-style: normal"><br/>
</span><span style="font-style: normal">Il
vous est toujours possible de vérifier le contenu des
fonctions et macros avant d’accorder votre confiance.</span></p>
<h2 class="western">Installation des fonctions</h2>
<h3 class="western">Insertion du modèle de feuille de calcul</h3>
<p>Le fichier <i>Milesian.ots</i> ou <i><span style="text-decoration: none">Milesian
Premium.ots</span></i> fourni est un modèle de feuille de
calcul LibreOffice. Vous pouvez le copier dans votre répertoire
de modèles, ou l’ouvrir et l’enregistrer en tant
que modèle de feuille de calcul.
</p>
<p>Créez une nouvelle feuille de calcul sur la base de ce
modèle : cette nouvelle feuille comprend des fonctions
supplémentaires de calcul calendaire décrites infra.
Dans les versions antérieures à 7, <i>Vous dev</i><i>i</i><i>ez
signer les macros de cette feuille pour pouvoir les utiliser.</i></p>
<h3 class="western">Insertion en tant que fonctions de référence</h3>
<p>Ouvrez la feuille <i>Milesian</i> ou<i> Milesian Premium, </i><span style="font-style: normal">ouvrez</span>
le gestionnaire de macros (<i>Outils / Macros / Gérer les
macros / LibreOffice Basic) </i><span style="font-style: normal">puis
encore </span><i>Gérer.</i><span style="font-style: normal">
Vous pouvez alors cliquer-déplacer les modules contenus dans
la feuille vers la bibliothèque </span><i>Standard </i><span style="font-style: normal">de
</span><i>Mes macros.</i><span style="font-style: normal"> Les
fonctions seront alors disponibles avec toute feuille que vous
ouvrirez. En revanche, les personnes prenant connaissance de vos
fichiers </span><i>Calc</i><span style="font-style: normal"> ne
verront que les résultats des derniers calculs. </span><span style="font-style: normal">Les
calculs résultant</span><span style="font-style: normal">
</span><span style="font-style: normal">d’</span><span style="font-style: normal">appels
en cascade </span><span style="font-style: normal">pourront ne pas
être restitués</span><span style="font-style: normal">. </span>
</p>
<h3 class="western">Gestion en bibliothèques de modules</h3>
<p>On peut en principe importer et exporter les bibliothèques
de modules. Malheureusement, la gestion des bibliothèques ne
fonctionne plus depuis la version 6 de LibreOffice.</p>
<h3 class="western">Gestion par le biais d’extensions</h3>
<p>De même, les extensions de fonctions utilisateurs ne
marchent plus depuis la version 6 de LibreOffice.</p>
<h1 class="western">Utilisation</h1>
<p>Vous pouvez désormais</p>
<p style="margin-left: 1.89cm; text-indent: -0.64cm">1.Créez
un fichier sur la base du modèle, pour avoir une feuille
disposant de manière autonome de la bibliothèque
<i>Standard</i> du fichier. Il faudra signer les macros pour en
autoriser l’usage.</p>
<p style="margin-left: 1.89cm; text-indent: -0.64cm">2. Copiez les
modules dans la bibliothèque <i>Standard </i>dans vos macros,
pour en disposer en permanence.</p>
<p>Malheureusement, les fonctions n’apparaissent pas dans la
liste « Assistant Fonctions » à côté
de la barre de saisie. Il faut donc bien connaître leurs noms
et leur liste de paramètres.</p>
<p>Vous pouvez vérifier que vous avez bien installé les
fonctions dans la bibliothèque <i>Standard </i><span style="font-style: normal">en
ouvrant le fichier </span><i>Jours remarquables</i><span style="font-style: normal">.
La modification de l’année, suivi d’un déplacement
du volet du bas avec retour en haut de la liste, doit modifier toutes
les indications et toutes les dates.</span></p>
<h1 class="western">Architecture des modules</h1>
<p>
<b>MilesianCalendar</b> :
</p>
<p><font color="#000000"> </font>
Lire une date Calc, l'afficher et la décomposer en milésien,
</p>
<p>
Créer une date à partir des coordonnées jour,
mois, année en milésien,</p>
<p>
Rechercher une date plusieurs mois milésiens avant ou après,
ou une fin de mois milésien,</p>
<p>
Calculer le jour julien à partir du jour Calc et
réciproquement.</p>
<p>
Jour de semaine « étendue », avec un
type 0 par défaut, résultat 0 à 6, dimanche=0 ;
Les autres types utilisés par Calc pour JOURSEM sont
disponibles.</p>
<p> Calcul
de l’épacte (âge de la lune) selon le comput
grégorien.</p>
<p>
<b>MeanMoon</b> : Date de la plus proche phase de lune moyenne
avant ou après une date donnée.</p>
<p>
<b>DateParse</b> (Premium seulement) : déchiffrer une
expression de date standard ou milésienne et la transformer en
nombre de type Date.</p>
<p>
</p>
<p>Le module MeanMoon peut être utilisé seul
éventuellement. DateParse a besoin de MilesianCalendar.</p>
<h1 class="western">Limites et précautions d'utilisation</h1>
<ol>
<li><p>L'objet Date est un nombre qui représente une date
(partie entière) et une heure (partie fractionnaire). La
valeur 0 correspond au 30/12/1899 à 0h UTC.</p>
<li><p>Calc permet de gérer tout objet date sans contrôle
de borne. Nous avons prévu de limiter le domaine de validité
des fonctions aux dates pour lesquelles la représentation
Calc et les fonctions de restitutions sont correctes, ce qui
correspond aux années 32767 av. J.C. à 32767 de notre
ère.
</p>
<li><p>Une expression de date avec une année positive sur 2
caractères est convertie par Calc avec une année entre
1930 et 2029.</p>
<li><p>Les expressions de dates antérieures au 01/01/0001
(calendrier julien) sont représentées par Calc avec
une année en notation rétrograde, c’est-à-dire
sans année 0. La veille du 01/01/0001 est représentée
par 31/12/-0001. En revanche, les fonctions milésiennes
considèrent toujours les années en notation relative,
avec une année 0. La notation Calc est impropre : les
historiens, qui utilisent la notation rétrograde, précisent
« avant J.-C. » et n’utilisent pas de
signe « - » pour les années antérieures
à 1.
</p>
<li><p>La fonction DATE_PARSE (Premium) permet de saisir des dates
du calendrier julio-grégorien ou milésien, même
avant l’ère commune. Mais les années sont notées
en relatif : avec une année 0 et un signe « -
» avant pour les années antérieures à
l’année 0. Voir détail infra, à la
fonction DATE_PARSE. De plus, les années non négatives
doivent être présentées sur 3 chiffres, à
peine de rejet.</p>
<li><p>En Libre Office, la saisie et l’affichage des dates se
réfèrent au calendrier grégorien à
partir du 15/10/1582, au calendrier julien antérieurement.
Les expressions du 5 au 14/10/1582 provoquent une erreur.</p>
<li><p>Les fonctions standard ANNEE, MOIS, JOUR, appliquées à
une date restituent selon le calendrier grégorien
proleptique, et non pas julien. L’année est en notation
rétrograde, sans année 0 mais avec un signe « - »
pour les années antérieures à 1 A.D.</p>
<li><p>La fonction DAYOFWEEK_Ext fournie donne le rang du jour de
semaine avec une option supplémentaire non fournie ni par
Microsoft ni par LibreOffice</p>
</ol>
<ul>
<ul>
<li><p>par défaut : (0=dimanche jusque 6=samedi)
</p>
<li><p>- sinon vous pouvez utiliser les mêmes types que ceux
proposés par la fonction standard JOURSEM et obtenir les
mêmes résultats.</p>
</ul>
</ul>
<ol start="9">
<li><p>La fonction MILESIAN_DISPLAY affiche l’année
avec au moins 3 chiffres, ce qui évite toute ambiguïté
de l’élément année avec le quantième.
Cette fonction restitue un résultat même pour les dates
situées au-delà des années -32767 à
+32767.</p>
</ol>
<h1 class="western">Conseils généraux pour des travaux
impliquant de nombreuses dates.</h1>
<p> </p>
<h2 class="western">1. La gestion de l’objet Date.</h2>
<p>L’objet Date ne pose pas de limite haute ou basse.
</p>
<p>Par précaution, nos fonctions ne produisent que des dates
situées dans la plage d’année -32767 à
+32767.</p>
<p><br/>
</p>
<h2 class="western">2. Type de résultat</h2>
<p>Les résultats des fonctions de ces modules ne peuvent pas
être typées Date en raison notamment de la faiblesse de
la gestion d’erreurs de Basic : en cas d’erreur ou
de sortie du domaine de validité, il faut pouvoir informer
l’utilisateur par une chaîne appropriée.</p>
<p>Le plus souvent il faut formater explicitement le résultat
avec un des formats de date. Nous recommandons un format de date avec
année sur 4 chiffres.</p>
<h1 class="western">Les fonctions utilisables et leurs paramètres,
par module :</h1>
<p> </p>
<h2 class="western">#MilesianCalendar</h2>
<p> </p>
<p>DAYOFWEEK_Ext : Entier, 0 à 6 ou 1 à 7,
représentant le jour de semaine.</p>
<p>Cette fonction donne un résultat pour toute valeur de
l'objet Date, y compris avant l’ère commune.</p>
<p>
Paramètres :
</p>
<p>
TheDate, date dont on cherche le jour de semaine.</p>
<p>
DispType, option de représentation :</p>
<p>
0 ou défaut : 0 à 6, 0 pour dimanche (option la
plus simple, recommandée par les mathématiciens)</p>
<p>
1, correspondant à l’option par défaut de Calc
(et d’Excel) : 1 à 7, 1 pour dimanche</p>
<p>
2 : 1 à 7, 1 pour lundi (comme Calc/Excel)</p>
<p>
3 : 0 à 6, 0 pour lundi (comme Calc/Excel)</p>
<p>
11 à 17 : 1 à 7, 11 : 1 pour lundi, 12 :
1 pour mardi, etc. (comme Calc/Excel)</p>
<p> </p>
<p>JULIAN_EPOCH_COUNT : Nombre, jour julien avec partie décimale
correspondant à la date.</p>
<p>
Paramètre : TheDate, date et heure dont on cherche le
jour julien. Rappel : une valeur entière du jour julien
correspond à midi UTC.</p>
<p> </p>
<p>JULIAN_EPOCH_DATE : Objet Date, correspondant au jour julien
donné en paramètre.</p>
<p>
Paramètre : Julian_Count, le jour julien, nombre décimal
correspond à une date et une heure.</p>
<p> </p>
<p>GREGORIAN_EPACT : Nombre entier entre 0 et 29, épacte
grégorienne de l’année. Le calcul, simple
application des règles du comput grégorien, est
effectué pour n’importe quelle valeur de l’année.
Il n’est valable que pour les années strictement
supérieures à 1582.</p>
<p>
Paramètre : Year, l’année pour ce calcul.
</p>
<p><br/>
</p>
<p>MILESIAN_EPACT : Comme GREGORIAN_EPACT, mais le résultat
correspond à la veille du nouvel an de l’année
milésienne. Cette valeur est inférieure de 11 modulo 30
à celle de l’épacte grégorienne.</p>
<p>
Paramètre : Year, l’année pour ce calcul.
</p>
<p><br/>
</p>
<p>MILESIAN_IS_LONG_YEAR : Booléen, indique si l'année
milésienne est abondante. Une année milésienne
abondante est une année qui précède une année
bissextile. La même règle d'intercalation solaire que
pour le calendrier grégorien est appliquée ici.
</p>
<p>
Paramètre : Year, année dont on cherche à
déterminer le type</p>
<p> </p>
<p>MILESIAN_DATE : Objet Date correspondant à une date
milésienne dont les composants sont donnés en
paramètres.
</p>
<p>La date est entière, l'heure est 00h.</p>
<p>
Paramètres :
</p>
<p>
Year : Année milésienne (positive ou négative,
comptée en relatif, avec une année 0)
</p>
<p>
Month : numéro du mois (1 à 12)
</p>
<p>
DayInMonth : Quantième dans le mois (1-31)</p>
<p>
Si le triplet ne correspond pas à une date valide, la fonction
retourne une erreur.</p>
<p> </p>
<p>MILESIAN_YEAR_BASE : Objet Date correspondant à la
base d'une année milésienne c'est à dire le jour
précédent le 1 1m de l'année à <b>0 h </b><span style="font-weight: normal">(et
non plus à 7 h 30 des versions précédentes)</span>.</p>
<p>Permet notamment de chercher le clavedi ou dies illa, jour de
semaine de ce jour, et jour de semaine des jours pivots ; permet
aussi de construire facilement le quantième d’année.</p>
<p>
Paramètres : Year : l'année dont on cherche
la base.</p>
<p>
</p>
<p>MILESIAN_YEAR : Année milésienne d'un objet
Date
</p>
<p>
Paramètres : TheDate : objet Date, qui peut être
une date et heure : seule la date est considérée.
L'année est restituée en notation relative :
nombre positif, nul ou négatif.</p>
<p> </p>
<p>MILESIAN_MONTH : Numéro de mois milésien d'un
objet Date (1 à 12)</p>
<p>
Paramètres : TheDate : objet Date, qui peut être
une date et heure : seule la date est considérée</p>
<p> </p>
<p>MILESIAN_DAY : Quantième dans le mois milésien
d'un objet Date (1-31)</p>
<p>
Paramètres : TheDate : objet Date, qui peut être
une date et heure : seule la date est considérée</p>
<p> </p>
<p>MILESIAN_DISPLAY : Une chaîne de caractères
exprimant la date milésienne d'un objet Date</p>
<p>
Paramètres :
</p>
<p>
TheDate : objet Date, qui peut être une date et heure.</p>
<p>
Wtime (optionnel) : Si différent de 0, l'heure (partie
décimale de la date) est également affichée ;
si 0, l’heure n’est pas affichée. Si absent,
l’heure n’est affichée que pour un argument non
entier, donc si l’heure est différente de 0 h.</p>
<p> Dans l’expression de date, l’année est
toujours représentée avec au minimum trois chiffres.</p>
<p>MILESIAN_MONTH_SHIFT : Date de même quantième, n
mois milésiens avant ou après une date donnée.</p>
<p>Même fonctionnement que MOIS.DECALER : le quantième
31 peut devenir 30 si le mois cible n'a que 30 jours.</p>
<p>
Paramètres :</p>
<p>
TheDate : date de départ</p>
<p>
MonthShift : nombre de mois de décalage vers le futur (+)
ou le passé (-)</p>
<p> </p>
<p>MILESIAN_MONTH_END : Date de fin de mois milésien, n
mois milésiens avant ou après une date donnée.
</p>
<p>Même fonctionnement que la fonction FIN.MOIS, (qui cherche
une fin de mois grégorien)</p>
<p>
Paramètres :</p>
<p>
TheDate : date de départ</p>
<p>
MonthShift : nombre de mois de décalage vers le futur (+)
ou le passé (-)</p>
<p> </p>
<p><br/>
</p>
<h2 class="western">#MeanMoonPhase</h2>
<p> </p>
<p>Calcul de dernière ou de prochaine phase de lune. Marge
d'erreur de 6 heures pour +/- 3000 ans à partir de l'an 2000.</p>
<p> </p>
<p>MOON_PHASE_LAST : La date de la dernière nouvelle
lune, ou de la dernière phase lunaire spécifiée.</p>
<p>
L'horodatage est en heure TT, très proche de l'heure UTC à
nos époques.</p>
<p>
Le calcul est fondé sur une lune moyenne linéaire (non
corrigée). La nouvelle lune moyenne de référence
est la première lune moyenne de l'an 2000.</p>
<p>
Paramètres :
</p>
<p>
FromDate : jour auquel on se réfère ;
</p>
<p>
MoonPhase (=0 si non présent) : 0=nouvelle lune,
1=premier quartier, 2=pleine lune, 3=dernier quartier, erreur pour
toute autre valeur.</p>
<p> </p>
<p>MOON_PHASE_NEXT : Le date de la prochaine nouvelle lune, ou
de la prochaine phase lunaire spécifiée.</p>
<p>
L'horodatage est en heure TT, très proche de l'heure UTC à
nos époques.</p>
<p>
Le calcul est fondé sur une lune moyenne linéaire (non
corrigée). La nouvelle lune moyenne de référence
est la première lune moyenne de l'an 2000.</p>
<p>
Paramètres :
</p>
<p>
FromDate : jour auquel on se réfère ;
</p>
<p>
MoonPhase (=0 si non présent) : 0=nouvelle lune,
1=premier quartier, 2=pleine lune, 3=dernier quartier, erreur pour
toute autre valeur.</p>
<p>
</p>
<h2 class="western">#DateParse</h2>
<p> </p>
<p>Analyseur d'expression de date, spécifique de la version
Premium.</p>
<p>Ce module ne comprend qu'une seule fonction. Il nécessite
le module MilesianCalendar.</p>
<p>L'écriture en Basic est probablement peu adaptée à
des données en très grande masse. Toutefois,
l’utilisation de DATE_PARSE sur une base de 10 000
entrées, avec un argument lui-même résultat d’un
calcul avec quatre fonctions de base, et en relation avec
MILESIAN_DISPLAY, ne prend que 20 secondes (sur HP Spectre Windows
10).</p>
<p> </p>
<p>DATE_PARSE : Transforme une chaîne de caractères
bien formée en objet Date.</p>
<p>
Paramètres : MyCell, chaîne de caractères
</p>
<p>La chaîne peut comprendre une date et une heure. L'heure est
selon le canevas h :m ou h:m:s, et est séparée de
la date par un ou plusieurs espaces.</p>
<p>La date peut être julio-grégorienne, mais aussi
milésienne. Elle est considérée comme
milésienne :</p>
<p>- soit si elle commence par M, exemple : M2015-07-01, et dans
ce cas l'ordre est année, mois, jour (optionnel),<br/>
- soit
si elle contient un mois milésien en notation internationale,
par exemple 1/1m/2000 ou 30 12m 2016, mais pas 15/01m/1950, car 01m
n'est pas un mois milésien.</p>
<p>Une notation redondante comme M2015-7m-01 est rejetée.</p>
<p>Les séparateurs entre éléments de date sont
soit l'espace, soit "/", ".", ou "-".
Le même séparateur doit être utilisé.</p>
<p>Il peut y avoir plusieurs espaces là où un seul est
nécessaire.</p>
<p>Une éventuelle virgule est ignorée. Mais non pas un
point collé au quantième à la manière
allemande ou scandinave, qui provoquera une erreur.</p>
<p>L'année est toujours codée avec au moins trois
caractères, et peut comprendre un signe moins. C'est ainsi
qu'on la reconnaît.</p>
<p>Même pour une expression de date julio-grégorienne,
l’année est réputée représentée
en <i>notation relative</i> : l’échelle des années
comprend une année 0 précédée d'années
négatives. Attention, depuis la version 6 de Calc, la
représentation de dates antérieures au 1/1/0001 est
possible, mais les années sont en <i>notation rétrograde</i>
utilisant – à tort – le signe « - ».
L’année 0 n’existe pas, le jour précédant
le 1/1/0001 est représenté en 31/12/-0001, qui
correspond au 31 décembre 1 av. J.-C. des historiens,
31/12/0000 en notation relative. DATE_PARSE est pertinent pour les
expressions de dates astronomiques.
</p>
<p>Il faut spécifier au moins deux éléments de
dates, dont le mois.</p>
<p>Si l'année n'est pas spécifiée (pas d'élément
de plus de deux caractères), l'année courante du
calendrier en cours est choisie ; par exemple, si nous sommes le
31/12/2015 (10 1m 2016), la chaîne 21/03 donnera 21/03/2015,
alors que la chaîne 30/4m donnera 30/4m/2016.</p>
<p>Si le quantième du mois (jour du mois) n'est pas spécifié,
le quantième 1 est choisi.</p>
<p> </p>
<h1 class="western">Exemples</h1>
<p>Le fichier « Jours remarquables » du
répertoire téléchargé comprend des
exemples de calculs n’utilisant pas la fonction DATE_PARSE,
mais utilisant les autres fonctions.</p>
<p> </p>
<h1 class="western">Informations, commentaires, propositions
d'amélioration, signalement d'erreurs :</h1>
<p>www.calendriermilesien.org</p>
<p>[email protected]</p>
<p style="margin-top: 0cm; line-height: 100%"><br/>
</p>
<div title="footer"><p align="center" style="margin-top: 0.5cm; line-height: 100%">
<span style="background: #c0c0c0"><sdfield type=PAGE subtype=RANDOM format=PAGE>11</sdfield></span></p>
</div>
</body>
</html>