cf.Datetime

class cf.Datetime(year, month=1, day=1, hour=0, minute=0, second=0, microsecond=0, dayofwk=-1, dayofyr=1)[source]

Bases: object

A date-time object which supports CF calendars.

Any date and time valid in any CF calendar is allowed.

In many situations, it may be used interchangeably with a built-in datetime.datetime object. For example:

>>> import datetime
>>> d = cf.Datetime(2004, 2, 30)
>>> d > datetime.datetime(2004, 2, 1)
True

Attributes

Attribute Description
year The year of the date
month The month of the year of the date
day The day of the month of the date
hour The hour of the day of the date
minute The minute of the hour of the date
second The second of the minute of the date
microsecond The microsecond of the second of the date

Initialization

Parameters:
year : int

The year.

month, day, hour, minute, second, microsecond : ints, optional

The month of the year, the day of the month and time of the day. month and day default to 1 and hour; minute, second and microsecond default to 0.

Examples:
>>> cf.Datetime(2003)
<CF Datetime: 2003-01-01 00:00:00>
>>> d = cf.Datetime(2003, 2, 30)
>>> d = cf.Datetime(2003, 2, 30, 0)
>>> d = cf.Datetime(2003, 2, 30, 0, 0)
>>> d = cf.Datetime(2003, 2, 30, 0, 0, 0)
>>> d = cf.Datetime(2003, 4, 5, 12, 30, 15)
>>> d = cf.Datetime(year=2003, month=4, day=5, hour=12, minute=30, second=15)
>>> d.year, d.month, d.day, d.hour, d.minute, d.second
(2003, 4, 5, 12, 30, 15)
>>> d.timetuple()
(2003, 4, 5, 12, 30, 15, -1, 1)

Datetime methods

copy Return a deep copy.
inspect Inspect the attributes.
timetuple Return a tuple of the date-time attributes.

Datetime class methods

utcnow Return the current Gregorian calendar UTC date and time.