2010-03-09: 0.3.0

=================

Date parsing is done simply by instantiating a :class:`chrono.Date` object,

passing the date string to be parsed as input. Once instantiated, the

attributes :attr:`chrono.Date.year`, :attr:`chrono.Date.month`, and

.. doctest::

   >>> date.day

   23

.. doctest::

   (2009, 7, 23)

The default :class:`chrono.parser.CommonParser` parser handles most normal

.. doctest::

   (2009, 7, 1)

In order to parse all valid date formats for a region, you can pass the

.. doctest::

If :class:`chrono.Date` is passed an invalid date it will raise either

:exc:`chrono.error.ParseError` for invalid/unknown format, or a subclass

of :exc:`chrono.error.DateError` (such as :exc:`chrono.error.MonthError`)

.. doctest::

   MonthError: Month '13' not in range 1-12

You can also pass a range of non-string inputs to the class, which will

.. doctest::

documentation.

To parse date strings without instantiating a :class:`chrono.Date` object, you

.. doctest::

affects functionality related to week numbers or week days.

:class:`chrono.Date` has a number of methods for retreiving calendar-related

.. doctest::

   4

To use the US calendar instead, pass the :class:`chrono.calendar.USCalendar`

.. doctest::

If you would like to retreive calendar information without having to

instantiate a :class:`chrono.Date` object, you can use the underlying

.. doctest::

the object will automatically update the attributes to a proper date, by

incrementing or decrementing values as necessary.

.. doctest::

   When the date is on one of the last days of a month, and the :attr:`chrono.Date.month` or

   :attr:`chrono.Date.year` attribute is changed, you may get a result which is in a different

   month than the one you expect. This happens when the day number is out of range

      >>> date = chrono.Date("2009-07-31")

      >>> date.month -= 1

   When :attr:`chrono.Date.month` is set to 6, the date will become 2009-06-31. Since June

   only has 30 days this will trigger the overflow-handling that the date arithmetic relies

      >>> date = chrono.Date("2008-02-29")

      >>> date.year += 1

Date formatting is done via the :meth:`chrono.Date.format` method, which

takes a string containing substitution variables of the form ``$name`` or

.. doctest::

----------

Date comparisons can be done using the normal Python comparison operators: ``==``,

.. doctest::

If the value that is being compared with is not a :class:`chrono.Date` object, it will

be converted to one if possible. This allows for comparisons with strings, UNIX timestamps,

:class:`time.struct_time` or :class:`datetime.date` objects, and any other value that

.. doctest::