NAME
Win32::FileTime - Perl module for accessing Win32 file times
SYNOPSIS
use Win32::FileTime;
my $filename = "foo.txt";
my $filetime = Win32::FileTime->new( $filename );
printf(
"Accessed : %4d/%02d/%02d %02d:%02d:%02d",
$filetime->Access(
'year',
'month',
'day',
'hour',
'minute',
'second'
)
);
DESCRIPTION
This module is designed to provide an easy-to-use interface for
obtaining creation, access and modification times for files on Win32
systems.
METHODS
The following methods are available through this module for use with
Win32::FileTime objects. No methods can be exported into the calling
namespace.
new
my $filetime = Win32::FileTime->new( $filename );
This object constructor creates and returns a new Win32::FileTime
object. The only mandatory argument to this object constructor is a
relative or absolute file path. It is the creation, access and
modification times of this file which are obtained and returned by
this Win32::FileTime object.
Access( @arguments )
my @AccessTime = $filetime->Access( @arguments );
This method returns an array corresponding to the last access time
of the file specified in the object constructor.
Create( @arguments )
my @CreateTime = $filetime->Create( @arguments );
This method returns an array corresponding to the creation time of
the file specified in the object constructor.
Modify( @arguments )
my @ModifyTime = $filetime->Modify( @arguments );
This method returns an array corresponding to the modification time
of the file specified in the object constructor.
The arguments to these methods can be any combination of the following
list of time field arguments - "year", "month", "wday", "day", "hour",
"minute", "second" and "msecond". The passing of any of these time field
arguments to Win32::FileTime methods returns the respective time field
in the order passed to the object method.
If no arguments are specified, the entire array of time fields is
returned in the order defined above.
VERSION
0.04
AUTHOR
Frank Bardelli, Rob Casey