NAME

Time::Piece::Plus - Subclass of Time::Piece with some useful method

SYNOPSIS

use Time::Piece::Plus;

my $now = localtime();
my $today = Time::Piece::Plus->today;

#As class method
my $today     = Time::Piece::Plus->today;
my $yesterday = Time::Piece::Plus->yesterday;
my $tomorrow  = Time::Piece::Plus->tomorrow;

#As instance method
my $time = Time::Piece::Plus->yesterday;
my $two_days_ago = $time->yesterday;
my $today = $time->tomorrow;

#returns hour truncated object
$time->truncate(to => 'day');

#parse MySQL DATE
my $gm_date    = Time::Piece::Plus->parse_mysql_date(str => "2011-11-26", as_localtime => 0);
my $local_date = Time::Piece::Plus->parse_mysql_date(str => "2011-11-26", as_localtime => 1);
#default is localtime
my $local_date = Time::Piece::Plus->parse_mysql_date(str => "2011-11-26");

#parse MySQL DATETIME
my $gm_datetime    = Time::Piece::Plus->parse_mysql_datetime(str => "2011-11-26 23:28:50", as_localtime => 0);
my $local_datetime = Time::Piece::Plus->parse_mysql_datetime(str => "2011-11-26 23:28:50", as_localtime => 1);
#default is localtime
my $datetime       = Time::Piece::Plus->parse_mysql_datetime(str => "2011-11-26 23:28:50");

DESCRIPTION

Time::Piece::Plus is subclass of Time::Piece with some useful method.

METHODS

today

If called as a class method returns today. Also, if called as an instance method returns the day. And time is cut.

yesterday

If called as a class method returns yesterday. Also, if called as an instance method returns the previous day. And time is cut.

tomorrow

If called as a class method returns tomorrow. Also, if called as an instance method returns the next day. And time is cut.

truncate

Cut the smaller units than those specified. For example, "day" if you will cut the time you specify. 2011-11-26 02:13:22 -> 2011-11-26 00:00:00 Each unit is a minimum cut.

parse_mysql_date

Parse MySQL DATE string like "YYYY-mm-dd". as_localtime is optional, default is 1.

parse_mysql_datetime

Parse MySQL DATETIME string like "YYYY-mm-dd HH:MM:SS". as_localtime is optional, default is 1.

mysql_date

Format MySQL DATE string like "YYYY-mm-dd". If you call a class method and returns the format today. Also, if called as an instance method returns the date and format of the instance.

mysql_datetime

Format MySQL DATE string like "YYYY-mm-dd HH:MM:SS". If you call a class method and returns the format now. Also, if called as an instance method returns the date and format of the instance.

AUTHOR

Nishibayashi Takuji <takuji {at} senchan.jp>

SEE ALSO

Time::Piece,Time::Piece::MySQL

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.