55 lines
1.4 KiB
Perl
55 lines
1.4 KiB
Perl
package WebGUI::Macro::D_date;
|
|
|
|
#-------------------------------------------------------------------
|
|
# WebGUI is Copyright 2001-2009 Plain Black Corporation.
|
|
#-------------------------------------------------------------------
|
|
# Please read the legal notices (docs/legal.txt) and the license
|
|
# (docs/license.txt) that came with this distribution before using
|
|
# this software.
|
|
#-------------------------------------------------------------------
|
|
# http://www.plainblack.com info@plainblack.com
|
|
#-------------------------------------------------------------------
|
|
|
|
use strict;
|
|
|
|
=head1 NAME
|
|
|
|
Package WebGUI::Macro::D_date
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
Macro for displaying dates formatted for reading by people using $session->datetime->epochToHuman().
|
|
|
|
=head2 process ( format string, [ date ] )
|
|
|
|
=head3 format string
|
|
|
|
A string specifying how to format the date using codes similar to those used by
|
|
sprintf. See L<WebGUI::Session::datetime/"epochToHuman"> for a list of codes.
|
|
|
|
=head3 date
|
|
|
|
An optional date in epoch format. If the date is omitted, then the present
|
|
time is used instead.
|
|
|
|
=cut
|
|
|
|
|
|
#-------------------------------------------------------------------
|
|
sub process {
|
|
my $session = shift;
|
|
my $time = $_[1];
|
|
if (! defined $time) {
|
|
$time = time();
|
|
}
|
|
else {
|
|
$time =~ s/^\s+//;
|
|
$time =~ s/\s+$//;
|
|
}
|
|
my $temp = $session->datetime->epochToHuman($time, $_[0]);
|
|
return $temp;
|
|
}
|
|
|
|
|
|
1;
|
|
|