Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tcl:clock [2023/10/11 10:19] – créée CrazyCat
+++ tcl:clock [2023/11/23 15:10] (Version actuelle) – [Voir aussi] CrazyCat
@@ Ligne 2: / Ligne 2: @@
 Obtient et manipule l'heure
 ===== Syntaxe =====
-<code tcl>clock option ?arg arg ...?</code>
+<code tcl>clock add timeVal ?count unit...? ?-option value?
+clock clicks ?-option?
+clock format timeVal ?-option value...?
+clock microseconds
+clock milliseconds
+clock scan inputString ?-option value...?
+clock seconds</code>
 ===== Description =====
 Cette commande effectue l'une des opérations qui permettent d'obtenir ou de manipuler des chaînes ou des valeurs qui représentent une notion de temps. L'argument option détermine l'action effectuée par la commande. Les options légales (qui peuvent être abrégées) sont:
@@ Ligne 47: / Ligne 53: @@
 ==== scan ====
 <code tcl>clock scan dateString ?-base clockVal? ?-gmt boolean?</code>
-Convertit dateString en une valeur d'horloge entière (voir clock seconds). Cette commande peut virtuellement analyser et convertir toute chaîne de date et/ou d'heure standard, qui peut inclure des mnémoniques timezone standards. Si une heure est spécifiée seule, la date courante est supposée. Si la chaîne ne contient pas de mnémoniques timezone, la timezone locale est supposée, à moins que l'argument -gmt soit vrai, auquel cas la valeur horloge est calculée en présumant que l'heure spécifiée est relative à Greenwich Mean Time. -gmt, si spécifié, affecte seulement la valeur de l'heure calculée; elle n'influe pas sur l'interprétation de -base. Si le flag -base est spécifié, l'argument suivant doit contenir une valeur horloge entière. Seule la date de cette valeur est utilisée, pas l'heure. Ceci est utile pour déterminer l'heure d'un jour spécifique ou faire d'autres conversions relatives à la date. La dateString est constitué de zéro ou plus éléments de la forme suivante: time L'heure du jour, qui est de la forme: hh?:mm?:ss?? ?meridian? ?zone? ou hhmm ?meridian? ?zone?. Si méridien n'est spécifié, hh est interprété sur une horloge 24-heures. date Une date mois et jour spécifique avec l'année optionnelle. Les formats acceptables sont mm/dd?/yy?, monthname dd ?, yy?, dd monthname ?yy?, day, dd monthname yy, ?CC?yymmdd, ?CC?yy-mm-dd, dd-monthname-?CC?yy. L'année par défaut est l'année courante. Si l'année est inférieure à 100, les années 00-68 seront interprétées 2000-2068 et les années 69-99 comme 1969-1999. Toutes les plate-formes ne savent pas représenter les années 38-70, aussi l'utilisation de ces années peut entraîner une erreur. ISO 8601 point-in-time Une spécification ISO 8601, telle que CCyymmddThhmmss, ou T est le littéral T, CCyymmdd hhmmss, ou CCyymmddThh:mm:ss. relative time Une spécification relative à l'heure courante. Le format est number unit , les unités acceptables sont year, fortnight, month, week, day, hour, minute (ou min), et second (ou sec). L'unité peut être donnée au singulier ou au pluriel, comme dans 3 weeks. Ces modificateurs peuvent aussi être: tomorrow, yesterday, today, now, last, this, next, ago. La date actuelle est calculée selon les étapes suivantes. D'abord, toute date et/ou temps absolu est traitée et convertie. Partant de cet instant comme base, les spécifications du jour de la semaine sont ajoutées. Ensuite, des spécifications relatives sont utilisées. Si une date ou un jour est spécifié, et qu'aucune heure absolue ou relative n'est donnée, minuit est utilisé. Finalement, une correction est appliquée ainsi l'heure du jour correcte est produite après les rectifications pour l'heure d'été et la date correcte est donnée au passage de la fin d'un mois long à un mois court. La correction d'heure d'été est appliquée seulement quand l'heure relative est spécifiée dans les unités de jour ou plus, c.a.d., jours, semaines, quinzaines, mois ou années. Ceci signifie que quand on change d'heure, des résultats différents seront donnés pour `clock scan "1 day"` et `clock scan "24 hours"`:
+Convertit //dateString// en une valeur d'horloge entière (voir [[#seconds|clock seconds]]).
+Cette commande peut virtuellement analyser et convertir toute chaîne de date et/ou d'heure standard, qui peut inclure des mnémoniques timezone standards. Si une heure est spécifiée seule, la date courante est supposée. Si la chaîne ne contient pas de mnémoniques timezone, la timezone locale est supposée, à moins que l'argument //-gmt// soit vrai, auquel cas la valeur horloge est calculée en présumant que l'heure spécifiée est relative à Greenwich Mean Time.
+//-gmt//, si spécifié, affecte seulement la valeur de l'heure calculée; elle n'influe pas sur l'interprétation de -base.
+Si le flag //-base// est spécifié, l'argument suivant doit contenir une valeur horloge entière. Seule la date de cette valeur est utilisée, pas l'heure. Ceci est utile pour déterminer l'heure d'un jour spécifique ou faire d'autres conversions relatives à la date.
+La //dateString// est constitué de zéro ou plus éléments de la forme suivante:
+  * **time** L'heure du jour, qui est de la forme: `hh?:mm?:ss?? ?meridian? ?zone?` ou `hhmm ?meridian? ?zone?`. Si //meridian// n'est spécifié, //hh// est interprété sur une horloge 24 heures.
+  * **date** Une date mois et jour spécifique avec l'année optionnelle. Les formats acceptables sont `mm/dd?/yy?`, `monthname dd ?, yy?`, `dd monthname ?yy?`, `day, dd monthname yy`, `?CC?yymmdd`, `?CC?yy-mm-dd`, `dd-monthname-?CC?yy`. L'année par défaut est l'année courante. Si l'année est inférieure à 100, les années 00-68 seront interprétées 2000-2068 et les années 69-99 comme 1969-1999. Toutes les plate-formes ne savent pas représenter les années 38-70, aussi l'utilisation de ces années peut entraîner une erreur.
+  * **relative time** Une spécification relative à l'heure courante. Le format est //number unit//, les unités acceptables sont **year**, **fortnight**, **month**, **week**, **day**, **hour**, **minute** (ou **min**), et **second** (ou **sec**). L'unité peut être donnée au singulier ou au pluriel, comme dans `3 weeks`. Ces modificateurs peuvent aussi être: **tomorrow**, **yesterday**, **today**, **now**, **last**, **this**, **next**, **ago**. La date actuelle est calculée selon les étapes suivantes.
+    * D'abord, toute date et/ou temps absolu est traitée et convertie.
+    * Partant de cet instant comme base, les spécifications du jour de la semaine sont ajoutées.
+    * Ensuite, des spécifications relatives sont utilisées. Si une date ou un jour est spécifié, et qu'aucune heure absolue ou relative n'est donnée, minuit est utilisé.
+    * Finalement, une correction est appliquée ainsi l'heure du jour correcte est produite après les rectifications pour l'heure d'été et la date correcte est donnée au passage de la fin d'un mois long à un mois court. La correction d'heure d'été est appliquée seulement quand l'heure relative est spécifiée dans les unités de jour ou plus, c.a.d., jours, semaines, quinzaines, mois ou années. Ceci signifie que quand on change d'heure, des résultats différents seront donnés pour `clock scan "1 day"` et `clock scan "24 hours"`:
 <code tcl>% clock scan "1 day" -base [clock scan 1999-10-31]
 941443200
@@ Ligne 58: / Ligne 79: @@
 ===== Voir aussi =====
+[[faq:strftime]]
-{{tag>tcl}}
+{{tag>tcl incomplete}}