91 lines
8.7 KiB
HTML
91 lines
8.7 KiB
HTML
|
<HTML><HEAD>
|
|||
|
|
<BASEFONT FACE="Times New Roman" SIZE="2" COLOR="#000000">
|
|||
|
|
</HEAD<BODY>
|
|||
|
|
<div><H3><b>clock Commandes Internes Tcl</b></H3></div>
|
|||
|
|
<HR ALIGN="center">
|
|||
|
|
<div><b>NOM</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">clock- Obtient et manipule l'heure
|
|||
|
|
</div><br>
|
|||
|
|
<div><b>SYNTAXE</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;"><b>clock </b><i>option</i> ?<i>arg arg ...</i> <br>
|
|||
|
|
</div><br>
|
|||
|
|
<div><b>DESCRIPTION</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">Cette commande effectue l'une des op<6F>rations qui permettent d'obtenir ou de manipuler des cha<68>nes ou des valeurs qui repr<70>sentent une notion de temps. L'argument <i>option</i> d<>termine l'action effectu<74>e par la commande. Les <i>options</i> l<>gales (qui peuvent <20>tre abr<62>g<EFBFBD>es) sont:
|
|||
|
|
<DL>
|
|||
|
|
<DT><b>clock clicks</b> ?<b>-milliseconds</b>?<br></DT><DD>Retourne une valeur haute-r<>solution de l'heure en tant que valeur enti<74>re dependante du syst<73>me. L'unit<69> de valeur d<>pend du syst<73>me mais est la plus haute r<>solution d'horloge disponible sur le syst<73>me tel un cycle CPU. Si <b>-milliseconds</b> est sp<73>cifi<66>, alors on a la garantie que la valeur a une granularit<69> de la milliseconde. Cette valeur ne doit <20>tre utilis<69>e que pour la mesure relative du temps <20>coul<75>.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br>
|
|||
|
|
<b>clock format </b><i>clockValue</i> ?<b>-format </b><i>string</i>? ?<b>-gmt </b><i>boolean</i>?</DT><DD>Convertit un entier repr<70>sentant un temps, typiquement renvoy<6F> par <b>clock </b><b>seconds</b>, <b>clock scan</b>, ou les options <b>atime</b>, <b>mtime</b>, ou <b>ctime</b> de la commande<A HREF="111.htm"><b> file</b></A>, en une forme compr<70>hensible. Si l'argument <b>-</b><A HREF="117.htm"><b>format</b></A> est pr<70>sent l'argument suivant est une cha<68>ne qui d<>crit comment date et l'heure doivent <20>tre format<61>s. Les descripteurs de champs sont constitu<74>s d'un <b>%</b> suivi par un caract<63>re descripteur de champ. Tous les autre caract<63>res sont copi<70>s dans r<>sultat. Les descripteurs de champs valides sont:
|
|||
|
|
<UL>
|
|||
|
|
<LI><b>%%</b> Ins<6E>re un %. </LI>
|
|||
|
|
<LI><b>%a</b> Nom abr<62>g<EFBFBD> d'un jour de la semaine (Mon, Tue, etc.).
|
|||
|
|
</LI>
|
|||
|
|
<LI><b>%A</b> Nom complet d'un jour de la semaine (Monday, Tuesday, etc.).
|
|||
|
|
</LI>
|
|||
|
|
<LI><b>%b</b> Nom abr<62>g<EFBFBD> d'un mois (Jan, Feb, etc.). </LI>
|
|||
|
|
<LI><b>%B</b> Nom complet d'un mois</LI>
|
|||
|
|
<LI><b>%c</b> Date et heure Locale sp<73>cifique. </LI>
|
|||
|
|
<LI><b>%d</b> Jour du mois (01 - 31). </LI>
|
|||
|
|
<LI><b>%H</b> Heure en format 24-heure (00 - 23). </LI>
|
|||
|
|
<LI><b>%I</b> Heure en format 12-heure (00 - 12). </LI>
|
|||
|
|
<LI><b>%j</b> Jour de l'ann<6E>e (001 - 366). </LI>
|
|||
|
|
<LI><b>%m</b> Numero du mois (01 - 12). </LI>
|
|||
|
|
<LI><b>%M</b> Minute (00 - 59).</LI>
|
|||
|
|
<LI><b>%p</b> indicateur AM/PM. </LI>
|
|||
|
|
<LI><b>%S</b> Secondes (00 - 59).</LI>
|
|||
|
|
<LI><b>%U</b> Semaine de l 'ann<6E>e (00 - 52), Dimanche est le premier jour de la semaine.
|
|||
|
|
</LI>
|
|||
|
|
<LI><b>%w</b> Numero du jour de la semaine. (Dimanche = 0). </LI>
|
|||
|
|
<LI><b>%W</b> Semaine de l 'ann<6E>e (00 - 52), Lundi est le premier jour de la semaine
|
|||
|
|
</LI>
|
|||
|
|
<LI><b>%x</b> Format de Date Locale. </LI>
|
|||
|
|
<LI><b>%X</b> Format d'Heure Locale. </LI>
|
|||
|
|
<LI><b>%y</b> Ann<6E>e sans si<73>cle (00 - 99). </LI>
|
|||
|
|
<LI><b>%Y</b> Ann<6E>e avec si<73>cle (ex. 1990) </LI>
|
|||
|
|
<LI><b>%Z</b> Nom de Time zone. <br></LI>
|
|||
|
|
De plus, les descripteurs de champs suivants peuvent <20>tre support<72>s sur quelque syst<73>mes (ex. Unix mais pas Windows):
|
|||
|
|
|
|||
|
|
<LI><b>%D</b> Date comme %m/%d/%y. </LI>
|
|||
|
|
<LI><b>%e</b> Jour du mois (1 - 31), sans le z<>ro compl<70>mentaire. </LI>
|
|||
|
|
<LI><b>%h</b> Nom abr<62>g<EFBFBD> d'un mois. </LI>
|
|||
|
|
<LI><b>%n</b> Ins<6E>re un saut de ligne. </LI>
|
|||
|
|
<LI><b>%r</b> Heure comme %I:%M:%S %p. </LI>
|
|||
|
|
<LI><b>%R</b> Heure comme %H:%M. </LI>
|
|||
|
|
<LI><b>%t</b> Ins<6E>re une tabulation.</LI>
|
|||
|
|
<LI><b>%T</b> Heure comme %H:%M:%S. <br></LI>
|
|||
|
|
</UL>
|
|||
|
|
Si l'argument <b>-</b> <A HREF="117.htm"><b>format</b></A> n'est pas sp<73>cifi<66>, la cha<68>ne de formatage "<b>%a %b %d </b><b>%H:%M:%S %Z %Y</b>" est utilis<69>e. Si l'argument <b>-gmt</b> est pr<70>sent il doit <20>tre suivi d'un bool<6F>en qui s'il est vrai sp<73>cifie que l'heure doit <20>tre format<61>e comme une heure Greenwich Mean Time. S'il est faux, la timezone locale d<>finie par l'environnement d'exploitation est utilis<69>e.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>clock scan </b><i>dateString</i> ?<b>-base </b><i>clockVal</i>? ?<b>-gmt </b><i>boolean</i>?
|
|||
|
|
</DT><DD>Convertit <i>dateString</i> en une valeur d'horloge enti<74>re (voir <b>clock seconds</b>). Cette commande peut virtuellement analyser et convertir toute cha<68>ne de date et/ou d'heure standard, qui peut inclure des mn<6D>moniques timezone standards. Si une heure est sp<73>cifi<66>e seule, la date courante est suppos<6F>e. Si la cha<68>ne ne contient pas de mn<6D>moniques timezone, la timezone locale est suppos<6F>e, <20> moins que l'argument <b>-gmt</b> soit vrai, auquel cas la valeur horloge est calcul<75>e en pr<70>sumant que l'heure sp<73>cifi<66>e est relative <20> Greenwich Mean Time. <b>-gmt</b>, si sp<73>cifi<66>, affecte seulement la valeur de l'heure calcul<75>e; elle n'influe pas sur l'interpr<70>tation de <b>-base</b>. <br>
|
|||
|
|
Si le flag <b>-base</b> est sp<73>cifi<66>, l'argument suivant doit contenir une valeur horloge enti<74>re. Seule la date de cette valeur est utilis<69>e, pas l'heure. Ceci est utile pour d<>terminer l'heure d'un jour sp<73>cifique ou faire d'autres conversions relatives <20> la date. <br>
|
|||
|
|
La <i>dateString</i> est constitu<74> de z<>ro ou plus <20>l<EFBFBD>ments de la forme suivante:
|
|||
|
|
<br><br><UL>
|
|||
|
|
<LI><i>time</i> L'heure du jour, qui est de la forme: <i>hh</i>?<i>:mm</i>?<i>:ss</i>?? ?<i>meridian</i>? ?<i>zone</i>? ou <i>hhmm </i>?<i>meridian</i>? ?<i>zone</i>?. Si m<>ridien n'est sp<73>cifi<66>, <i>hh</i> est interpr<70>t<EFBFBD> sur une horloge 24-heures.
|
|||
|
|
</LI>
|
|||
|
|
<LI><i>date</i> Une date mois et jour sp<73>cifique avec l'ann<6E>e optionnelle. Les formats acceptables sont <i>mm/dd</i>?<i>/yy</i>?, <i>monthname dd</i> ?, <i>yy</i>?, <i>dd </i><i>monthname </i>?<i>yy</i>?, <i>day, dd monthname yy</i>, <i>?CC?yymmdd</i>, <i>?CC?yy-mm-dd</i>, <i>dd-monthname-?CC?yy</i>. L'ann<6E>e par d<>faut est l'ann<6E>e courante. Si l'ann<6E>e est inf<6E>rieure <20> 100, les ann<6E>es 00-68 seront interpr<70>t<EFBFBD>es 2000-2068 et les ann<6E>es 69-99 comme 1969-1999. Toutes les plateformes ne savent pas repr<70>senter les ann<6E>es 38-70, aussi l'utilisation de ces ann<6E>es peut entrainer une erreur.
|
|||
|
|
</LI>
|
|||
|
|
<LI><i>ISO 8601 point-in-time</i>
|
|||
|
|
Une sp<73>cification ISO 8601, telle que <i>CCyymmddThhmmss</i>, ou T est le literal T, <i>CCyymmdd hhmmss</i>, ou <i>CCyymmddThh:mm:ss</i>.
|
|||
|
|
</LI>
|
|||
|
|
<LI><i>relative time</i>
|
|||
|
|
Une sp<73>cification relative <20> l'heure courante. Le format est <i>number unit</i> , les unit<69>s acceptables sont <b>year</b>, <b>fortnight</b>, <b>month</b>, <b>week</b>, <b>day</b>, <b>hour</b>, <b>minute</b> (ou <b>min</b>), et <b>second</b> (ou <b>sec</b>). L'unit<69> peut <20>tre donn<6E>e au singulier ou au pluriel, comme dans <b>3 weeks</b>. Ces modificateurs peuvent aussi <20>tre: <b>tomorrow</b>, <b>yesterday</b>, <b>today</b>, <b>now</b>, <b>last</b>, <b>this</b>, <b>next</b>, <b>ago</b>. <br>
|
|||
|
|
</LI>
|
|||
|
|
</UL><br>
|
|||
|
|
La date actuelle est calcul<75>e selon les <20>tapes suivantes. D'abord, toute date et/ou temps absolu est trait<69>e et convertie. Partant de cet instant comme base, les sp<73>cifications du jour de la semaine sont ajout<75>es. Ensuite, des sp<73>cifications relatives sont utilis<69>es. Si une date ou un jour est sp<73>cifi<66>, et qu'aucune heure absolue ou relative n'est donn<6E>e, minuit est utilis<69>. Finalement, une correction est appliqu<71>e ainsi l'heure du jour correcte est produite apr<70>s les rectifications pour l'heure d'<27>t<EFBFBD> et la date correcte est donn<6E>e au passage de la fin d'un mois long <20> un mois court. <br>
|
|||
|
|
La correction d'heure d'<27>t<EFBFBD> est appliqu<71>e seulement quand l'heure relative est sp<73>cifi<66>e dans les unit<69>s de jour ou plus, c.a.d., jours, semaines, quinzaines, mois ou ann<6E>es. Ceci signifie que quand on change d'heure, des r<>sultats diff<66>rents seront donn<6E>s pour <b>clock scan "1 day"</b> et <b>clock </b><b>scan "24 hours"</b>:
|
|||
|
|
<b>% clock scan "1 day" -base [clock scan 1999-10-31]<br>
|
|||
|
|
</b><b>941443200<br>
|
|||
|
|
</b><b>% clock scan "24 hours" -base [clock scan 1999-10-31]<br>
|
|||
|
|
</b><b>941439600</b>
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>clock seconds</b><br></DT><DD>Retourne l'heure et la date courante comme valeur enti<74>re d<>pendante du syst<73>me . L'unit<69> de valeur est la seconde, lui permettant d'<27>tre utilis<69>e pour les calculs de temps relatif. La valeur est usuellement d<>finie comme le temps total <20>coul<75> depuis un “epoch”. Vous ne pouvez pr<70>sumer la valeur de l'epoch.
|
|||
|
|
</DD>
|
|||
|
|
</DL>
|
|||
|
|
</div>
|
|||
|
|
<div>Derni<EFBFBD>re r<>vision: 8.3</div>
|
|||
|
|
<br>
|
|||
|
|
<br><div ALIGN="CENTER"><A HREF="index.htm"><b>Index</b></A> <A HREF="95.htm"><b>Pr<EFBFBD>c<EFBFBD>dent</b></A> <A HREF="97.htm"><b>Suivant</b></A></div>
|
|||
|
|
|
|||
|
|
</BODY></HTML>
|