ORM::Date - Date handler class.
$date = ORM::Date->new( [ 2006, 1, 25 ] ); print $date->mysql_date,"\n"; $date = $date->diff( [ 0, 0, -2 ] ); print $date->mysql_date,"\n"; The output is: 2006-01-25 2005-11-25
This class introduces minimal interface to handle database table fields of type 'DATE'. It can be used to store time alogn with date, but ORM uses class ORM::Datetime to handle fields of type DATETIME.
ORM::Datetime
Please also consult ORM::Datetime to be sure you know how these classes are used by ORM.
If you want to use another class to handle 'DATE' fields, please consult:
ORM::Tutorial (THIRD PARTY CLASSES)
ORM (_db_type_to_class method).
_db_type_to_class
ORM::Meta.
Create new ORM::Date object as specified in array reference. $year should be exact four digit value. $month is number in range between 1 and 12.
ORM::Date
$year
$month
If some value is out of range then it is treated as in mktime syscall, e.g. [2005,10,15,25,15,00] is the same as [2005,10,16,01,15,00].
mktime
[2005,10,15,25,15,00]
[2005,10,16,01,15,00]
Create date object from value of seconds since epoch (as returned by time). ORM::Date->new_epoch( time ) is the same as ORM::Date->current.
time
ORM::Date->new_epoch( time )
ORM::Date->current
Create date object from MySQL DATE or DATETIME string.
Return seconds since epoch for the date object.
Return 'seconds' part of the date.
Return 'minutes' part of the date.
Return 'hours' part of the date.
Return day of month of the date.
Return day of week of the date. Value is as returned by localtime in list context.
localtime
Return day of year part of the date.
Return month of the date.
Return year of the date.
Return date in MySQL format (YYYY-MM-DD).
Return time part of the date in MySQL format (HH:MM:SS).
Return date and time in MySQL format (YYYY-MM-DD HH:MM:SS).
Return date string as returned by localtime in scalar context.
Change object by resetting its epoch time to $epoch value.
$epoch
Return copy of the object.
Return date object with changes applied as specified in argument. Out of range values for resulting object are handled as in mktime syscall.
Return object itself.
Return ORM::datetime object containing the same date.
ORM::datetime
Class ORM::Date overloads following operators:
'>', '<', '>=', '<=', '==', '!=', '<=>', 'cmp'
ORM::Meta::ORM::Date
ORM::Meta::ORM::Datetime
Alexey V. Akimov
Copyright (C) 2005-2006 Alexey V. Akimov
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
To install ORM, copy and paste the appropriate command in to your terminal.
cpanm
cpanm ORM
CPAN shell
perl -MCPAN -e shell install ORM
For more information on module installation, please visit the detailed CPAN module installation guide.