merge 2.4.0 into master

CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
 - Unreleased
+- 2.4.0 (2024-12-13, TZDB version 2024b)
+    - Support new `%z` value in FORMAT column.
+    - Upgrade TZDB to 2024b
+        - https://lists.iana.org/hyperkitty/list/tz-announce@iana.org/thread/IZ7AO6WRE3W3TWBL5IR6PMQUL433BQIE/
+        - "Improve historical data for Mexico, Mongolia, and Portugal. System V
+          names are now obsolescent. The main data form now uses %z. The code
+          now conforms to RFC 8536 for early timestamps. Support POSIX.1-2024,
+          which removes asctime_r and ctime_r. Assume POSIX.2-1992 or later for
+          shell scripts. SUPPORT_C89 now defaults to 1."
 - 2.3.2 (2024-07-25, TZDB version 2024a)
     - Upgrade TZDB to 2024a
         - https://mm.icann.org/pipermail/tz-announce/2024-February/000081.html

DEVELOPER.md

@@ -123,7 +123,7 @@ implementations defined, corresponding to different resolution levels supported
 by each set:
 
 * `ZoneInfoLow.h`
-    * low resolution
+    * low resolution persistence format
         * 1-minute resolution for AT, UNTIL, STDOFF; 15-minute resolution for
           DST offsets
         * year fields using 1-byte offset from a `baseYear` of 2100,
@@ -136,7 +136,7 @@ by each set:
 * `ZoneInfoMid.h`
     * medium resolution persistence format
         * 1-minute resolution for AT, UNTIL, STDOFF; 15-minute resolution for
-          DST offset)
+          DST offset
         * 2-byte year fields supporting years `[-32767,32765]`
     * `zoneinfomid::ZoneContext<>`
     * `zoneinfomid::ZoneRule<>`

README.md

@@ -76,7 +76,7 @@ and the `zonedbc` database to support all timezones, for all transitions defined
 in the IANA TZ database (`[1844,2087]`), and extending the validity of timezone
 calculations from `[2000,10000)` to `[0001,10000)`.
 
-**Version**: 2.3.2 (2024-07-25, TZDB version 2024a)
+**Version**: 2.4.0 (2024-12-13, TZDB version 2024b)
 
 **Changelog**: [CHANGELOG.md](CHANGELOG.md)
 

USER_GUIDE.md

@@ -18,7 +18,7 @@ The IANA TZ database is programmatically generated into 3 predefined databases:
 databases have different accuracy ranges, and are designed to work with
 different `ZoneProcessor` and `ZoneManager` classes.
 
-**Version**: 2.3.2 (2024-07-25, TZDB 2024a)
+**Version**: 2.4.0 (2024-12-13, TZDB 2024b)
 
 **Related Documents**:
 

docs/doxygen.cfg

@@ -38,7 +38,7 @@ PROJECT_NAME           = AceTime
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 2.3.0
+PROJECT_NUMBER         = 2.4.0
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

docs/html/BasicZone_8cpp_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BasicZone_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>
@@ -144,7 +144,7 @@
 <div class="ttc" id="aclassace__time_1_1zoneinfolow_1_1ZoneContextBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfolow_1_1ZoneContextBroker.html">ace_time::zoneinfolow::ZoneContextBroker</a></div><div class="ttdoc">Data broker for accessing a ZoneContext.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersLow_8h_source.html#l00091">BrokersLow.h:91</a></div></div>
 <div class="ttc" id="aclassace__time_1_1zoneinfolow_1_1ZoneEraBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfolow_1_1ZoneEraBroker.html">ace_time::zoneinfolow::ZoneEraBroker</a></div><div class="ttdoc">Data broker for accessing ZoneEra.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersLow_8h_source.html#l00297">BrokersLow.h:297</a></div></div>
 <div class="ttc" id="aclassace__time_1_1zoneinfolow_1_1ZoneInfoBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfolow_1_1ZoneInfoBroker.html">ace_time::zoneinfolow::ZoneInfoBroker&lt; ZoneContext, ZoneInfo, ZoneEra, ZonePolicy, ZoneRule &gt;</a></div></div>
-<div class="ttc" id="astructace__time_1_1zoneinfolow_1_1ZoneInfo_html"><div class="ttname"><a href="structace__time_1_1zoneinfolow_1_1ZoneInfo.html">ace_time::zoneinfolow::ZoneInfo</a></div><div class="ttdoc">Representation of a given time zone, implemented as an array of ZoneEra records.</div><div class="ttdef"><b>Definition:</b> <a href="ZoneInfoLow_8h_source.html#l00302">ZoneInfoLow.h:302</a></div></div>
+<div class="ttc" id="astructace__time_1_1zoneinfolow_1_1ZoneInfo_html"><div class="ttname"><a href="structace__time_1_1zoneinfolow_1_1ZoneInfo.html">ace_time::zoneinfolow::ZoneInfo</a></div><div class="ttdoc">Representation of a given time zone, implemented as an array of ZoneEra records.</div><div class="ttdef"><b>Definition:</b> <a href="ZoneInfoLow_8h_source.html#l00320">ZoneInfoLow.h:320</a></div></div>
 </div><!-- fragment --></div><!-- contents -->
 <!-- start footer part -->
 <hr class="footer"/><address class="footer"><small>

docs/html/BrokerCommon_8cpp_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BrokerCommon_8h.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BrokerCommon_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BrokersHigh_8h.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>
@@ -75,14 +75,14 @@
 </div><!--header-->
 <div class="contents">
 
-<p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoHigh_8h_source.html">ZoneInfoHigh.h</a></code>.  
+<p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoHigh_8h.html" title="Data structures that encodes the high resolution zoneinfo database persistence format.">ZoneInfoHigh.h</a></code>.  
 <a href="#details">More...</a></p>
 <div class="textblock"><code>#include &lt;stdint.h&gt;</code><br />
 <code>#include &lt;Arduino.h&gt;</code><br />
 <code>#include &lt;AceCommon.h&gt;</code><br />
 <code>#include &quot;<a class="el" href="compat_8h_source.html">compat.h</a>&quot;</code><br />
 <code>#include &quot;<a class="el" href="BrokerCommon_8h_source.html">BrokerCommon.h</a>&quot;</code><br />
-<code>#include &quot;ZoneInfoHigh.h&quot;</code><br />
+<code>#include &quot;<a class="el" href="ZoneInfoHigh_8h_source.html">ZoneInfoHigh.h</a>&quot;</code><br />
 </div><div class="textblock"><div class="dynheader">
 Include dependency graph for BrokersHigh.h:</div>
 <div class="dyncontent">
@@ -94,7 +94,7 @@
 <area shape="rect" title=" " alt="" coords="139,95,257,121"/>
 <area shape="rect" href="compat_8h.html" title="Macros and definitions that provide a consistency layer among the various Arduino boards for compatib..." alt="" coords="587,95,670,121"/>
 <area shape="rect" href="BrokerCommon_8h.html" title="Helper functions are used in both Basic brokers and Extended brokers." alt="" coords="281,95,416,121"/>
-<area shape="rect" href="ZoneInfoHigh_8h_source.html" title=" " alt="" coords="441,95,563,121"/>
+<area shape="rect" href="ZoneInfoHigh_8h.html" title="Data structures that encodes the high resolution zoneinfo database persistence format." alt="" coords="441,95,563,121"/>
 <area shape="rect" title=" " alt="" coords="491,169,561,196"/>
 <area shape="rect" title=" " alt="" coords="586,169,671,196"/>
 <area shape="rect" title=" " alt="" coords="695,169,797,196"/>
@@ -175,7 +175,7 @@
 <tr class="separator:a4f2137b865f26ef213c9712e1ed7a7f2"><td class="memSeparator" colspan="2">&#160;</td></tr>
 </table>
 <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
-<div class="textblock"><p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoHigh_8h_source.html">ZoneInfoHigh.h</a></code>. </p>
+<div class="textblock"><p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoHigh_8h.html" title="Data structures that encodes the high resolution zoneinfo database persistence format.">ZoneInfoHigh.h</a></code>. </p>
 <p>The zoneinfo files are stored in flash memory (using the PROGMEM keyword), and cannot be accessed directly on microcontrollers using the Harvard architecture (e.g. AVR) where data and program live in 2 different address spaces. The data in flash memory must be accessed using helper routines in &lt;pgmspace.h&gt;. These classes abstract away this difference so that the code BasicZoneProcessor and ExtendedZoneProcessor can be written to be (mostly) agnostic to how the zoneinfo files are stored. </p>
 
 <p class="definition">Definition in file <a class="el" href="BrokersHigh_8h_source.html">BrokersHigh.h</a>.</p>

docs/html/BrokersHigh_8h__incl.map

@@ -5,7 +5,7 @@
 <area shape="rect" id="node4" title=" " alt="" coords="139,95,257,121"/>
 <area shape="rect" id="node5" href="$compat_8h.html" title="Macros and definitions that provide a consistency layer among the various Arduino boards for compatib..." alt="" coords="587,95,670,121"/>
 <area shape="rect" id="node9" href="$BrokerCommon_8h.html" title="Helper functions are used in both Basic brokers and Extended brokers." alt="" coords="281,95,416,121"/>
-<area shape="rect" id="node10" href="$ZoneInfoHigh_8h_source.html" title=" " alt="" coords="441,95,563,121"/>
+<area shape="rect" id="node10" href="$ZoneInfoHigh_8h.html" title="Data structures that encodes the high resolution zoneinfo database persistence format." alt="" coords="441,95,563,121"/>
 <area shape="rect" id="node6" title=" " alt="" coords="491,169,561,196"/>
 <area shape="rect" id="node7" title=" " alt="" coords="586,169,671,196"/>
 <area shape="rect" id="node8" title=" " alt="" coords="695,169,797,196"/>

docs/html/BrokersHigh_8h__incl.md5

@@ -1 +1 @@
-c5bf13b48a3cfaa3a5627c91f36f0233
+068d3a1e434e52a9f77b2e21f5fe1070

docs/html/BrokersHigh_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>
@@ -84,7 +84,7 @@
 <div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;<span class="preprocessor">#include &lt;AceCommon.h&gt;</span> <span class="comment">// KString</span></div>
 <div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="compat_8h.html">compat.h</a>&quot;</span> <span class="comment">// ACE_TIME_USE_PROGMEM</span></div>
 <div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="BrokerCommon_8h.html">BrokerCommon.h</a>&quot;</span></div>
-<div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="preprocessor">#include &quot;ZoneInfoHigh.h&quot;</span></div>
+<div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="ZoneInfoHigh_8h.html">ZoneInfoHigh.h</a>&quot;</span></div>
 <div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160; </div>
 <div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;<span class="keyword">class </span>__FlashStringHelper;</div>
 <div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="keyword">class </span>Print;</div>
@@ -467,6 +467,7 @@
 <div class="ttc" id="aBrokersHigh_8h_html_a4f2137b865f26ef213c9712e1ed7a7f2"><div class="ttname"><a href="BrokersHigh_8h.html#a4f2137b865f26ef213c9712e1ed7a7f2">ace_time::zoneinfohigh::toSuffix</a></div><div class="ttdeci">uint8_t toSuffix(uint8_t modifier)</div><div class="ttdoc">Extract the 'w', 's' 'u' suffix from the 'modifier' field, so that they can be compared against kSuff...</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00069">BrokersHigh.h:69</a></div></div>
 <div class="ttc" id="aBrokersHigh_8h_html_ad32a487aeefa3d1592e64962d68ef040"><div class="ttname"><a href="BrokersHigh_8h.html#ad32a487aeefa3d1592e64962d68ef040">ace_time::zoneinfohigh::toDeltaSeconds</a></div><div class="ttdeci">int32_t toDeltaSeconds(uint8_t deltaMinutes)</div><div class="ttdoc">Convert the deltaMinutes holding the RULES/DSTOFF field in ZoneEra or the SAVE field in ZoneRule to d...</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00043">BrokersHigh.h:43</a></div></div>
 <div class="ttc" id="aBrokersHigh_8h_html_afc690897ee551c81120c7d530f3ba884"><div class="ttname"><a href="BrokersHigh_8h.html#afc690897ee551c81120c7d530f3ba884">ace_time::zoneinfohigh::toOffsetSeconds</a></div><div class="ttdeci">int32_t toOffsetSeconds(uint16_t offsetCode, uint8_t offsetRemainder)</div><div class="ttdoc">Convert (code, remainder) holding the STDOFF field of ZoneEra into seconds.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00050">BrokersHigh.h:50</a></div></div>
+<div class="ttc" id="aZoneInfoHigh_8h_html"><div class="ttname"><a href="ZoneInfoHigh_8h.html">ZoneInfoHigh.h</a></div><div class="ttdoc">Data structures that encodes the high resolution zoneinfo database persistence format.</div></div>
 <div class="ttc" id="aclassace__time_1_1zoneinfohigh_1_1ZoneContextBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfohigh_1_1ZoneContextBroker.html">ace_time::zoneinfohigh::ZoneContextBroker</a></div><div class="ttdoc">Data broker for accessing a ZoneContext.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00081">BrokersHigh.h:81</a></div></div>
 <div class="ttc" id="aclassace__time_1_1zoneinfohigh_1_1ZoneEraBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfohigh_1_1ZoneEraBroker.html">ace_time::zoneinfohigh::ZoneEraBroker</a></div><div class="ttdoc">Data broker for accessing ZoneEra.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00270">BrokersHigh.h:270</a></div></div>
 <div class="ttc" id="aclassace__time_1_1zoneinfohigh_1_1ZoneInfoBroker_html"><div class="ttname"><a href="classace__time_1_1zoneinfohigh_1_1ZoneInfoBroker.html">ace_time::zoneinfohigh::ZoneInfoBroker</a></div><div class="ttdoc">Data broker for accessing ZoneInfo.</div><div class="ttdef"><b>Definition:</b> <a href="BrokersHigh_8h_source.html#l00348">BrokersHigh.h:348</a></div></div>

docs/html/BrokersLow_8h.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">2.3.0</span>
+   &#160;<span id="projectnumber">2.4.0</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>
@@ -75,14 +75,14 @@
 </div><!--header-->
 <div class="contents">
 
-<p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoLow_8h_source.html">ZoneInfoLow.h</a></code>.  
+<p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoLow_8h.html" title="Data structures describe the low resolution zoneinfo persistence format.">ZoneInfoLow.h</a></code>.  
 <a href="#details">More...</a></p>
 <div class="textblock"><code>#include &lt;stdint.h&gt;</code><br />
 <code>#include &lt;Arduino.h&gt;</code><br />
 <code>#include &lt;AceCommon.h&gt;</code><br />
 <code>#include &quot;<a class="el" href="compat_8h_source.html">compat.h</a>&quot;</code><br />
 <code>#include &quot;<a class="el" href="BrokerCommon_8h_source.html">BrokerCommon.h</a>&quot;</code><br />
-<code>#include &quot;ZoneInfoLow.h&quot;</code><br />
+<code>#include &quot;<a class="el" href="ZoneInfoLow_8h_source.html">ZoneInfoLow.h</a>&quot;</code><br />
 </div><div class="textblock"><div class="dynheader">
 Include dependency graph for BrokersLow.h:</div>
 <div class="dyncontent">
@@ -94,7 +94,7 @@
 <area shape="rect" title=" " alt="" coords="139,95,257,121"/>
 <area shape="rect" href="compat_8h.html" title="Macros and definitions that provide a consistency layer among the various Arduino boards for compatib..." alt="" coords="582,95,665,121"/>
 <area shape="rect" href="BrokerCommon_8h.html" title="Helper functions are used in both Basic brokers and Extended brokers." alt="" coords="281,95,416,121"/>
-<area shape="rect" href="ZoneInfoLow_8h_source.html" title=" " alt="" coords="441,95,558,121"/>
+<area shape="rect" href="ZoneInfoLow_8h.html" title="Data structures describe the low resolution zoneinfo persistence format." alt="" coords="441,95,558,121"/>
 <area shape="rect" title=" " alt="" coords="485,169,556,196"/>
 <area shape="rect" title=" " alt="" coords="581,169,666,196"/>
 <area shape="rect" title=" " alt="" coords="690,169,791,196"/>
@@ -173,7 +173,7 @@
 <tr class="separator:a448746bf635780d48bf749ad26a06fbc"><td class="memSeparator" colspan="2">&#160;</td></tr>
 </table>
 <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
-<div class="textblock"><p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoLow_8h_source.html">ZoneInfoLow.h</a></code>. </p>
+<div class="textblock"><p>These classes provide a thin layer of indirection for accessing the data structures defined by <code><a class="el" href="ZoneInfoLow_8h.html" title="Data structures describe the low resolution zoneinfo persistence format.">ZoneInfoLow.h</a></code>. </p>
 <p>The zoneinfo files are stored in flash memory (using the PROGMEM keyword), and cannot be accessed directly on microcontrollers using the Harvard architecture (e.g. AVR) where data and program live in 2 different address spaces. The data in flash memory must be accessed using helper routines in &lt;pgmspace.h&gt;. These classes abstract away this difference so that the code BasicZoneProcessor and ExtendedZoneProcessor can be written to be (mostly) agnostic to how the zoneinfo files are stored. </p>
 
 <p class="definition">Definition in file <a class="el" href="BrokersLow_8h_source.html">BrokersLow.h</a>.</p>