From c4c34179a2d01f6c75c0d7cbc2e6c2ac8bafa2fe Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 15:59:30 -0500 Subject: [PATCH 1/3] Document ZoneRules query APIs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Time.Zone/ZoneRules.xml | 94 ++++++++++++--------------- 1 file changed, 41 insertions(+), 53 deletions(-) diff --git a/docs/xml/Java.Time.Zone/ZoneRules.xml b/docs/xml/Java.Time.Zone/ZoneRules.xml index d11cf1e44..2f8d6c50c 100644 --- a/docs/xml/Java.Time.Zone/ZoneRules.xml +++ b/docs/xml/Java.Time.Zone/ZoneRules.xml @@ -95,10 +95,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant to find the daylight savings for. + Gets the amount of daylight savings in use for the specified instant in this zone. + The difference between the standard and actual offset. @@ -128,10 +127,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant to find the offset for. + Gets the offset applicable at the specified instant in these rules. + The offset applicable at the specified instant. @@ -161,10 +159,9 @@ - To be added. - To be added. - To be added. - To be added. + The local date-time to query. + Gets a suitable offset for the specified local date-time in these rules. + The best available offset for the local date-time. @@ -194,10 +191,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant to find the offset information for. + Gets the standard offset for the specified instant in this zone. + The standard offset for the specified instant. @@ -227,10 +223,9 @@ - To be added. - To be added. - To be added. - To be added. + The local date-time to query for an offset transition. + Gets the offset transition applicable at the specified local date-time in these rules. + The transition for a gap or overlap; otherwise, . @@ -266,10 +261,9 @@ - To be added. - To be added. - To be added. - To be added. + The local date-time to query for valid offsets. + Gets the offsets applicable at the specified local date-time in these rules. + The list of valid offsets. @@ -299,10 +293,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant to check for daylight savings. + Checks whether the specified instant is in daylight savings. + if the specified instant is in daylight savings; otherwise, . @@ -374,11 +367,10 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The local date-time to check. + The offset to check. + Checks whether the offset date-time is valid for these rules. + if the offset date-time is valid for these rules; otherwise, . @@ -446,10 +438,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant after which to get the next transition. + Gets the next transition after the specified instant. + The next transition after the specified instant, or if it is after the last transition. @@ -479,10 +470,9 @@ - To be added. - To be added. - To be added. - To be added. + The offset to use for the rules. + Obtains an instance of with a fixed offset. + The zone rules with the specified fixed offset. @@ -537,14 +527,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The standard offset to use before legal rules were set. + The wall offset to use before legal rules were set. + The list of changes to the standard offset. + The list of transitions. + The recurring last rules. + Obtains an instance of . + The zone rules. @@ -574,10 +563,9 @@ - To be added. - To be added. - To be added. - To be added. + The instant before which to get the previous transition. + Gets the previous transition before the specified instant. + The previous transition before the specified instant, or if it is before the first transition. From 1cc6496a98e4edc2ba59a9d236e57b4d76e611cf Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 16:10:13 -0500 Subject: [PATCH 2/3] Clarify daylight savings return value Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Time.Zone/ZoneRules.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/xml/Java.Time.Zone/ZoneRules.xml b/docs/xml/Java.Time.Zone/ZoneRules.xml index 2f8d6c50c..733a04032 100644 --- a/docs/xml/Java.Time.Zone/ZoneRules.xml +++ b/docs/xml/Java.Time.Zone/ZoneRules.xml @@ -97,7 +97,7 @@ The instant to find the daylight savings for. Gets the amount of daylight savings in use for the specified instant in this zone. - The difference between the standard and actual offset. + The difference between the standard offset and the actual offset in use at the specified instant. From e4b3a1c5e5fe0b29763906c38c7301004c823d74 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 09:33:09 -0500 Subject: [PATCH 3/3] Document ZoneRules factory constraints Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Time.Zone/ZoneRules.xml | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/xml/Java.Time.Zone/ZoneRules.xml b/docs/xml/Java.Time.Zone/ZoneRules.xml index 733a04032..ce6af880a 100644 --- a/docs/xml/Java.Time.Zone/ZoneRules.xml +++ b/docs/xml/Java.Time.Zone/ZoneRules.xml @@ -470,9 +470,10 @@ - The offset to use for the rules. + The non-null offset to use for the rules. Obtains an instance of with a fixed offset. The zone rules with the specified fixed offset. + Thrown if is . @@ -527,13 +528,15 @@ - The standard offset to use before legal rules were set. - The wall offset to use before legal rules were set. - The list of changes to the standard offset. - The list of transitions. - The recurring last rules. + The non-null standard offset to use before legal rules were set. + The non-null wall offset to use before legal rules were set. + The non-null list of changes to the standard offset. + The non-null list of transitions. + The non-null recurring last rules, with at most 16 entries. Obtains an instance of . The zone rules. + Thrown if any argument is . + Thrown if contains more than 16 rules.