NAME

DP::Date - Date manipulation support

SYNOPSIS

use DP::Date;

...
...

DESCRIPTION

METHODS

new

$DateObject = DP::Date->new( [ $Date_asString ] )

index of $DateObject [ blessed array ]
0 - date as string
1 - date as time() - secs since epoch
2 - weekday from local time
3 - yearday from local time

asString

$Date_asString = $DateObject->asString( [ $SetDate_asString ] )

Get/Set string-of-numbers formatted value date-time value of $DateObject to $SetDate_asString.

$Date_asString is string of date numbers without any punctuation, thus having the date-time '2003-12-24 20:00:00' produces date asString '20031224200000'

asTime

$Date_asTime = $DateObject->asTime( [ $setDate_asTime | time ] )

Get/Set date-time value of $DateObject to $setDate_asTime.

$Date_asTime is compatible with perl's time(), ( eg. seconds elapsed since 1.1.1970? )

asISO

$Date_asISO = $DateObject->asISO( [ $setDate_asISO ] )

Get/Set ISO formatted date-time value of $DateObject to $setDate_asTime.

$Date_asISO example: 2003-12-24 20:00:00 ( no timezone, no 'T' letter as sometimes used 2003-12-24T20:00:00 )

# MUST be EXACTLY this format: 2002-12-24 12:34:56 (YYYY-MM-DD hh:mm:ss)
# no checking, 2b faster

GetAsISO

$Date_asISO = $DateObject->GetAsISO()

Get ISO formatted value of $DateObject to $setDate_asTime. See also asISO() method.

GetAsArray

@Date_array = $DateObject->GetAsISO()

Get array of values of $DateObject to $setDate_asTime, where @Date_array = ( $YYYY, $MM, $DD, $hh, $mm, $ss ) See also asISO() method.

SetStringAtOffset

$Date_asString = $DateObject->SetStringAtOffset( $offset, $newStringValue )

Example: want to change hour value of $DateObject

my $DateObject = DP::Date->new();
$DateObject->SetStringAtOffset( 8, '20' );   # initial date: 2003-12-24 12:34:56
$Date_asISO = $DateObject->GetAsISO();       # changed hour: 2003-12-24 20:34:56

Offsets: year...... 0 +4 month..... 4 +2 day....... 6 +2 hour...... 8 +2 min....... 10 +2 sec....... 12 +2

Year

Get/Set

$DateObject->Year( [ $YYYY ] )

Month

Get/Set

$MonthNr = $DateObject->Month( [ $Month_name_as_english_3letters_abbr ] )

MonthNr

Get/Set

$MonthNr = $DateObject->MonthNr( [ $Month_as_two_digits_based_JAN_eq_01 ] )

Day

Get/Set

$Day = $DateObject->Day( [ $Day_of_month_as_two_digits ] )

Hour

Get/Set

$Hour = $DateObject->Hour( [ $Hour_as_two_digits ] )

Minute

Get/Set

$Minute = $DateObject->Minute( [ $Minute_as_two_digits ] )

Second

Get/Set

$Second = $DateObject->Second( [ $Second_as_two_digits ] )

GetWeekDay

Get

$GetWeekDay = $DateObject->GetWeekDay

GetYearDay

Get

$GetYearDay = $DateObject->GetYearDay

str2time

see source code, sorry

cmpString

see source code, sorry

isSameDateAs

Compare $DateObject with $anotherDateObject

$bool = $DateObject->isSameDateAs( $anotherDateObject [, $comparingSize ] )

$comparingSize is length of compared date-string .

see also asString and cmpString methods.

GetYearMonthBeginTime

Get the time-value at which the specified month of the year begins. Very usefull! Values are cached as speed improvement.

$time_value = $DateObject->GetYearMonthBeginTime( $YYYY_or_YY_string, $MM_string )

see also asTime method.

EXPORT

nothing

FILES

none

REVISION

project started: 2002/06/04

$Id: Date.pm_rev 1.6 2003/12/12 11:00:15 root Exp root $

AUTHOR

Daniel Peder
<Daniel.Peder@InfoSet.COM>
http://www.infoset.com
Czech Republic national-flag: 
LeftSideBlueTriangleRightSideHorizontalSplitTopWhiteBottomRed

SEE ALSO

other date time modules at CPAN, http://www.CPAN.org