改变一个或多个文件或文件夹的时间戳. 支持通配符.
FileSetTime , YYYYMMDDHH24MISS, FilePattern, WhichTime, OperateOnFolders?, Recurse?
如果为空或省略, 则默认为当前时间. 否则, 指定操作使用的时间(请参阅备注了解时间的格式). 不支持 1601 以前的年份.
此参数可以为表达式. 因此, 如果需要连接多个变量来形成单个时间戳, 则应该使用点运算符代替百分号. 例如: FileSetTime, Year . Month . Day, C:\My File.txt.
单个文件或文件夹的名称或者通配符模式, 例如 C:\Temp\*.tmp. 如果未指定绝对路径, 则假定 FilePattern 在 %A_WorkingDir% 中.
如果省略, 则使用最内层文件循环的当前文件.
如果空白或省略, 则默认为 M(修改时间). 否则, 指定以下字母之一来设置应该更改的时间戳:
如果空白或省略, 则默认为 0(仅对文件进行操作). 否则, 指定下列数字之一:
注意: 如果 FilePattern 是单个文件夹而不是通配符模式, 那么总是忽略此设置.
此参数可以为表达式.
如果空白或省略, 则默认为 0(不对子文件夹进行递归). 否则, 指定下列数字之一:
此参数可以为表达式.
[v1.1.04+]: 此命令失败时会抛出异常. 想了解更多信息, 请参阅运行时错误.
ErrorLevel 被设置为改变属性 失败 的文件数, 否则为 0. 如果指定的时间戳无效或 FilePattern 解析结果为空值, 则 ErrorLevel 被置为 1.
如果找到了文件, 则 A_LastError 会被设置为 0(零) 或最近一次操作失败时调用操作系统 GetLastError() 函数的结果. 否则 A_LastError 包含了没有找到文件原因的错误码.
在 FAT16 & FAT32 卷上的文件上次访问时间可能不如在 NTFS 卷上那么精确.
YYYYMMDDHH24MISS 格式中元素表示的含义分别为:
| 元素 | 描述 |
|---|---|
| YYYY | 年份(4 位数) |
| MM | 月份(2 位数)(01-12) |
| DD | 月份的天数(2 位数)(01-31) |
| HH24 | 24 小时格式的小时数(2 位数)(00-23). 例如, 09 是 9am 而 21 是 9pm. |
| MI | 分钟数(2 位数)(00-59) |
| SS | 秒数(2 位数)(00-59) |
如果只给出了 YYYYMMDDHH24MISS 中的部分字符串(例如 200403), 则任何省略的元素将使用下面的默认值:
内置变量 A_Now 包含了上述格式的当前本地时间. 同样地, A_NowUTC 包含了当前的协调世界时.
注意: 使用 EnvAdd 和 EnvSub 可以对日期时间值进行比较和加减. 此外, 最后不要使用大于或小于来比较时间, 除非它们的字符串长度相同. 这是因为此时它们被视为数字进行比较; 例如, 20040201 数值上总是小于(但时间顺序上较后) 200401010533. 所以应该使用 EnvSub 来计算出它们之间的时间差是正数还是负数.
FileGetTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, FormatTime, 文件循环, EnvAdd (时间计算), EnvSub (时间比较)