FileSetTime

AutoHotKey

FileSetTime

改变一个或多个文件或文件夹的时间戳.支持通配符.

FileSetTime [, YYYYMMDDHH24MISS, FilePattern, WhichTime, OperateOnFolders?, Recurse?]

参数

YYYYMMDDHH24MISS

如果为空或省略, 则它默认为当前时间. 否则, 指定操作使用的时间 (请参阅备注了解时间的格式). 不支持 1601 以前的年份.

此参数可以为 表达式. 因此, 如果需要连接多个变量来形成单个时间戳, 则应该使用 点运算符 代替百分号. 例如:FileSetTime, Year . Month . Day, C:\My File.txt.

FilePattern

单个文件或文件夹的名称或者通配符模式, 例如 C:\Temp\*.tmp. 如果未指定绝对路径则假定 FilePattern%A_WorkingDir% 中.

如果省略, 则使用最内层 文件循环 的当前文件.

WhichTime
要设置的时间戳:
M = 修改时间 (如果此参数为空或省略, 这是默认的)
C = 创建时间
A = 上次访问时间
OperateOnFolders?

0 (默认) 不对文件夹进行操作 (仅文件).
对匹配通配符模式的所有文件和文件夹进行操作.
仅对文件夹进行操作 (不操作文件).

注: 如果 FilePattern 是单个文件夹而不是通配符模式, 那么总是忽略此设置.

此参数可以为 表达式.

递归?

0 (默认) 不对子文件夹进行递归.
递归子文件夹, 以便对包含在其中的匹配 FilePattern 的所有文件和文件夹进行操作. 将递归所有子文件夹, 而不仅是名称匹配 FilePattern 的那些. 但是, 文件和文件夹的完整路径和名称超过 259 个字符时, 这些文件和文件夹会被跳过, 就像它们不存在一样. 这样的文件很罕见, 因为操作系统一般不允许创建它们.

此参数可以为 表达式.

ErrorLevel

[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), 则任何省略的元素将使用下面的默认值:

MM: 月份 01
DD: 日期 01
HH24: 小时 00
MI: 分钟 00
SS: 秒 00

内置变量 A_Now 包含了上述格式的当前本地时间. 同样地, A_NowUTC 包含了当前的协调世界时.

注: 使用 EnvAddEnvSub 可以对日期时间值进行比较和加减. 此外, 最后不要使用大于或小于来比较时间, 除非它们的字符串长度相同. 这是因为此时它们被视为数字进行比较; 例如, 20040201 数值上总是小于 (但时间顺序上较后) 200401010533. 所以应该使用 EnvSub 来计算出它们之间的时间差是正数还是负数.

相关

FileGetTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, FormatTime, 文件循环, EnvAdd, EnvSub

示例

; 设置所有匹配文件的修改时间为当前时间:
FileSetTime, , C:\temp\*.txt

; 设置修改日期 (时间将为午夜):
FileSetTime, 20040122, C:\My Documents\test.doc

; 设置创建日期. 把时间设置为 4:55pm:
FileSetTime, 200401221655, C:\My Documents\test.doc, C

; 改变匹配一种模式的所有文件的修改时间.
; 由于最后一个参数的作用, 所以也会改变所有匹配的文件夹.:
FileSetTime, 20040122165500, C:\Temp\*.*, M, 1