



	advanced \| search help

Reference

ActivePython 2.4

Python Documentation

Library Reference

6. Generic Operating System Services

6.1 os -- Miscellaneous operating system interfaces

6.2 os.path -- Common pathname manipulations

6.3 dircache -- Cached directory listings

6.4 stat -- Interpreting stat() results

6.5 statcache -- An optimization of os.stat()

6.6 statvfs -- Constants used with os.statvfs()

6.7 filecmp -- File and Directory Comparisons

6.8 subprocess -- Subprocess management

6.9 popen2 -- Subprocesses with accessible I/O streams

6.10 datetime -- Basic date and time types

6.10.1 Available Types

6.10.2 timedelta Objects

6.10.3 date Objects

6.10.4 datetime Objects

6.10.5 time Objects

6.10.6 tzinfo Objects

6.10.7 strftime() Behavior

6.11 time -- Time access and conversions

6.12 sched -- Event scheduler

6.13 mutex -- Mutual exclusion support

6.14 getpass -- Portable password input

6.15 curses -- Terminal handling for character-cell displays

6.16 curses.textpad -- Text input widget for curses programs

6.17 curses.wrapper -- Terminal handler for curses programs

6.18 curses.ascii -- Utilities for ASCII characters

6.19 curses.panel -- A panel stack extension for curses.

6.20 getopt -- Parser for command line options

6.21 optparse -- More powerful command line option parser

6.22 tempfile -- Generate temporary files and directories

6.23 errno -- Standard errno system symbols

6.24 glob -- Unix style pathname pattern expansion

6.25 fnmatch -- Unix filename pattern matching

6.26 shutil -- High-level file operations

6.27 locale -- Internationalization services

6.28 gettext -- Multilingual internationalization services

6.29 logging -- Logging facility for Python

6.30 platform -- Access to underlying platform's identifying data.

MyASPN >> Reference >> ActivePython 2.4 >> Python Documentation >> Library Reference >> 6. Generic Operating System Services

ActivePython 2.4 documentation

6.10 `datetime` -- Basic date and time types

New in version 2.3.

The datetime module supplies classes for manipulating dates and times in both simple and complex ways. While date and time arithmetic is supported, the focus of the implementation is on efficient member extraction for output formatting and manipulation.

There are two kinds of date and time objects: ``naive'' and ``aware''. This distinction refers to whether the object has any notion of time zone, daylight saving time, or other kind of algorithmic or political time adjustment. Whether a naive datetime object represents Coordinated Universal Time (UTC), local time, or time in some other timezone is purely up to the program, just like it's up to the program whether a particular number represents metres, miles, or mass. Naive datetime objects are easy to understand and to work with, at the cost of ignoring some aspects of reality.

For applications requiring more, datetime and time objects have an optional time zone information member, tzinfo, that can contain an instance of a subclass of the abstract tzinfo class. These tzinfo objects capture information about the offset from UTC time, the time zone name, and whether Daylight Saving Time is in effect. Note that no concrete tzinfo classes are supplied by the datetime module. Supporting timezones at whatever level of detail is required is up to the application. The rules for time adjustment across the world are more political than rational, and there is no standard suitable for every application.

The datetime module exports the following constants:

MINYEAR: The smallest year number allowed in a date or datetime object. MINYEAR is 1.

MAXYEAR: The largest year number allowed in a date or datetime object. MAXYEAR is 9999.