====== Les commandes cal et ncal ======

  * Objet : cal & ncal
  * Niveau requis : {{tag>débutant avisé}}
  * Commentaires : //La commande cal affiche un calendrier. //
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !]] :-)
  * Suivi : {{tag>à-compléter}}
    * Création par [[user>martinux_qc]] 2011
    * Testé par [[user>smolski]] le 16-07-2014
  * Commentaires sur le forum : [[http://debian-facile.org/viewtopic.php?id=9413 | Lien vers le forum concernant ce tuto]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))



===== Introduction =====

La commande **cal** affiche un calendrier. \\
Si elle est utilisée sans option, elle affiche le mois courant avec le jour en surbrillance dans un carré :

<code user>cal</code>
<code config retour de la commande>   Décembre 2012      
di lu ma me je ve sa  
                   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</code>


==== Syntaxe ====

    cal [ -hjy ] [ [mois] [annee] ]

==== Options ====

^ Options         ^ Résultats           ^
|-h|Affiche le calendrier sans surligné dans un carré la date du jour|
|-j|Affiche les numéros des jours dans l'année (le numéro 1 correspond au 1er Janvier).|
|-m [nom] //ou// [chiffre]|Affiche le calendrier d'un mois donné. Le mois peut être spécifié par son nom, ex. décembre (decembre est aussi valable) ou en chiffre, ex. 12 affiche décembre.|
|-m [chiffre]p |Affiche le calendrier du mois demandé pour l'année d'avant|
|-m [chiffre]f |Affiche le calendrier du mois demandé pour l'année d'après|
|-y |Affiche tout le calendrier de l'année courante.|
|[chiffre du mois] [chiffre de l'année] |Affiche le calendrier d'un mois et d'une année donnée. Le mois ainsi que l'année doivent être spécifiées en chiffres.|

=== Exemples ===

<code user>cal -j</code>
<code config retour de la commande>
       Décembre 2012         
 di  lu  ma  me  je  ve  sa  
                        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</code>


<code user>cal -m 12</code>
<code config retour de la commande>   Décembre 2012      
di lu ma me je ve sa  
                   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 </code>                


<code user>cal -m 12f</code>
<code config retour de la commande>
   Décembre 2013      
di lu ma me je ve sa  
 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</code>

              
<code user>cal -m 12p</code>
<code config retour de la commande>
   Décembre 2011      
di lu ma me je ve sa  
             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 </code> 


<code user>cal 05 2011</code>
<code config retour de la commande>
      Mai 2011        
di lu ma me je ve sa  
 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</code>


==== Autre exemple ====

Il est possible d'afficher le mois courant ainsi que les mois précédent et suivant ce dernier.

<code user>cal -3</code>

<code config retour de la commande>   Novembre 2012         Décembre 2012          Janvier 2013      
di lu ma me je ve sa  di lu ma me je ve sa  di lu ma me je ve sa  
             1  2  3                     1         1  2  3  4  5  
 4  5  6  7  8  9 10   2  3  4  5  6  7  8   6  7  8  9 10 11 12  
11 12 13 14 15 16 17   9 10 11 12 13 14 15  13 14 15 16 17 18 19  
18 19 20 21 22 23 24  16 17 18 19 20 21 22  20 21 22 23 24 25 26  
25 26 27 28 29 30     23 24 25 26 27 28 29  27 28 29 30 31        
                      30 31                                 
</code>
\\

===== La commande ncal =====


La commande **ncal** affiche un calendrier dans le terminal où par défaut, les semaines commencent par lundi. \\
Pratique, non ? ;-)
 
Cette commande prend en compte la variable //LC_TIME// des paramètres régionaux (voir ''man locale'').

==== Syntaxe ====

Affiche le mois courant avec le jour du mois en surbrillance dans un carré.
<code user>ncal</code>
<code config retour de la commande>    Décembre 2012     
lu     3 10 17 24 31
ma     4 11 18 25   
me     5 12 19 26   
je     6 13 20 27   
ve     7 14 21 28   
sa  1  8 15 22 29   
di  2  9 16 23 30</code>


==== Options ====

^ Options         ^ Résultats           ^
|-m [chiffre]|Affiche un mois donné en chiffre de l'année en cours|
|[chiffre] [chiffre]|Affiche un mois et une année données en chiffres|
|-wm [chiffre] [chiffre]|Affiche des numéros des semaines du mois de janvier de 2011|
|-C [chiffre double] [chiffre]|Affiche un calendrier du mois spécifié en chiffre double (01 ou 06 ou 11...) de l'année en chiffre au format **cal**|


=== Exemples ===

<code user>ncal -m 6</code>
<code config retour de la commande>
    Juin 2012         
lu     4 11 18 25   
ma     5 12 19 26   
me     6 13 20 27   
je     7 14 21 28   
ve  1  8 15 22 29   
sa  2  9 16 23 30   
di  3 10 17 24</code>


<code user>ncal 5 2011</code>
<code config retour de la commande>
    Mai 2011          
lu     2  9 16 23 30
ma     3 10 17 24 31
me     4 11 18 25   
je     5 12 19 26   
ve     6 13 20 27   
sa     7 14 21 28   
di  1  8 15 22 29</code>


<code user>ncal -wm 1 2011</code>
<code config retour de la commande>    Janvier 2011      
lu     3 10 17 24 31
ma     4 11 18 25   
me     5 12 19 26   
je     6 13 20 27   
ve     7 14 21 28   
sa  1  8 15 22 29   
di  2  9 16 23 30   
   52  1  2  3  4  5</code>


<code>ncal -C 01 2011</code>
<code config retour de la commande>    Janvier 2011      
lu ma me je ve sa di  
                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 </code>