NAME
Template::Plugin::DateTime - A Template Plugin To Use DateTime Objects
SYNOPSIS
[% 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 %].
DESCRIPTION
The basic idea to use a DateTime plugin is as follows:
USE date = DateTime(year = 2004, month = 4, day = 1);
It is not meant to be a datetime string parser, just a thin layer on top of DateTime.pm so that you can do datetime arithmetic from within TT.
CONSTRUCTOR
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.
- from_epoch
-
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) %]
- now
-
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') %]
- today
-
Creates a DateTime object by calling DateTime::today(). The value for the c<today> parameter is a boolean value.
[% USE date = DateTime(today = 1) %]
- from_object
-
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) %]
- last_day_of_month
-
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
andmonth
parameters must be specified.[% USE date = DateTime(last_day_of_month = 1, year = 2004, month = 4 ) %]
SEE ALSO
AUTHOR
Copyright 2004 Daisuke Maki <dmaki@cpan.org>. All rights reserved.