"Touches" one or more files in order to update their creation, last modified and/or last accessed date and time with the selected date/time. To specify more than one file, use wildcard characters (* or ?). Often useful to categorize dates/times over a range of files. If your output is a whole tree of files, it can be quicker and more convenient to update the date/time of all files rather than it is to navigate through the whole tree looking at update times.
Declaration
<AMTOUCHFILE FILE="text" CREATIONTIME="date" LASTACCESSTIME="date" LASTWRITETIME="date" TOUCHDATE="YES/NO" />
Example
Touch file(s) "C:\Temp\*.txt". Touch date only. Change creation time to "%DateAdd( "d", -30, CStr( Now() ))%". Change last access time to "%DateSerial(2010,06,01)+TimeSerial(12,06,22)%". Change last write time to "%DateSerial(2010,06,01)+TimeSerial(12,06,22)%". Skip read only file(s).
<AMTOUCHFILE FILE="C:\Temp\*.txt" CREATIONTIME="%DateAdd( "d", -30, CStr( Now() ))%" LASTACCESSTIME="%DateSerial(2010,06,01)+TimeSerial(12,06,22)%" LASTWRITETIME="%DateSerial(2010,06,01)+TimeSerial(12,06,22)%" TOUCHDATE="YES" />
See Also: Split File, Move File, Create Folder, Delete File, Delete Folder, Rename Folder, Remove Folder, Set Attributes, Read from File, Write to File, Synchronize Folders, Concatenate Files, Change Folder
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
File |
Text |
Yes |
(Empty) |
a)FILE="C:\foldername\file.txt" b)FILE="C:\foldername\*.txt" c)FILE="file.txt" |
The file(s) that should be affected by the update. This can be a fully qualified path and file name (preferred) or a file name only (requires use of the Change Folder action). Wildcard characters (* or ?) may be used to specify files matching a certain mask. |
|
Creation Time |
Text |
No |
Disabled |
CREATIONTIME= "%DateSerial(2009,01,01) +TimeSerial(01,10,00)%" |
If enabled, indicates the creation date/time that the specified file(s) should be updated to. Click Custom to select from a list of pre-defined date/time ranges. Enable the Expression parameter to enter a date/time expression. |
|
Last Accessed Time |
Text |
No |
Disabled |
LASTACCCESSTIME= "%DateSerial(2009,01,01) +TimeSerial(01,10,00)%" |
If enabled, indicates the last accessed date/time that the specified file(s) should be updated to. Click Custom to select from a list of pre-defined date/time ranges. Enable the Expression parameter to enter a date/time expression. |
|
Last Write Time |
Text |
No |
Disabled |
LASTWRITETIME= "%DateSerial(2009,01,01) +TimeSerial(01,10,00)%" |
If enabled, indicates the last write (or last modified) date/time that the specified file(s) should be updated to. Click Custom to select from a list of pre-defined date/time ranges. Enable the Expression parameter to enter a date/time expression. |
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Touch Date |
Yes/No |
No |
Yes |
TOUCHDATE="YES" |
If set to YES, specifies that the date portion of the date/time value will be updated. If set to NO, the date portion will be ignored and only the time portion will be updated. This parameter is set to YES by default. |
|
Touch Time |
Yes/No |
No |
Yes |
TOUCHTIME="YES" |
If set to YES, specifies that the time portion of the date/time value will be updated. If set to NO, the time portion will be ignored and only the date portion will be updated. This parameter is set to YES by default. |
|
If file is read-only |
Text |
No |
Disabled |
READONLYFILE="touch" |
Specifies the action that should be performed if the file's attribute is set to read-only. The available options are:
|
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Include Subfolders |
Yes/No |
No |
No |
SUBFOLDERS="YES" |
If set to YES, denotes that, if present, subfolders should be searched for files matching the mask specified in the File parameter. If set to NO (default), subfolders are ignored. |
|
Exclude Mask |
Text |
No |
(Empty) |
ARCHIVETURNOFF="YES" |
Causes this action to omit files matching the mask(s) specified. File names or wildcard masks may be used. |
|
Only if Newer Than |
Date |
No |
Disabled |
ISNEWERTHAN= "%DateSerial(2001,10,12) + TimeSerial(00,00,00)%" |
If enabled, causes this action to only act on files that are newer than the date/time specified. If this parameter is left blank or disabled (default), file dates are ignored. Click Custom to select from a list of pre-defined date parameters. Enable the Expression option to allow entry of a date/time expression. |
|
Only if Older Than |
Date |
No |
Disabled |
ISOLDERTHAN= "%DateSerial(2001,10,12) + TimeSerial(00,00,00)%" |
If enabled, causes this action to only act on files that are older than the date/time specified. If this parameter is left blank or disabled (default), file dates are ignored. Click Custom to select from a list of pre-defined date parameters. Enable the Expression option to allow entry of a date/time expression. |
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Attributes |
Text Options |
No |
(Empty) |
ATTRFILTER="+R+A-H" (delete read-only & archive files but not hidden files) |
This group of settings causes this action to filter which files are deleted based on the attribute settings of the source file(s). In visual mode, a group of controls are provided to assist in the selection of this parameter. In markup mode, a single text item must be specified that contains the attributes of the files you want to delete. Available Options:
|