Free datetime software for linux

DateTime is a date and time object.

SYNOPSIS

use DateTime;

$dt = DateTime->new( year => 1964,
month => 10,
day => 16,
hour => 16,
minute => 12,
second => 47,
nanosecond => 500000000,
time_zone => Asia/Taipei,
);

$dt = DateTime->from_epoch( epoch => $epoch );
$dt = DateTime->now; # same as ( epoch => time() )

$year = $dt->year;
$month = $dt->month; # 1-12 - also mon

$day = $dt->day; # 1-31 - also day_of_month, mday

$dow = $dt->day_of_week; # 1-7 (Monday is 1) - also dow, wday

$hour = $dt->hour; # 0-23
$minute = $dt->minute; # 0-59 - also min

$second = $dt->second; # 0-61 (leap seconds!) - also sec

$doy = $dt->day_of_year; # 1-366 (leap years) - also doy

$doq = $dt->day_of_quarter; # 1.. - also doq

$qtr = $dt->quarter; # 1-4

# all of the start-at-1 methods above have correponding start-at-0
# methods, such as $dt->day_of_month_0, $dt->month_0 and so on

$ymd = $dt->ymd; # 2002-12-06
$ymd = $dt->ymd(/); # 2002/12/06 - also date

$mdy = $dt->mdy; # 12-06-2002
$mdy = $dt->mdy(/); # 12/06/2002

$dmy = $dt->dmy; # 06-12-2002
$dmy = $dt->dmy(/); # 06/12/2002

$hms = $dt->hms; # 14:02:29
$hms = $dt->hms(!); # 14!02!29 - also time

$is_leap = $dt->is_leap_year;

# these are localizable, see Locales section
$month_name = $dt->month_name; # January, February, ...
$month_abbr = $dt->month_abbr; # Jan, Feb, ...
$day_name = $dt->day_name; # Monday, Tuesday, ...
$day_abbr = $dt->day_abbr; # Mon, Tue, ...

$epoch_time = $dt->epoch;
# may return undef if the datetime is outside the range that is
# representable by your OSs epoch system.

$dt2 = $dt + $duration_object;

$dt3 = $dt - $duration_object;

$duration_object = $dt - $dt2;

$dt->set( year => 1882 );

$dt->set_time_zone( America/Chicago );

$dt->set_formatter( $formatter );

DateTime is a class for the representation of date/time combinations, and is part of the Perl DateTime project. For details on this project please see http://datetime.perl.org/. The DateTime site has a FAQ which may help answer many "how do I do X?" questions. The FAQ is at http://datetime.perl.org/faq.html.

It represents the Gregorian calendar, extended backwards in time before its creation (in 1582). This is sometimes known as the "proleptic Gregorian calendar". In this calendar, the first day of the calendar (the epoch), is the first day of year 1, which corresponds to the date which was (incorrectly) believed to be the birth of Jesus Christ.

The calendar represented does have a year 0, and in that way differs from how dates are often written using "BCE/CE" or "BC/AD".

For infinite datetimes, please see the DateTime::Infinite module.

Rose::DateTime is a Perl module with DateTime helper functions and objects.

SYNOPSIS

use Rose::DateTime::Util qw(:all);

$now = parse_date(now);
$then = parse_date(12/25/2001 6pm);

$date_text = format_date($then, "%D at %T %p");

...

use Rose::DateTime::Parser;

$parser = Rose::DateTime::Parser->new(time_zone => UTC);

$date = $parser->parse_date(12/25/1999);

The Rose::DateTime::* modules provide a few convenience functions and objects for use with DateTime dates.

Rose::DateTime::Util contains a simple date parser and a slightly customized date formatter.

Rose::DateTime::Parser encapsulates a date parser with an associated default time zone.

This module (Rose::DateTime) exists mostly to provide a version number for CPAN. See the individual modules for some actual documentation.

DateTime::Precise can perform common time and date operations with additional GPS operations.

SYNOPSIS

use DateTime::Precise;

use DateTime::Precise qw(:TimeVars);

# Constructors and ways to set time.
$t1 = DateTime::Precise->new;
$t2 = DateTime::Precise->new(1998. 4. 3 12:13:44.054);
$t3 = DateTime::Precise->new(time() - 100.23456);
$t4 = DateTime::Precise->new(1998.04.24);
$t1->set_localtime_from_epoch_time;
$t1->set_gmtime_from_epoch_time(time + 120.987);
$t1->set_from_datetime(1998.03.23 16:58:14.65);
$t1->set_time(YDHMS, 1998, 177, 9, 15, 26.5);

# This is the same as $d3->set_from_datetime(...)
$t3->dscanf("%^Y.%M.%D %h:%m:%s", "1998.03.25 20:25:23");
if ($msg = $d1->dscanf("%~M", $input)) {
print "error: $msgn";
print "Must enter a three-letter month abbrev.n";
}

# Get different parts of the time.
$year = $t3->year;
$month = $t3->month;
$day = $t3->day;
$hours = $t3->hours;
$minutes = $t3->minutes;
$seconds = $t3->seconds;
($year, $day_of_year) = $t3->get_time(Yj);

# Print times and dates.
print $t2->asctime;
print $t2->strftime(%T %C%n);
print $t2->dprintf("%^Y.%M.%D %h:%m:%s"); # datetime
print $t2->dprintf("%~w %~M %-D %h:%m:%s CST %^Y"); # ctime

# Copy times.
my $t4 = $t2->copy;

# Set one time object to the same time as another: set $t3 equal to $t2.
$t3->clone($t2);

# Find the difference between two times.
$secs_from_midnight = $t4 - $t1;
$secs_from_midnight = $t4->diff($t1);

# Add seconds, days, months, etc to time.
$t1 = $t4 + 3600; # $t1 is now an hour after midnight
$t1->inc_month(2); # add two months to $t1
$t1->floor_month; # set $t1 to the first of the month
$t1 -= 0.25; # subtract 1/4 of a second from $t1

# Can compare and sort DateTime::Precise.
print "Its late!!!" if ($t1 > $t4);
@sorted = sort @birthdays; # normal comparisons work fine

# Get the GPS weeks, seconds and day.
$gps_week = $t1->gps_week;
$gps_seconds = $t1->gps_seconds;
$gps_day = $t1->gps_day;
($gps_week, $gps_seconds, $gps_day) = $t1->gps_week_seconds_day;

Lingua::ZH::DateTime is a Perl module to convert time to chinese format.

SYNOPSIS

This module can convert asctime to chinese format in your locale. you can select china singapore hongkong taiwan locale and gb2312/big5 charset. asctime is ASC C standard format will from localtime like this:

$asctime = localtime();

DateTime::Cron::Simple is a Perl module that can parse a cron entry and check against current time.

SYNOPSIS

use DateTime::Cron::Simple;

$c = DateTime::Cron::Simple->new($cron);

$boolean = $c->validate_time;

$c->new_cron($cron);

This module is a quick and dirty way to determine if a cron time format is valid for the current date and time.

A cron entry follows the cron format from crontab(5).

The validate_time function uses the current date and time for comparison, but will also accept a valid DateTime object as a parameter.

EXAMPLE

use DateTime::Cron::Simple;

$c = DateTime::Cron::Simple->new(0-59/2 10,12 * * 5);

if($c->validate_time) { ... }

$c->new_cron(* * 1 * 0);

if($c->validate_time) { ... }

Rose::DateTime::Util Perl module contains some simple DateTime wrapper functions.

SYNOPSIS

use Rose::DateTime::Util qw(:all);

$now = parse_date(now);
$then = parse_date(12/25/2001 11pm);

print $now->day_of_week; # e.g., "Monday"

# "December 25th 2001 at 11:00:00 PM"
$date_text = format_date($then, "%B %E %Y at %t");

EXPORTS

Rose::DateTime::Util does not export any function names by default.

The all tag:

use Rose::DateTime::Util qw(:all);

will cause the following function names to be imported:

format_date()
parse_date()
parse_epoch()
parse_european_date()

CLASS METHODS

error

Returns a message describing the last error that occurred.

european_dates [BOOL]

Get or set a boolean flag that determines how "xx/xx/xxxx" dates are parsed by the parse_date function. If set to a false-but-defined value, then such dates are parsed as "mm/dd/yyyy". If set to true, then theyre parsed as "dd/mm/yyyy". If set to undef, then the attribute resets to its initial value, which is determined as described below.

The initial value of this attribute is chosen based on the current locale as stored in DateTimes DefaultLocale setting. This initial value is looked up only once. Any subsequent changes to DateTimes DefaultLocale setting will be ignored until/unless this attribute is reset to undef.

time_zone [TZ]

Get or set the default time zone. This value is passed to DateTime->new(...) as the value of the time_zone parameter when parse_date() creates the DateTime object that it returns. The default value is "floating".

DateTime::Format::Epoch is a Perl module that can convert DateTimes to/from epoch seconds.

SYNOPSIS

use DateTime::Format::Epoch;

my $dt = DateTime->new( year => 1970, month => 1, day => 1 );
my $formatter = DateTime::Format::Epoch->new(
epoch => $dt,
unit => seconds,
type => int, # or float, bigint
skip_leap_secondss => 1,
start_at => 0,
local_epoch => undef,
);

my $dt2 = $formatter->parse_datetime( 1051488000 );
# 2003-04-28T00:00:00

$formatter->format_datetime($dt2);
# 1051488000

This module can convert a DateTime object (or any object that can be converted to a DateTime object) to the number of seconds since a given epoch. It can also do the reverse.

DateTime::Calendar::Hebrew is a Perl module with dates in the Hebrew calendar.

SYNOPSIS

use DateTime::Calendar::Hebrew;

$dt = DateTime::Calendar::Hebrew->new( year => 5782,
month => 10,
day => 4 );

DateTime::Calendar::Hebrew is the implementation of the Hebrew calendar. Read on for more details on the Hebrew calendar.