time | index /System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/lib-dynload/time.so Module Docs

`This module provides various functions to manipulate time values.
There are two standard representations of time. One is the number
of seconds since the Epoch, in UTC (a.k.a. GMT). It may be an integer
or a floating point number (to represent fractions of seconds).
The Epoch is system-defined; on Unix, it is generally January 1st, 1970.
The actual value can be retrieved by calling gmtime(0).
The other representation is a tuple of 9 integers giving local time.
The tuple items are:
year (four digits, e.g. 1998)
month (1-12)
day (1-31)
hours (0-23)
minutes (0-59)
seconds (0-59)
weekday (0-6, Monday is 0)
Julian day (day in the year, 1-366)
DST (Daylight Savings Time) flag (-1, 0 or 1)
If the DST flag is 0, the time is given in the regular time zone;
if it is 1, the time is given in the DST time zone;
if it is -1, mktime() should guess based on the date and time.
Variables:
timezone -- difference in seconds between UTC and local standard time
altzone -- difference in seconds between UTC and local DST time
daylight -- whether local time should reflect DST
tzname -- tuple of (standard time zone name, DST time zone name)
Functions:
time() -- return current time in seconds since the Epoch as a float
clock() -- return CPU time since process start as a float
sleep() -- delay for a number of seconds given as a float
gmtime() -- convert seconds since Epoch to UTC tuple
localtime() -- convert seconds since Epoch to local time tuple
asctime() -- convert time tuple to string
ctime() -- convert time in seconds to string
mktime() -- convert local time tuple to seconds since Epoch
strftime() -- convert time tuple to string according to format specification
strptime() -- parse string to time tuple according to format specification
tzset() -- change the local timezone`

Classes

``

__builtin__.object
  struct_time

class struct_time(__builtin__.object)

``

Methods defined here:

__add__(...)
  `x.__add__(y) <==> x+y`

__contains__(...)
  `x.__contains__(y) <==> y in x`

__eq__(...)
  `x.__eq__(y) <==> x==y`

__ge__(...)
  `x.__ge__(y) <==> x>=y`

__getitem__(...)
  `x.__getitem__(y) <==> x[y]`

__getslice__(...)
  `x.__getslice__(i, j) <==> x[i:j]
  Use of negative indices is not supported.`

__gt__(...)
  `x.__gt__(y) <==> x>y`

__hash__(...)
  `x.__hash__() <==> hash(x)`

__le__(...)
  `x.__le__(y) <==> x<=y`

__len__(...)
  `x.__len__() <==> len(x)`

__lt__(...)
  `x.__lt__(y) <==> x<y`

__mul__(...)
  `x.__mul__(n) <==> x*n`

__ne__(...)
  `x.__ne__(y) <==> x!=y`

__reduce__(...)

__repr__(...)
  `x.__repr__() <==> repr(x)`

__rmul__(...)
  `x.__rmul__(n) <==> n*x`

Data descriptors defined here:

tm_hour

tm_isdst

tm_mday

tm_min

tm_mon

tm_sec

tm_wday

tm_yday

tm_year

Data and other attributes defined here:

__new__ = <built-in method __new__ of type object at 0x1005b3560>
  `T.__new__(S, ...) -> a new object with type S, a subtype of T`

n_fields = 9

n_sequence_fields = 9

n_unnamed_fields = 0

Functions

``

asctime(...)
  `asctime([tuple]) -> string
  Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'.
  When the time tuple is not present, current time as returned by localtime()
  is used.`

clock(...)
  `clock() -> floating point number
  Return the CPU time or real time since the start of the process or since
  the first call to clock(). This has as much precision as the system
  records.`

ctime(...)
  `ctime(seconds) -> string
  Convert a time in seconds since the Epoch to a string in local time.
  This is equivalent to asctime(localtime(seconds)). When the time tuple is
  not present, current time as returned by localtime() is used.`

gmtime(...)
  `gmtime([seconds]) -> (tm_year, tm_mon, tm_mday, tm_hour, tm_min,
  tm_sec, tm_wday, tm_yday, tm_isdst)
  Convert seconds since the Epoch to a time tuple expressing UTC (a.k.a.
  GMT). When 'seconds' is not passed in, convert the current time instead.`

localtime(...)
  `localtime([seconds]) -> (tm_year,tm_mon,tm_mday,tm_hour,tm_min,
  tm_sec,tm_wday,tm_yday,tm_isdst)
  Convert seconds since the Epoch to a time tuple expressing local time.
  When 'seconds' is not passed in, convert the current time instead.`

mktime(...)
  `mktime(tuple) -> floating point number
  Convert a time tuple in local time to seconds since the Epoch.`

sleep(...)
  `sleep(seconds)
  Delay execution for a given number of seconds. The argument may be
  a floating point number for subsecond precision.`

strftime(...)
  `strftime(format[, tuple]) -> string
  Convert a time tuple to a string according to a format specification.
  See the library reference manual for formatting codes. When the time tuple
  is not present, current time as returned by localtime() is used.`

strptime(...)
  `strptime(string, format) -> struct_time
  Parse a string to a time tuple according to a format specification.
  See the library reference manual for formatting codes (same as strftime()).`

time(...)
  `time() -> floating point number
  Return the current time in seconds since the Epoch.
  Fractions of a second may be present if the system clock provides them.`

tzset(...)
  `tzset(zone)
  Initialize, or reinitialize, the local timezone to the value stored in
  os.environ['TZ']. The TZ environment variable should be specified in
  standard Unix timezone format as documented in the tzset man page
  (eg. 'US/Eastern', 'Europe/Amsterdam'). Unknown timezones will silently
  fall back to UTC. If the TZ environment variable is not set, the local
  timezone is set to the systems best guess of wallclock time.
  Changing the TZ environment variable without calling tzset *may* change
  the local timezone used by methods such as localtime, but this behaviour
  should not be relied on.`

Data
`` |  | accept2dyear = 1 altzone = 25200 daylight = 1 timezone = 28800 tzname = ('PST', 'PDT')