FileSetTime

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

FileSetTime YYYYMMDDHH24MISS, DateiMuster, WelcheZeit, Modus

Parameter

YYYYMMDDHH24MISS

Typ: Zeichenkette

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.

DateiMuster

Typ: Zeichenkette

Wenn 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

Typ: Zeichenkette

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:

Modus

Typ: Zeichenkette

Wenn dieser Parameter weggelassen wird oder leer ist, werden nur Dateien einbezogen und Unterverzeichnisse nicht rekursiv durchwandert. Andernfalls geben Sie einen oder mehrere der folgenden Buchstaben an:

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

Fehlerbehandlung

Es wird ein Error ausgelöst, wenn Dateien nicht geändert werden konnten, wobei dessen Extra-Eigenschaft die Anzahl der Misserfolge enthält.

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 DateAdd und DateDiff 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 DateDiff, um herauszufinden, ob die Zeitdifferenz zwischen den Zeitstempeln positiv oder negativ ist.

FileGetTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, FormatTime, Datei-Schleife, DateAdd, DateDiff

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