Ξ
Δ
◄
►
¬
Ѕ
フィルター
ディレクティブ
組み込みの変数
組み込み関数
制御フロー文
演算子
宣言
組み込みクラス
組み込みメソッド／プロパティ
Ahk2Exeコンパイラ
キーワードをハイライト
</head> <body> <h1>FileSetTime</h1> <p>1つまたは複数のファイルまたはフォルダーのタイムスタンプを変更します。ワイルドカードに対応しています。</p> <pre class="Syntax"><span class="func">FileSetTime</span> <span class="optional">YYYYMMDDHH24MISS, FilePattern, WhichTime, Mode</span></pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>YYYYMMDDHH24MISS</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>空白または省略された場合、現在のローカルタイムがデフォルトとなります。それ以外の場合は、操作に使用する時間を指定します（形式は<a href="#Remarks">備考</a>を参照）。1601年以前はサポート対象外です。</p> </dd> <dt>FilePattern</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>省略されたときは、最も内側の<a href="LoopFiles.htm">file loop</a>の中の現在のファイルが設定されます。それ以外の場合、単一のファイルまたはフォルダの名前、または<code>"C:\Temp\*.tmp"</code>のようなワイルドカードパターンです。絶対パスが指定されない場合、<em>FilePattern</em>は<a href="../Variables.htm#WorkingDir">A_WorkingDir</a> にあるとみなされます。</p> </dd> <dt>WhichTime</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>If blank or omitted, it defaults to M. Otherwise, specify one of the following letters to set which timestamp should be changed:</p> <ul> <li>M＝修正時間</li> <li>C＝作成時間</li> <li>A＝最終アクセス時刻</li> </ul> </dd> <dt>Mode</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>空白または省略された場合、ファイルのみが操作され、サブディレクトリは再帰されません。それ以外の場合は、以下の文字を1つ以上指定してください：</p> <ul> <li>D = インクルードディレクトリ（フォルダ）。</li> <li>F = インクルードファイル。FとDの両方が省略された場合、ファイルは含まれるがフォルダーは含まれません。</li> <li>R = サブフォルダを再帰的に検索し、<em>FilePattern</em>に一致するファイルおよびフォルダを操作します。<em>FilePattern</em>に一致する名前のサブフォルダだけでなく、すべてのサブフォルダに再帰的にアクセスします。Rが省略された場合、サブフォルダー内のファイルやフォルダーは含まれません。</li> </ul> <p class="note"><strong>注意：</strong><em>FilePattern</em>がワイルドカードパターンではなく、単一のフォルダの場合、この設定に関係なく常に操作されます。</p> </dd> </dl> <h2 id="Error_Handling">エラー処理</h2> <p>ファイルの変更に失敗した場合、<a href="Error.htm">Error</a>がThrowされ、<a href="Error.htm#Extra">Extra</a>プロパティには失敗した回数が設定されます。</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="説明">説明</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は午前9時、21は午後9時です。</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 = Month 01</li> <li>DD = Day 01</li> <li>HH24 = Hour 00</li> <li>MI = Minute 00</li> <li>SS = Second 00</li> </ul> <p>組み込み変数<a href="../Variables.htm#Now">A_Now</a>には、上記のフォーマットで現在のローカルタイムが格納されています。同様に、<a href="../Variables.htm#NowUTC">A_NowUTC</a>には、現在の協定世界時（Coordinated Universal Time）が格納されます。</p> <p class="note"><strong>注意：</strong><a href="DateAdd.htm">DateAdd</a>、<a href="DateDiff.htm">DateDiff</a>により、日付時刻の値を比較、加算、減算することができます。また、時間の比較には、同じ文字列の長さでない限り、大なり小なりは使わないほうがよいでしょう。これは、数字として比較されるからです。例えば、20040201は常に200401010533より数字的には小さい（しかし時系列的には大きい）のです。そこで、代わりに<a href="DateDiff.htm">DateDiff</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="LoopFiles.htm">ファイルループ</a>、<a href="DateAdd.htm">DateAdd</a>、<a href="DateDiff.htm">DateDiff</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> 修正日を設定します（時刻は午前0時になります）。</p> <pre>FileSetTime 20040122, "C:\My Documents\test.doc"</pre> </div> <div class="ex" id="ExCreateTime"> <p><a class="ex_number" href="#ExCreateTime"></a> 作成日時を設定します。時刻は16時55分に設定されます。</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> パターンに一致するすべてのファイルのmod-dateを変更します。一致するフォルダーは、最後のパラメーターによって変更されます。</p> <pre>FileSetTime 20040122165500, "C:\Temp\*.*", "M", "DF"</pre> </div> </body> </html>