NAME

        Tivoli::DateTime - Perl Extension for Tivoli

SYNOPSIS

        use Tivoli::DateTime;

VERSION

        v0.03

LICENSE

        Copyright (c) 2001 Robert Hase.
        All rights reserved.
        This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 

DESCRIPTION

        This Package will handle about everything you may need for displaying the date / time.
        If anything has been left out, please contact me at
        kmeltz@cris.com , tivoli.rhase@muc-net.de
        so it can be added.

DETAILS

        d = dot, s = slash, m = minus

ROUTINES

        Description of Routines

YYYYMMDD

• DESCRIPTION

          Returns YYYYMMDD

• CALL

          $Var = &YYYYMMDD;

• SAMPLE

          $Var = &YYYYMMDD;
          $Var = 20010804

YYYYMMDDHHMMSS

• DESCRIPTION

          Returns YYYYMMDDHHMMSS

• CALL

          $Var = &YYYYMMDDHHMMSS;

• SAMPLE

          $Var = &YYYYMMDDHHMMSS;
          $Var = 20010804134527

HHdMMdSS

• DESCRIPTION

          Returns HHdMMdSS

• CALL

          $Var = &HHdMMdSS;

• SAMPLE

          $Var = &HHdMMdSS;
          $Var = 13.45.27

YYYYmMMmDD

• DESCRIPTION

          Returns YYYYmMMmDD

• CALL

          $Var = &YYYYmMMmDD;

• SAMPLE

          $Var = &YYYYmMMmDD;
          $Var = 2001-08-04

DDdMMdYYYY

• DESCRIPTION

          Returns DDdMMdYYYY

• CALL

          $Var = &DDdMMdYYYY;

• SAMPLE

          $Var = &DDdMMdYYYY;
          $Var = 04.08.2001

DDmMMmYYYY

• DESCRIPTION

          Returns DDmMMmYYYY

• CALL

          $Var = &DDmMMmYYYY;

• SAMPLE

          $Var = &DDmMMmYYYY;
          $Var = 04-08-2001

EpocheSS

• DESCRIPTION

          Returns EpocheSS since 1970-01-01 00:00.00

• CALL

          $Var = &EpocheSS;

• SAMPLE

          $Var = &EpocheSS;
          $Var = 78762323109843

EpocheSS2DdMdYYYY

• DESCRIPTION

          Converts the given Epoche-Seconds to DdMdYYYY

• CALL

          $Var = &EpocheSS2DdMdYYYY(78762323109843);

• SAMPLE

          $Var = &EpocheSS2DdMdYYYY(78762323109843);
          $Var = 04.08.2001

EpocheSS2DdMdYYYYsHdMdS

• DESCRIPTION

          Converts the given Epoche-Seconds to DdMdYYYYsHdMdS

• CALL

          $Var = &EpocheSS2DdMdYYYYsHdMdS(78762323109843);

• SAMPLE

          $Var = &EpocheSS2DdMdYYYYsHdMdS(78762323109843);
          $Var = 04.08.2001/13.45.27

date_split_dot

• DESCRIPTION

          Splits the given Dot-Date 04.08.2001 to 04 08 2001

• CALL

          $Var = &date_split_dot("04.08.2001");

• SAMPLE

          @Arr = &date_split_dot("04.08.2001");
          @Arr = qw(04 08 2001);

date_split_minus

• DESCRIPTION

          Splits the given Date 04-08-2001 to 04 08 2001

• CALL

          $Var = &date_split_minus("04-08-2001");

• SAMPLE

          @Arr = &date_split_minus("04-08-2001");
          @Arr = qw(04 08 2001);

slash_date

• DESCRIPTION

          Returns MM/DD/YYYY

• CALL

          $Var = &slash_date;

• SAMPLE

          $Var = &slash_date;
          $Var = 04/08/2001;

longDateTime

• DESCRIPTION

          Returns long DateTime

• CALL

          $Var = &longDateTime;

• SAMPLE

          $Var = &longDateTime;
          $Var = Saturday, 08 04, 2001 at 13:45:27

longDate

• DESCRIPTION

          Returns long Date

• CALL

          $Var = &longDate;

• SAMPLE

          $Var = &longDate;
          $Var = Saturday, 08 04, 2001

abr_mon

• DESCRIPTION

          Returns abbreviation of Month

• CALL

          $Var = &abr_mon;

• SAMPLE

          $Var = &abr_mon;
          $Var = Aug

abr_day

• DESCRIPTION

          Returns abbreviation of Day

• CALL

          $Var = &abr_day;

• SAMPLE

          $Var = &abr_day;
          $Var = Sat

month

• DESCRIPTION

          Returns Nr of Month

• CALL

          $Var = &month;

• SAMPLE

          $Var = &month;
          $Var = 08

day

• DESCRIPTION

          Returns Nr of Day

• CALL

          $Var = &day;

• SAMPLE

          $Var = &day;
          $Var = 6

month_num

• DESCRIPTION

          Returns Nr of Month

• CALL

          $Var = &month_num;

• SAMPLE

          $Var = &month_num;
          $Var = 8

day_num

• DESCRIPTION

          Returns Nr of Day

• CALL

          $Var = &day_num;

• SAMPLE

          $Var = &day_num;
          $Var = 6

year

• DESCRIPTION

          Returns Year

• CALL

          $Var = &year;

• SAMPLE

          $Var = &year;
          $Var = 2001

days_left

• DESCRIPTION

          Returns days left in year

• CALL

          $Var = &days_left;

• SAMPLE

          $Var = &days_left;
          $Var = 236

Plattforms and Requirements

        Supported Plattforms and Requirements

* Plattforms

        tested on:

        - w32-ix86 (Win9x, NT4, Windows 2000)
        - aix4-r1 (AIX 4.3)
        - Linux (Kernel 2.2.x)

• Requirements

          requires Perl v5 or higher

HISTORY

        VERSION         DATE            AUTHOR          WORK
        ----------------------------------------------------
        0.01            1999            kmeltz          created
        0.02            2000-08         RHase           several Date / Time Formats
        0.03            2001-08-04      RHase           POD-Doku added

AUTHOR

        kmeltz, Robert Hase
        ID      : KMELTZ, RHASE
        eMail   : kmeltz@cris.com, Tivoli.RHase@Muc-Net.de
        Web     : http://www.Muc-Net.de

SEE ALSO

        CPAN
        http://www.perl.com

cpanm Tivoli

perl -MCPAN -e shell
install Tivoli