Chapter 3: Condition Reference
151
year=
Tests if the year is in the specified range or an exact match. The current year is determined by the date
set on the ProxySG by default. To specify the UTC time zone, use the form year.utc=. Note that the
numeric pattern used to test the year= condition can contain no whitespace.
Syntax
year[.utc]={[first_year]..[last_year]|exact_year}
where:
first_year—Four digits (nnnn) representing the start of a range of years; for example, 2002.
last_year—Four digits (nnnn) representing the end of a range of years. If left blank, all years
from first_year on are assumed.
exact_year—Four digits (nnnn) representing an exact year.
Note: To test against an inverted range of years, the following shorthand expression is available.
While year=(..1998|2003..) specifies years up to and including 1998, and from 2003 on, the
policy language also recognizes year=2003..1998 as equivalent.
Layer and Transaction Notes
Use in all layers.
Using time-related conditions to control caching behavior in a <Cache> layer may cause thrashing
of the cached objects.
Applies to all transactions.
Examples
; Tests for the years 2003 through 2005.
year=2003..2005
See Also
• Conditions: date[.utc]=, day=, hour=, minute=, month=, time=, weekday=, year=