From c7c1c6313039ae40d628fe135ccb4525f6575602 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 18:33:32 -0500 Subject: [PATCH 1/3] Document TemporalField unit properties Refs #267 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../xml/Java.Time.Temporal/ITemporalField.xml | 89 ++++++++++++++++--- 1 file changed, 77 insertions(+), 12 deletions(-) diff --git a/docs/xml/Java.Time.Temporal/ITemporalField.xml b/docs/xml/Java.Time.Temporal/ITemporalField.xml index b081c3b2a..cbbd05536 100644 --- a/docs/xml/Java.Time.Temporal/ITemporalField.xml +++ b/docs/xml/Java.Time.Temporal/ITemporalField.xml @@ -151,9 +151,24 @@ Java.Time.Temporal.ITemporalUnit - To be added. - To be added. - To be added. + Gets the unit that the field is measured in. + the unit defining the base unit of the field, not null + + Gets the unit that the field is measured in. + The unit of the field is the period that varies within the range. + For example, in the field MonthOfYear, the unit is Months. + See also getRangeUnit(). + + + Java documentation for java.time.temporal.TemporalField.getBaseUnit(). + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + @@ -287,9 +302,25 @@ System.Boolean - To be added. - To be added. - To be added. + Checks if this field represents a component of a date. + true if this field is a component of a date + + Checks if this field represents a component of a date. + A field is date-based if it can be derived from + ChronoField#EPOCH_DAY EPOCH_DAY. + Both isDateBased() and isTimeBased() may return false, + such as for a field representing minute-of-week. + + + Java documentation for java.time.temporal.TemporalField.isDateBased(). + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + @@ -374,9 +405,25 @@ System.Boolean - To be added. - To be added. - To be added. + Checks if this field represents a component of a time. + true if this field is a component of a time + + Checks if this field represents a component of a time. + A field is time-based if it can be derived from + ChronoField#NANO_OF_DAY NANO_OF_DAY. + Both isDateBased() and isTimeBased() may return false, + such as for a field representing minute-of-week. + + + Java documentation for java.time.temporal.TemporalField.isTimeBased(). + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + @@ -516,9 +563,27 @@ Java.Time.Temporal.ITemporalUnit - To be added. - To be added. - To be added. + Gets the range that the field is bound by. + the unit defining the range of the field, not null + + Gets the range that the field is bound by. + The range of the field is the period that the field varies within. + For example, in the field MonthOfYear, the range is Years. + See also getBaseUnit(). + The range is never null. For example, the Year field is shorthand for + YearOfForever. It therefore has a unit of Years and a range of + Forever. + + + Java documentation for java.time.temporal.TemporalField.getRangeUnit(). + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + From df042af96ba10e3f4a47a3525387fc3406a05e99 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 18:44:16 -0500 Subject: [PATCH 2/3] Clarify TemporalField range unit Refs #267 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Time.Temporal/ITemporalField.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/xml/Java.Time.Temporal/ITemporalField.xml b/docs/xml/Java.Time.Temporal/ITemporalField.xml index cbbd05536..6ec4b84bf 100644 --- a/docs/xml/Java.Time.Temporal/ITemporalField.xml +++ b/docs/xml/Java.Time.Temporal/ITemporalField.xml @@ -563,10 +563,10 @@ Java.Time.Temporal.ITemporalUnit - Gets the range that the field is bound by. + Gets the unit that defines the range of the field. the unit defining the range of the field, not null - Gets the range that the field is bound by. + Gets the unit that defines the range of the field. The range of the field is the period that the field varies within. For example, in the field MonthOfYear, the range is Years. See also getBaseUnit(). From affdf9ca68865bfeef71803ccc9f761895521af5 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 09:32:40 -0500 Subject: [PATCH 3/3] Use managed ChronoField references Refs #267 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Time.Temporal/ITemporalField.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/xml/Java.Time.Temporal/ITemporalField.xml b/docs/xml/Java.Time.Temporal/ITemporalField.xml index 6ec4b84bf..007ac050c 100644 --- a/docs/xml/Java.Time.Temporal/ITemporalField.xml +++ b/docs/xml/Java.Time.Temporal/ITemporalField.xml @@ -307,7 +307,7 @@ Checks if this field represents a component of a date. A field is date-based if it can be derived from - ChronoField#EPOCH_DAY EPOCH_DAY. + . Both isDateBased() and isTimeBased() may return false, such as for a field representing minute-of-week. @@ -410,7 +410,7 @@ Checks if this field represents a component of a time. A field is time-based if it can be derived from - ChronoField#NANO_OF_DAY NANO_OF_DAY. + . Both isDateBased() and isTimeBased() may return false, such as for a field representing minute-of-week.