About timezones.xml

The timezones.xml file used by pre-AX-3.3 hosts provides an easily read and edited single definition for each time zone, where all values are contained within quotes "value". For example, consider the following entry for one time zone:

 <zone id="America/Anchorage" utcOffset="-9h"> 
  <display name="Alaska Standard Time" short="AKST"
dstName="Alaska Daylight Time" dstShort="AKDT"/> 
  <dst savings="1h">      <start time="2:00" weekday="sunday"
month="march" week="second"/>      <end time="2:00"
week="first" weekday="sunday" month="november"/> 
  </dst>

where attributes and example values are:

zone id="America/Anchorage" : Name in drop-down selection list when picking a time zone.
utcOffset="-9h" : Time added to UTC for this zone, typically in (h)ours, may be negative, positive, or 0 (i.e. none).
display name="Alaska Standard Time" : Seen somewhere (but where?) when DST not in effect.
short="AKST" : Seen within timestamps (e.g.,alarms and histories) when DST not in effect.
dstName="Alaska Daylight Time" : Seen somewhere (but where?) when DST is in effect.
dstShort="AKDT" : Seen within timestamps (e.g.,alarms and histories) when DST is in effect.
dst savings="1h" : All dst parameters exist only if the time zone has DST. If so, the savings attribute is the DST adjustment amount, typically "1h" (1 hour), in very few time zones is "0.5h".
- start time="2:00" weekday="sunday" month="march" week="second"/ : Specifies the time and day when DST begins, often with "week, weekday, month" method (that is, “Nth weekday”, as shown here.
- end time="2:00" week="first" weekday="sunday" month="november"/ : Specifies the time and day when DST ends, often with a "week, weekday, month" method (that is, “Nth weekday”, as shown here.

Note that there are DST start and end syntax variations different from the ones above.