Time/Timestamp converters & misc util classes #1140
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Time/Timestamp converters & misc util classes
This PR is a documentation-only cleanup (with one tiny test tweak) that targets all
LongConverter
timestamp/duration implementations plus a few stray utility classes.No production code paths are affected.
📚 What’s inside?
AbstractTimestampLongConverter
,Milli*
,Micro*
,Nano*
,ServicesTimestampLongConverter
zoneId
vs UTC semantics and the precision that each converter handles.* Clarify
parse
,append
,parseFormattedDate
,parseTimestamp
contracts and parameter roles.* Add missing JavaDoc for private helpers (formatter creation, fraction handling, etc.).
MicroDurationLongConverter
,NanoDurationLongConverter
* Detail
append(StringBuilder/Bytes)
behaviour.WireDumper
,Wires
@SuppressWarnings
after the class-level Javadoc so IDE tool-tips render properly.MarshallableOutBuilderTest
HttpExchange.sendResponseHeaders(202, **-1**)
so JDK doesn’t expect a body when none is sent (value0
allowed arbitrary length).