Affecte à une variable la somme d'elle même plus la valeur donnée (peut aussi ajouter ou soustraire l'heure depuis une valeur date-heure). Synonyme de: var += value
| EnvAdd, Var, Value [, TimeUnits] Var += Value [, TimeUnits] Var++ |
Paramètres
| Var | Le nom de la variable sur laquelle opérer. |
| Value | N'importe quel(le) entier, nombre décimal ou expression. Les expressions ne sont pas supportées lorsque TimeUnits est présent. |
| TimeUnits |
Si présent, ce paramètre ammène la commande à ajouter Value à Var, traitant Var comme un timbre date-heure au format YYYYMMDDHH24MISS et traitant Value comme l'entier ou le nombre décimal des unités à ajouter (spécifiez un nombre négatif pour effectuer une soustraction). TimeUnits peut être soit en secondes (Seconds), soit en minutes (Minutes), en heures (Hours), ou en jours (Days) (ou juste la première lettre (mot anglais) de chacun d'eux). Si Var est une variable vide, l'heure courante sera utilisée à sa place. Si Var contient un timbre-à-date invalide ou une année antérieure à 1601, ou si Value est non-numérique, Var sera vidée pour indiquer le problème. La variable intégrée A_Now contient l'heure locale courante au format YYYYMMDDHH24MISS. Pour calculer la quantité de temps entre deux timbres-à-dates, utilisez EnvSub. |
Remarques
Cette commande est équivalente au style sténo: Var += Value
Les variables peuvent ête incrémentées ou décrémentées de 1 en utilisant Var++, Var--, ++Var, ou --Var.
Si soit Var soit Value est vide ou ne commence pas par un nombre, c'est considéré comme étant un 0 pour la finalité du calcul (exepté lors de l'utilisation de TimeUnits, voir ci-dessus).
Si soit Var soit Value contient un point décimal, le résultat final sera un nombre décimal au format défini par SetFormat.
Relations
EnvSub, EnvMult, EnvDiv, SetFormat, Expressions, If var is [not] type, SetEnv, FileGetTime
Exemple
EnvAdd, MyCount, 2
MyCount += 2 ; L'équivalent de ce qui précède
var1 = ; la vide sans quoi ce qui suit utiliserait l'heure courante à la place.
var1 += 31, days
MsgBox, %var1% ; La réponse sera la date dans 31 jours à partir de maintenant.