1c957fec2c772cb60d8066e1aef2de1a857189d7
[scilab.git] / scilab / modules / time / help / fr_FR / calendar.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA -
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2019 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19           xml:lang="fr" xml:id="calendar">
20     <refnamediv>
21         <refname>calendar</refname>
22         <refpurpose>Calendrier d'un mois dans une année choisis</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Séquence d'appel</title>
26         <synopsis>
27             calendar display;
28             calendar(y, m, "display");
29             c = calendar()
30             c = calendar(y,m)
31         </synopsis>
32     </refsynopsisdiv>
33     <refsection>
34         <title>Arguments</title>
35         <variablelist>
36             <varlistentry>
37                 <term>y</term>
38                 <listitem>
39                     <para>
40                         Nombre entier dans l'intervalle [1800, 3000] : l'année choisie,
41                         dans le calendrier grégorien.
42                     </para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>m</term>
47                 <listitem>
48                     <para>Nombre entier dans [1,12] : le mois.</para>
49                 </listitem>
50             </varlistentry>
51             <varlistentry>
52                 <term>c</term>
53                 <listitem>
54                     <para>liste, avec
55                         <table>
56                             <tr><th>c(1):</th><td>Intitulé du calendrier (texte unique)</td></tr>
57                             <tr><th>c(2):</th><td>Intitulés brefs des jours de la semaine (texte unique)</td></tr>
58                             <tr><th>c(3):</th><td>Matrice 6x7 des n° des jours dans le mois
59                                                  (0 pour les jours hors du mois)</td></tr>
60                         </table>
61                     </para>
62                     <para>
63                         Les intitulés sont traduits dans la langue de la session courante.
64                     </para>
65                 </listitem>
66             </varlistentry>
67         </variablelist>
68     </refsection>
69     <refsection>
70         <title>Description</title>
71         <para>
72             <emphasis role="bold">calendar display</emphasis>; affiche dans la console le
73             calendrier du mois en cours.
74             Les semaines commencent le lundi et se terminent le dimanche.
75         </para>
76         <para>
77             <emphasis role="bold">calendar(y,m,"display")</emphasis>; affiche dans la console
78             le calendrier du mois <varname>m</varname> pour l'année <varname>y</varname>.
79         </para>
80         <para>
81             c = calendar() fournit une liste contenant le calendrier pour le mois en cours.
82         </para>
83         <para>
84             c = calendar(y, m) fournit le calendrier pour le mois et l'année spécifiés.
85         </para>
86     </refsection>
87     <refsection>
88         <title>Exemples</title>
89         <programlisting role="example"><![CDATA[
90 calendar
91  ]]></programlisting>
92       <screen><![CDATA[
93 --> calendar
94  ans  =
95        ans(1)
96  Déc. 2019
97
98        ans(2)
99  Lun  Mar  Mer  Jeu  Ven  Sam  Dim
100
101        ans(3)
102    0.    0.    0.    0.    0.    0.    1.
103    2.    3.    4.    5.    6.    7.    8.
104    9.    10.   11.   12.   13.   14.   15.
105    16.   17.   18.   19.   20.   21.   22.
106    23.   24.   25.   26.   27.   28.   29.
107    30.   31.   0.    0.    0.    0.    0.
108 ]]></screen>
109         <para/>
110         <programlisting role="example"><![CDATA[
111 calendar display;
112  ]]></programlisting>
113       <screen><![CDATA[
114 --> calendar display;
115
116             Déc. 2019
117  Lun  Mar  Mer  Jeu  Ven  Sam  Dim
118                                 1
119   2    3    4    5    6    7    8
120   9   10   11   12   13   14   15
121  16   17   18   19   20   21   22
122  23   24   25   26   27   28   29
123  30   31                         
124 ]]></screen>
125         <para/>
126         <programlisting role="example"><![CDATA[
127 calendar(1973, 8, "display");
128  ]]></programlisting>
129       <screen><![CDATA[
130 --> calendar(1973, 8, "display");
131
132          Août 1973
133  Lun  Mar  Mer  Jeu  Ven  Sam  Dim
134             1    2    3    4    5
135   6    7    8    9   10   11   12
136  13   14   15   16   17   18   19
137  20   21   22   23   24   25   26
138  27   28   29   30   31          
139 ]]></screen>
140     </refsection>
141     <refsection role="see also">
142         <title>Voir aussi</title>
143         <simplelist type="inline">
144             <member>
145                 <link linkend="weekday">weekday</link>
146             </member>
147             <member>
148                 <link linkend="datevec">datevec</link>
149             </member>
150             <member>
151                 <link linkend="datenum">datenum</link>
152             </member>
153         </simplelist>
154     </refsection>
155     <refsection role="history">
156         <title>Historique</title>
157         <revhistory>
158             <revision>
159                 <revnumber>6.1</revnumber>
160                 <revdescription>
161                     Option "display" ajoutée.
162                 </revdescription>
163             </revision>
164         </revhistory>
165     </refsection>
166 </refentry>