cf.year

cf.year(value)[source]

Return a cf.Query object for date-time years.

In this context, any object which has a year attribute is considered to be a date-time variable.

If value is a cf.Query object then cf.year(value) is equivalent to value.addattr('year'). Otherwise cf.year(value) is equivalent to cf.eq(value, attr='year').

Parameters:
value :

Either the value that the year is to be compared with, or a cf.Query object for testing the year.

Returns:
out : cf.Query

The query object.

Examples:
>>> d = cf.dt(2002, 6, 16)
>>> d == cf.year(2002)
True
>>> d == cf.year(cf.le(2003))
True
>>> d == cf.year(2001)
False
>>> d == cf.year(cf.wi(2003, 2006))
False