Michael Graham > Palm-Progect > Palm::Progect::Date

Download:
Palm-Progect-2.0.4.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source  

NAME ^

Palm::Progect::Date - utility routines for converting dates

SYNOPSIS ^

    use Palm::Progect::Date;

    $date_due = parse_date('2038/12/31', 'yyyy/mm/dd');
    $date_due = parse_date('12-31-38', 'mm-dd-yy');

    my $formatted_date = format_date($time_in_unix_format, 'yyyy/mm/dd');

DESCRIPTION ^

These routines are used by the Palm::Progect::* modules to parse and format dates.

SUBROUTINES ^

format_date($time, $date_format)

Given a time in Unix format (i.e. seconds since the epoch), return a string representation of the date based on the given format:

    my $formatted_date = format_date($time_in_unix_format, 'yyyy/mm/dd');

    print format_date(0, 'yyyy-mm-dd'); # prints "1969-12-31"

The format can include the following symbols:

yyyy

Four digit year

yy

Last two digits of year

mm

Month number

dd

Day number

parse_date($date_string, $date_format)

Attempt to parse $date_string as a textual representation of a date, using template supplied in $date_format:

    my $time = parse_date('2038/10/24', 'yyyy/mm/dd')

    print parse_date('12-31, 1969', 'mm-dd, yyyy'); # prints 0

No attempt is made to guess the format of $date_string; it is assumed that you know its format.

$date_format can include the following symbols:

yyyy

Four digit year

yy

Last two digits of year

mm

Month number

dd

Day number

BUGS and CAVEATS ^

The two digit date format will fail for dates before 1950 or after 2049 :).

AUTHOR ^

Michael Graham <mag-perl@occamstoothbrush.com>

Copyright (C) 2002-2005 Michael Graham. All rights reserved. This program is free software. You can use, modify, and distribute it under the same terms as Perl itself.

The latest version of this module can be found on http://www.occamstoothbrush.com/perl/

SEE ALSO ^

progconv

Palm::PDB(3)

http://progect.sourceforge.net/

syntax highlighting: