cf.Datetime

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

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

See also

cf.dt, cf.TimeDuration

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.