@AGEDATE
— Converts
an NTFS file age into a date and time. The returned date and time are
separated with a comma. The date may be returned in
any output date format supported by this
plugin. If no date format is specified, ISO 8601 yyyy-mm-dd format is
used by default.
Syntax:
%@AGEDATE[
age,
fmt,
tfmt,
opt]
age | the number of 100-ns ticks since midnight, January 1, 1601 (Gregorian calendar) |
fmt | the date format used to return the date |
tfmt | the format in which to return the time; defaults to 1408 (24-hour, with milliseconds) |
opt | set to 1 to use T as the date-time separator character, instead of a comma |
The age is the format used in NTFS file stamps, but it might be used for any event within the supported date range.
The tfmt parameter may be 0 to return the time in 24-hour format, or 1 - 12 for a variety of 12-hour formats. Add 128 to include seconds in the output time; add 256 to include milliseconds.
• Incompatibility: Unlike most of
Take Command’s built-in date functions, the native @AGEDATE
allows a very wide (but undocumented) range of dates. My replacement
@AGEDATE
function supports
the same range of dates as all
other functions in this plugin. Ages
corresponding to dates after the year 9999 will fail with an error
message.
See also: @MAKEAGE
,
which performs the reverse function.