Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

time::julianday(3pm) [debian man page]

Time::JulianDay(3pm)					User Contributed Perl Documentation				      Time::JulianDay(3pm)

NAME

       Time::JulianDay -- Julian calendar manipulations

SYNOPSIS

	       use Time::JulianDay

	       $jd = julian_day($year, $month_1_to_12, $day)
	       $jd = local_julian_day($seconds_since_1970);
	       $jd = gm_julian_day($seconds_since_1970);
	       ($year, $month_1_to_12, $day) = inverse_julian_day($jd)
	       $dow = day_of_week($jd)

	       print (Sun,Mon,Tue,Wed,Thu,Fri,Sat)[$dow];

	       $seconds_since_jan_1_1970 = jd_secondslocal($jd, $hour, $min, $sec)
	       $seconds_since_jan_1_1970 = jd_secondsgm($jd, $hour, $min, $sec)
	       $seconds_since_jan_1_1970 = jd_timelocal($sec,$min,$hours,$mday,$month_0_to_11,$year)
	       $seconds_since_jan_1_1970 = jd_timegm($sec,$min,$hours,$mday,$month_0_to_11,$year)

DESCRIPTION

       JulianDay is a package that manipulates dates as number of days since some time a long time ago.  It's easy to add and subtract time using
       julian days...

       The day_of_week returned by day_of_week() is 0 for Sunday, and 6 for Saturday and everything else is in between.

ERRATA

       Time::JulianDay is not a correct implementation.  There are two problems.  The first problem is that Time::JulianDay only works with
       integers.  Julian Day can be fractional to represent time within a day.	If you call inverse_julian_day() with a non-integer time, it will
       often give you an incorrect result.

       The second problem is that Julian Days start at noon rather than midnight.  The julian_day() function returns results that are too large by
       0.5.

       What to do about these problems is currently open for debate.  I'm tempted to leave the current functions alone and add a second set with
       more accurate behavior.

       There is another implementation in Astro::Time that may be more accurate.

GENESIS

       Written by David Muir Sharnoff <cpan@dave.sharnoff.org> with help from previous work by Kurt Jaeger aka PI
       <zrzr0111@helpdesk.rus.uni-stuttgart.de>
	    based on postings from: Ian Miller <ian_m@cix.compulink.co.uk>; Gary Puckering <garyp%cognos.uucp@uunet.uu.net>	 based on
       Collected Algorithms of the ACM ?; and the unknown-to-me author of Time::Local.

LICENSE

       Copyright (C) 1996-1999 David Muir Sharnoff.  License hereby granted for anyone to use, modify or redistribute this module at their own
       risk.  Please feed useful changes back to cpan@dave.sharnoff.org.

perl v5.12.3							    2011-05-06						      Time::JulianDay(3pm)

Check Out this Related Man Page

Time::CTime(3)						User Contributed Perl Documentation					    Time::CTime(3)

NAME

       Time::CTime -- format times ala POSIX asctime

SYNOPSIS

	       use Time::CTime
	       print ctime(time);
	       print asctime(localtime(time));
	       print strftime(template, localtime(time));

   strftime conversions
	       %%      PERCENT
	       %a      day of the week abbr
	       %A      day of the week
	       %b      month abbr
	       %B      month
	       %c      ctime format: Sat Nov 19 21:05:57 1994
	       %d      DD
	       %D      MM/DD/YY
	       %e      numeric day of the month
	       %f      floating point seconds (milliseconds): .314
	       %F      floating point seconds (microseconds): .314159
	       %h      month abbr
	       %H      hour, 24 hour clock, leading 0's)
	       %I      hour, 12 hour clock, leading 0's)
	       %j      day of the year
	       %k      hour
	       %l      hour, 12 hour clock
	       %m      month number, starting with 1
	       %M      minute, leading 0's
	       %n      NEWLINE
	       %o      ornate day of month -- "1st", "2nd", "25th", etc.
	       %p      AM or PM
	       %r      time format: 09:05:57 PM
	       %R      time format: 21:05
	       %S      seconds, leading 0's
	       %t      TAB
	       %T      time format: 21:05:57
	       %U      week number, Sunday as first day of week
	       %w      day of the week, numerically, Sunday == 0
	       %W      week number, Monday as first day of week
	       %x      date format: 11/19/94
	       %X      time format: 21:05:57
	       %y      year (2 digits)
	       %Y      year (4 digits)
	       %Z      timezone in ascii. eg: PST

DESCRIPTION

       This module provides routines to format dates.  They correspond to the libc routines.  &strftime() supports a pretty good set of coversions
       -- more than most C libraries.

       strftime supports a pretty good set of conversions.

       The POSIX module has very similar functionality.  You should consider using it instead if you do not have allergic reactions to system
       libraries.

GENESIS

       Written by David Muir Sharnoff <muir@idiom.com>.

       The starting point for this package was a posting by Paul Foley <paul@ascent.com>

LICENSE

       Copyright (C) 1996-1999 David Muir Sharnoff.  License hereby granted for anyone to use, modify or redistribute this module at their own
       risk.  Please feed useful changes back to muir@idiom.com.

perl v5.12.1							    2004-02-08							    Time::CTime(3)
Man Page