Cookbook example for compiling time zone from tzdata rules

docs/cookbook-tzdata.md

@@ -0,0 +1,14 @@
+## Time zone directly from tzdata rules
+
+This is an example of building your own `Temporal.TimeZone` object from [tzdata-compatible rules](https://data.iana.org/time-zones/tz-how-to.html).
+
+This could be useful for testing, for example, or for using other versions of the tzdata than are installed on the host system.
+
+The code in this example is inefficient.
+In real production code, it would make more sense to load the data from a compiled form, not directly from the rules themselves.
+
+> **NOTE**: This is a very specialized use of Temporal and is not something you would normally need to do.
+
+```javascript
+{{cookbook/getTimeZoneObjectFromRules.mjs}}
+```

docs/cookbook.md

@@ -471,3 +471,9 @@ Extend Temporal to support arbitrarily-large years (e.g., **+635427810-02-02**)
 An example of using `Temporal.TimeZone` for other purposes than a standard time zne.
 
 → [NYSE time zone](cookbook-nyse.md)
+
+### Time zone directly from tzdata rules
+
+An example of building your own `Temporal.TimeZone` object from [tzdata-compatible rules](https://data.iana.org/time-zones/tz-how-to.html).
+
+→ [Time zone from tzdata](cookbook-tzdata.md)

docs/cookbook/all.mjs

@@ -18,6 +18,7 @@ import './getParseableZonedStringAtInstant.mjs';
 import './getSortedLocalDateTimes.mjs';
 import './getTimeStamp.mjs';
 import './getTimeZoneObjectFromIanaName.mjs';
+import './getTimeZoneObjectFromRules.mjs';
 import './getTripDurationInHrMinSec.mjs';
 import './getUtcOffsetDifferenceSecondsAtInstant.mjs';
 import './getUtcOffsetSecondsAtInstant.mjs';