# FileSetTime

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

    FileSetTime YYYYMMDDHH24MISS, FilePattern, WhichTime, Mode

## 参数

YYYYMMDDHH24MISS

  类型: 字符串

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

FilePattern

  类型: 字符串

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

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

WhichTime

  类型: 字符串

  如果为空或省略, 则默认为 M(修改时间). 否则, 指定以下字母之一来设置应该更改的时间戳:

  - M = 修改时间
  - C = 创建时间
  - A = 上次访问时间
Mode

  类型: 字符串

  如果为空或省略, 则仅对文件进行操作, 子目录不被递归. 否则, 请指定零个或更多的下列字母:

  - D = 包含目录(文件夹).
  - F = 包含文件. 如果同时省略 F 和 D, 则仅包含文件而不包括目录.
  - R = 子文件夹被递归到其中, 这样包含在其中的文件和文件夹如果匹配 FilePattern, 则对它们进行操作. 所有子文件夹都将被递归到其中, 而不仅仅是那些名称匹配 FilePattern 的子文件夹. 如果省略 R, 则不包含子目录中的文件和目录.

  注意: 如果 FilePattern 是单个文件夹, 而不是通配符模式, 则无论该设置如何, 它都将始终被操作.

## 错误处理

如果有文件更改失败, 则抛出 Error, 并且它的 Extra 属性设置为失败次数.

如果找到了文件, 则 A_LastError 会被设置为 0(零) 或最近一次操作失败时调用操作系统 GetLastError() 函数的结果. 否则 A_LastError 包含了没有找到文件原因的错误码.

## 备注

文件的上次访问时间在 FAT16 & FAT32 卷上可能不如在 NTFS 卷上精确.

YYYYMMDDHH24MISS 格式中元素表示的含义分别为:

Element | 描述
--- | ---
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 包含了当前的协调世界时.

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

## 相关

FileGetTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, FormatTime, 文件循环, DateAdd, DateDiff

## 示例

设置所有匹配文件的修改时间为当前时间.

    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", "DF"

dftg