Ξ
Δ
◄
►
¬
Ѕ
过滤筛选
指令
内置变量
内置函数
控制流语句
运算符
声明
命令
Ahk2Exe 编译器
高亮关键词
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script> <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1632085368384154" crossorigin="anonymous"></script><script src="https://autohotkey.top/gtag.js"></script></head> <body> <h1>FileSetTime</h1> <p>改变一个或多个文件或文件夹的时间戳. 支持通配符.</p> <pre class="Syntax"><span class="func">FileSetTime</span> <span class="optional">, YYYYMMDDHH24MISS, FilePattern, WhichTime, OperateOnFolders?, Recurse?</span></pre> <h2 id="Parameters">参数</h2> <dl> <dt>YYYYMMDDHH24MISS</dt> <dd><p>如果为空或省略, 则默认为当前时间. 否则, 指定操作使用的时间(请参阅备注了解时间的格式). 不支持 1601 以前的年份.</p> <p>此参数可以为<a href="../Variables.htm#Expressions">表达式</a>. 因此, 如果需要连接多个变量来形成单个时间戳, 则应该使用<a href="../Variables.htm#concat">点运算符</a>代替百分号. 例如: <code>FileSetTime, Year <strong>.</strong> Month <strong>.</strong> Day, C:\My File.txt</code>.</p></dd> <dt>FilePattern</dt> <dd><p>单个文件或文件夹的名称或者通配符模式, 例如 C:\Temp\*.tmp. 如果未指定绝对路径, 则假定 <em>FilePattern</em> 在 <a href="../Variables.htm#WorkingDir">%A_WorkingDir%</a> 中.</p> <p>如果省略, 则使用最内层<a href="LoopFile.htm">文件循环</a>的当前文件.</p></dd> <dt>WhichTime</dt> <dd><p>如果空白或省略, 则默认为 M(修改时间). 否则, 指定以下字母之一来设置应该更改的时间戳:</p> <ul> <li>M = 修改时间</li> <li>C = 创建时间</li> <li>A = 上次访问时间</li> </ul> </dd> <dt>OperateOnFolders?</dt> <dd><p>如果空白或省略, 则默认为 0(仅对文件进行操作). 否则, 指定下列数字之一:</p> <ul> <li>0 = 不对文件夹进行操作(仅文件).</li> <li>1 = 对匹配通配符模式的所有文件和文件夹进行操作.</li> <li>2 = 仅对文件夹进行操作(不操作文件).</li> </ul> <p class="note"><strong>注意</strong>: 如果 <em>FilePattern</em> 是单个文件夹而不是通配符模式, 那么总是忽略此设置.</p> <p>此参数可以为<a href="../Variables.htm#Expressions">表达式</a>.</p></dd> <dt>递归?</dt> <dd><p>如果空白或省略, 则默认为 0(不对子文件夹进行递归). 否则, 指定下列数字之一:</p> <ul> <li>0 = 不对子文件夹进行递归.</li> <li>1 = 递归子文件夹, 以便对包含在其中的匹配 <em>FilePattern</em> 的所有文件和文件夹进行操作. 将递归所有子文件夹, 而不仅是名称匹配 <em>FilePattern</em> 的那些. 但是, 文件和文件夹的完整路径和名称超过 259 个字符时, 这些文件和文件夹会被跳过, 就像它们不存在一样. 这样的文件很罕见, 因为操作系统一般不允许创建它们.</li> </ul> <p>此参数可以为<a href="../Variables.htm#Expressions">表达式</a>.</p></dd> </dl> <h2 id="Error_Handling">错误处理</h2> <p><span class="ver">[v1.1.04+]</span>: 此命令失败时会抛出异常. 想了解更多信息, 请参阅<a href="Catch.htm#RuntimeErrors">运行时错误</a>.</p> <p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被设置为改变属性 <u>失败</u> 的文件数, 否则为 0. 如果指定的时间戳无效或 <em>FilePattern</em> 解析结果为空值, 则 ErrorLevel 被置为 1.</p> <p>如果找到了文件, 则 <a href="../Variables.htm#LastError">A_LastError</a> 会被设置为 0(零) 或最近一次操作失败时调用操作系统 GetLastError() 函数的结果. 否则 A_LastError 包含了没有找到文件原因的错误码.</p> <h2 id="Remarks">备注</h2> <p>在 FAT16 & FAT32 卷上的文件上次访问时间可能不如在 NTFS 卷上那么精确.</p> <p id="YYYYMMDD">YYYYMMDDHH24MISS 格式中元素表示的含义分别为:</p> <table class="info"> <tr> <th>元素</th> <th abbr="Descr">描述</th> </tr> <tr> <td>YYYY</td> <td>年份(4 位数)</td> </tr> <tr> <td>MM</td> <td>月份(2 位数)(01-12)</td> </tr> <tr> <td>DD</td> <td>月份的天数(2 位数)(01-31)</td> </tr> <tr> <td>HH24</td> <td>24 小时格式的小时数(2 位数)(00-23). 例如, 09 是 9am 而 21 是 9pm.</td> </tr> <tr> <td>MI</td> <td>分钟数(2 位数)(00-59)</td> </tr> <tr> <td>SS</td> <td>秒数(2 位数)(00-59)</td> </tr> </table> <p>如果只给出了 YYYYMMDDHH24MISS 中的部分字符串(例如 200403), 则任何省略的元素将使用下面的默认值:</p> <ul> <li>MM = 月 01</li> <li>DD = 日 01</li> <li>HH24 = 小时 00</li> <li>MI = 分钟 00</li> <li>SS = 秒 00</li> </ul> <p>内置变量 <a href="../Variables.htm#Now">A_Now</a> 包含了上述格式的当前本地时间. 同样地, <a href="../Variables.htm#NowUTC">A_NowUTC</a> 包含了当前的协调世界时.</p> <p class="note"><strong>注意</strong>: 使用 <a href="EnvAdd.htm">EnvAdd</a> 和 <a href="EnvSub.htm">EnvSub</a> 可以对日期时间值进行比较和加减. 此外, 最后不要使用大于或小于来比较时间, 除非它们的字符串长度相同. 这是因为此时它们被视为数字进行比较; 例如, 20040201 数值上总是小于(但时间顺序上较后) 200401010533. 所以应该使用 <a href="EnvSub.htm">EnvSub</a> 来计算出它们之间的时间差是正数还是负数.</p> <h2 id="Related">相关</h2> <p><a href="FileGetTime.htm">FileGetTime</a>, <a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileSetAttrib.htm">FileSetAttrib</a>, <a href="FileGetSize.htm">FileGetSize</a>, <a href="FileGetVersion.htm">FileGetVersion</a>, <a href="FormatTime.htm">FormatTime</a>, <a href="LoopFile.htm">文件循环</a>, <a href="EnvAdd.htm">EnvAdd (时间计算)</a>, <a href="EnvSub.htm">EnvSub (时间比较)</a></p> <h2 id="Examples">示例</h2> <div class="ex" id="ExOmitted"> <p><a class="ex_number" href="#ExOmitted"></a> 设置所有匹配文件的修改时间为当前时间.</p> <pre>FileSetTime, , C:\temp\*.txt</pre> </div> <div class="ex" id="ExModTime"> <p><a class="ex_number" href="#ExModTime"></a> 设置修改日期(时间将为午夜).</p> <pre>FileSetTime, 20040122, C:\My Documents\test.doc</pre> </div> <div class="ex" id="ExCreateTime"> <p><a class="ex_number" href="#ExCreateTime"></a> 设置创建日期. 把时间设置为 4:55pm.</p> <pre>FileSetTime, 200401221655, C:\My Documents\test.doc, C</pre> </div> <div class="ex" id="ExPattern"> <p><a class="ex_number" href="#ExPattern"></a> 更改匹配文件的修改日期和时间. 由于最后一个参数的作用, 所以也会改变所有匹配的文件夹.</p> <pre>FileSetTime, 20040122165500, C:\Temp\*.*, M, 1</pre> </div> <a href="https://dftg.net">dftg</a><!-- Cloudflare Pages Analytics --><script defer src='https://static.cloudflareinsights.com/beacon.min.js' data-cf-beacon='{"token": "d5a9c4fcb9b6482fa53ce820d892f969"}'></script><!-- Cloudflare Pages Analytics --><script defer src="https://static.cloudflareinsights.com/beacon.min.js/vcd15cbe7772f49c399c6a5babf22c1241717689176015" integrity="sha512-ZpsOmlRQV6y907TI0dKBHq9Md29nnaEIPlkf84rnaERnq6zvWvPUqr2ft8M1aS28oN72PdrCzSjY4U6VaAw1EQ==" data-cf-beacon='{"rayId":"937589f9cb83eaf3","version":"2025.4.0-1-g37f21b1","r":1,"serverTiming":{"name":{"cfExtPri":true,"cfL4":true,"cfSpeedBrain":true,"cfCacheStatus":true}},"token":"51750bb5dc4f40cc91a5ec55c63bbc01","b":1}' crossorigin="anonymous"></script> </body> </html>