Template::Plugin::DateTime - A Template Plugin To Use DateTime Objects
[% USE date = DateTime(year = 2004, month = 4, day = 1) %] [% USE date = DateTime(today = 1) %] Today is [% date.year %]/[% date.month %]/[% date.day %]. [% date.add(days => 32) %] 32 days from today is [% date.year %]/[% date.month %]/[% date.day %].
The basic idea to use a DateTime plugin is as follows:
USE date = DateTime(year = 2004, month = 4, day = 1);
-OR-
by passing a pattern to parse a date by string using DateTime::Format::Strptime
USE date = DateTime(from_string => '2008-05-30 00:00:00', pattern => '%Y-%m-%d %H:%M:%S', time_zone => 'America/New_York');
This is used internally. You won't be using it from your templates.
The constructor is exactly the same as that of Datetime.pm, except you can pass optional parameters to it to toggle between different underlying DateTime constructors.
Creates a Datetime object by calling DateTime::from_epoch(). The value for the from_epoch parameter must be a number representing UNIX epoch.
[% epoch = ... %] [% USE date = DateTime(from_epoch = epoch) %]
Creates a DateTime object by calling DateTime::now(). The value for the c<now> parameter is a boolean value.
[% USE date = DateTime(now = 1) %] [% USE date = Datetime(now = 1, time_zone => 'Asia/Tokyo') %]
Creates a DateTime object by calling DateTime::today(). The value for the c<today> parameter is a boolean value.
[% USE date = DateTime(today = 1) %]
Creates a DateTime object by calling DateTime::from_object(). The value for the from_object must be an object implementing the utc_rd_values() method, as described in DateTime.pm
[% USE date = DateTime(from_object = other_date) %]
Creates a DateTime object by calling DateTime::last_day_of_month(). The value for the c<last_day_of_month> parameter is a boolean value, and year and month parameters must be specified.
year
month
[% USE date = DateTime(last_day_of_month = 1, year = 2004, month = 4 ) %]
Creates a DateTime object by calling DateTime::Format::Strptime The value for the c<from_string> parameter is a string value, and pattern parameters is optional and defaults to '%Y-%m-%d %H:%M:%S'. See DateTime::Format::Strptime for other optional parameters.
pattern
[% USE date = DateTime(from_string => '2008-05-30 10:00:00', pattern => '%Y-%m-%d %H:%M:%S') %]
DateTime DateTime::Format::Strptime Template
Copyright (c) 2004-2007 Daisuke Maki <daisuke@endeworks.jp>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://www.perl.com/perl/misc/Artistic.html
To install Template::Plugin::DateTime, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Template::Plugin::DateTime
CPAN shell
perl -MCPAN -e shell install Template::Plugin::DateTime
For more information on module installation, please visit the detailed CPAN module installation guide.