datetime(3) [debian man page]

datetime(3)						     Library Functions Manual						       datetime(3)

NAME

       datetime - convert between TAI labels and seconds

SYNTAX

       #include <datetime.h>

       void datetime_tai(&dt,t);

       datetime_sec datetime_untai(&dt);

       struct datetime dt;
       datetime_sec t;

DESCRIPTION

       International  Atomic  Time,  TAI, is the fundamental unit for time measurements.  TAI has one label for every second of real time, without
       complications such as leap seconds.

       A struct datetime variable, such as dt, stores a TAI label.  dt.year is the year number minus 1900; dt.mon is  the  month  number,  from  0
       (January)  through 11 (December); dt.mday is the day of the month, from 1 through 31; dt.hour is the hour, from 0 through 23; dt.min is the
       minute, from 0 through 59; dt.sec is the second, from 0 through 59; dt.wday is the day of the week, from 0 (Sunday) through  6  (Saturday);
       dt.yday is the day of the year, from 0 through 365.

       The  datetime library supports more convenient TAI manipulation with the datetime_sec type.  A datetime_sec value, such as t, is an integer
       referring to the tth second after the beginning of 1970 TAI.  The first second of 1970 TAI was 0; the next second was 1; the last second of
       1969 TAI was -1.  The difference between two datetime_sec values is a number of real-time seconds.

       datetime_tai converts a datetime_sec to a TAI label.

       datetime_untai reads a TAI label (specifically dt.year, dt.mon, dt.mday, dt.hour, dt.min, and dt.sec) and returns a datetime_sec.

SEE ALSO

       now(3)

																       datetime(3)

POSIX::strptime(3pm)					User Contributed Perl Documentation				      POSIX::strptime(3pm)

NAME

       POSIX::strptime - Perl extension to the POSIX date parsing strptime(3) function

SYNOPSIS

	($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = POSIX::strptime("string", "Format");

DESCRIPTION

       Perl interface to strptime(3)

FUNCTIONS

       strptime
	    ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = POSIX::strptime(string, format);

	   The result for any value not extracted is not defined. Some platforms may reliably return "undef", but this is dependent on the
	   strptime(3) function in the underlying C library.

	   For example, only the following fields may be relied upon:

	    my ($min, $hour) = ( POSIX::strptime( "01:23", '%H:%M' ) )[1,2];

	    my ($mday, $mon, $year) = ( POSIX::strptime( "2010/07/16", '%Y/%m/%d' ) )[3,4,5];

	   Furthermore, not all platforms will set the $wday and $yday elements. If these values are required, use "mktime" and "gmtime":

	    use POSIX qw( mktime );
	    use POSIX::strptime qw( strptime );

	    my ($mday, $mon, $year) = ( POSIX::strptime( "2010/07/16", '%Y/%m/%d' ) )[3,4,5];
	    my $wday = ( gmtime mktime 0, 0, 0, $mday, $mon, $year )[6];

SEE ALSO

       strptime(3)

AUTHOR

       Philippe M. Chiasson <gozer@cpan.org> Kim Scheibel <kim@scheibel.co.uk>

REPOSITORY

       http://svn.ectoplasm.org/projects/perl/POSIX-strptime/trunk/

COPYRIGHT

       Copyright 2005 by Philippe M. Chiasson <gozer@cpan.org>.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See http://www.perl.com/perl/misc/Artistic.html

perl v5.14.2							    2010-07-16						      POSIX::strptime(3pm)