Completed time related attribute renaming tokens.
1 parent f7e34c7 commit d0dae89ec34b1cd42e03bc77d66576b42e741012
@tundra tundra authored on 5 Apr 2010
Showing 1 changed file
View
98
tren.rst
This is updated whenever the file- or directory is closed after
modification.
 
**tren** implements a set of time-related file attribute renaming
tokens intended to provide full access to these various timestamps. They
are identically named, except that the first letter of each of the
time-related attribute tokens indicates which of the three timestamps
above is used to compute the value:
 
 
``/ADAY/, /CDAY/, /MDAY/ Returns File- Or Directory's``
 
Explanation
 
``/AHOUR, /CHOUR/, /MHOUR/ Returns File- Or Directory's``
 
Explanation
 
``/AMIN/, /CMIN/, /MMIN/ Returns File- Or Directory's``
 
Explanation
 
``/AMON/, /CMON/, /MMON/ Returns File- Or Directory's``
 
Explanation
 
``/AMONT, /CMONTH/, /MMONTH/ Returns File- Or Directory's``
 
Explanation
 
``/ASEC/, /CSEC/, /MSEC/ Returns File- Or Directory's``
 
Explanation
 
``/AWDAY, /CWDAY/, /MWDAY/ Returns File- Or Directory's``
 
Explanation
 
``/AYEAR, /CYEAR/, /MYEAR/ Returns File- Or Directory's``
 
Explanation
tokens intended to provide full access to these various timestamps.
As a practical matter, you're most likely to use the ``MTIME``-based
tokens, but components for all three time values are available should
you need them. They are identically named, except that the first
letter of each of the time-related attribute tokens indicates which of
the three timestamps above is used to compute the value:
 
 
``/ADAY/, /CDAY/, /MDAY/ Returns Timestamp's Day Of The Month``
 
Returns the day of the month of the timestamp in ``dd`` format.
 
``/AHOUR, /CHOUR/, /MHOUR/ Returns Timestamp's Hour Of The Day``
 
Returns the hour of the day of the timestamp in ``hh`` format.
 
``/AMIN/, /CMIN/, /MMIN/ Returns Timestamp's Minute Of The Hour``
 
Returns the minute of the hour of the timestamp in ``mm`` format.
 
``/AMON/, /CMON/, /MMON/ Returns Timestamp's Month Of The Year``
 
Returns the month of the year of the timestamp in ``mm`` format
 
``/AMONTH, /CMONTH/, /MMONTH/ Returns Timestamp's Name Of The Month``
 
Returns the name of the month of the timestamp in ``Nnn`` format.
 
``/ASEC/, /CSEC/, /MSEC/ Returns Timestamp's Seconds Of The Minute``
 
Returns the seconds of the minute of the timestamp in ``ss`` format.
 
``/AWDAY, /CWDAY/, /MWDAY/ Returns Timestamp's Name Of The Day``
 
Returns the name of the day of the timestamp in ``Ddd`` format.
 
``/AYEAR, /CYEAR/, /MYEAR/ Returns Timestamp's Year``
 
Returns the year of the timestamp in ``yyyy`` format.
 
 
So, for example::
 
tren.py -r=/FNAME/-/MYEAR/-/MMON/-/MDAY/-/MMONTH/-/MWDAY/-/MHOUR/:/MMIN/:/MSEC/ foo
 
Might rename the file to something like::
 
foo-2005-01-07-Jan-Fri-01:23:33
 
 
System Renaming Tokens
======================
-----------------------------
 
::
 
$Id: tren.rst,v 1.173 2010/04/05 19:31:25 tundra Exp $
$Id: tren.rst,v 1.174 2010/04/05 19:54:03 tundra Exp $
 
You can find the latest version of this program at:
 
http://www.tundraware.com/Software/tren