FileSetTime

Ändert den Zeitstempel von ein oder mehreren Dateien oder Ordnern. Platzhalter werden unterstützt.

FileSetTime , YYYYMMDDHH24MISS, DateiMuster, WelcheZeit, OrdnerEinbeziehen, Rekursiv

Parameter

YYYYMMDDHH24MISS

Wenn leer oder weggelassen, wird standardmäßig die aktuelle Ortszeit verwendet. Andernfalls geben Sie einen Zeitpunkt an, der für diese Operation verwendet werden soll (siehe Bemerkungen zum Format). Jahre älter als 1601 werden nicht unterstützt.

Dieser Parameter ist ein Ausdruck. Folglich sollten Variablen nicht in Prozentzeichen gesetzt und jeweils durch mindestens ein Leerzeichen voneinander getrennt werden, z.B. FileSetTime, Jahr Monat Tag, C:\Meine Datei.txt.

DateiMuster

Wenn leer oder weggelassen, wird die aktuelle Datei der innersten umschlossenen Datei-Schleife verwendet. Andernfalls geben Sie den Namen einer Datei oder eines Ordners oder ein Platzhaltermuster wie z.B. C:\Temp\*.tmp an. Wenn kein absoluter Pfad angegeben ist, wird DateiMuster im A_WorkingDir-Verzeichnis vermutet.

WelcheZeit

Wenn leer oder weggelassen, wird standardmäßig M verwendet. Andernfalls geben Sie einen der folgenden Buchstaben an, um zu bestimmen, welcher Zeitstempel geändert werden soll:

OrdnerEinbeziehen

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:

Hinweis: Wenn DateiMuster ein einzelner Ordner anstelle eines Platzhaltermusters ist, wird er immer mit einbezogen, unabhängig von dieser Einstellung.

Dieser Parameter kann ein Ausdruck sein.

Rekursiv

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:

Dieser Parameter kann ein Ausdruck sein.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf die Anzahl der Dateien gesetzt, die nicht geändert werden konnten, und bei Erfolg auf 0. Wenn der angegebene Zeitstempel ungültig ist oder DateiMuster in einen leeren Wert aufgelöst wird, wird ErrorLevel auf 1 gesetzt.

Wenn Dateien gefunden wurden, wird A_LastError auf 0 oder das Ergebnis der Systemfunktion GetLastError() unmittelbar nach dem letzten Misserfolg gesetzt. Andernfalls enthält A_LastError einen Fehlercode, der eventuell kenntlich macht, warum keine Dateien gefunden wurden.

Bemerkungen

Der Zeitpunkt des letzten Zugriffs kann bei FAT16- und FAT32-Datenträgern ungenauer sein als bei NTFS-Datenträgern.

Die Elemente des YYYYMMDDHH24MISS-Formats sind:

Element Beschreibung
YYYY 4-stelliges Jahr
MM 2-stelliger Monat (01-12)
DD 2-stelliger Tag des Monats (01-31)
HH24 2-stellige Stunde im 24-Stunden-Format (00-23). Zum Beispiel: 09 ist 9am und 21 ist 9pm.
MI 2-stellige Minute (00-59)
SS 2-stellige Sekunde (00-59)

Wenn nur der beginnende Teil von YYYYMMDDHH24MISS angegeben wird (z.B. 200403), werden die restlichen weggelassenen Elemente mit folgenden Standardwerten ersetzt:

Die interne Variable A_Now enthält die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format. A_NowUTC enthält die aktuelle koordinierte Weltzeit.

Hinweis: Datum-Zeit-Werte können mit EnvAdd und EnvSub verglichen, addiert oder subtrahiert werden. Außerdem ist es ratsam, unterschiedlich lange Zeitstempel nicht mit Größer-Als oder Kleiner-Als zu vergleichen. Der Grund dafür ist, dass Zeitstempel numerisch verglichen werden, nicht chronologisch. Zum Beispiel ist 20040201 immer numerisch kleiner (aber chronologisch größer) als 200401010533. Verwenden Sie stattdessen EnvSub, um herauszufinden, ob die Zeitdifferenz zwischen den Zeitstempeln positiv oder negativ ist.

FileGetTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, FormatTime, Datei-Schleife, EnvAdd (Datumsberechnung), EnvSub (Datumsdifferenz)

Beispiele

Setzt bei allen gefundenen Dateien den Zeitpunkt der letzten Änderung auf den jetzigen Zeitpunkt.

FileSetTime, , C:\temp\*.txt

Setzt das Änderungsdatum (Uhrzeit wird auf Mitternacht gesetzt).

FileSetTime, 20040122, C:\Meine Dokumente\test.doc

Setzt das Erstellungsdatum. Die Uhrzeit wird auf 16:55 Uhr gesetzt.

FileSetTime, 200401221655, C:\Meine Dokumente\test.doc, C

Ändert das Änderungsdatum aller Dateien gemäß einem Platzhaltermuster. Ordner werden aufgrund des letzten Parameters ebenfalls geändert.

FileSetTime, 20040122165500, C:\Temp\*.*, M, 1