EnvAdd

変数に値を加算する。

EnvAdd, Var, Value [,TimeUnits]
Var+=Value [,TimeUnits]
Var++

Parameters

引数名説明
Var 対象となる変数名
Value 加算する数値。
も使用可能。
式を使用する場合は、TimeUnitsを使用することはできない。
TimeUnits Valueの日付時刻の単位。
「Seconds」「Minutes」「Hours」「Days」のどれかを指定。頭文字一文字でも可。
指定されると、VarをYYYYMMDDHH24MISS形式の日付時刻フォーマットとみなし、Valueで指定した数をTimeUnitsで指定した単位で加算する。
たとえば、Valueを100、TimeUnitsを「Days」とすると、Valueの日付を100日進める。
負の値を加算することで、減算も可能。
Varの値が空の場合、現在の日付時刻が使用される。
Varの値が日付時刻として誤っている場合、Varの値は空になる。

Remarks

「Var++」の形式では、1だけ値を加算できる。
内部的には、「Var+=1」とまったく同じである。

VarやValueの値が空だったり、数字以外のものからはじまる文字列だった場合は、「0」であるものとして計算される。
数字から始まっている文字列であれば、先頭の数字列(小数点以下含む)の数値であるとみなされる。

VarとValueの両方が小数点を含まない数字列の場合、結果は整数表記になる。
いずれかが小数点を含む場合、結果は小数表記になる。
結果の表記フォーマットはSetFormatで設定できる。

Related

EnvSub, EnvMult, EnvDiv, SetFormat, , If var is [not] type, SetEnv, FileGetTime

Example(s)

EnvAdd, MyCount, 2
MyCount += 2 ; Equivalent to above
var1 = ; Make it blank so that the below will use the current time instead.
var1 += 31, days
MsgBox, %var1% ; The answer will be the date 31 days from now.