yaojiejia opened a new pull request, #18443:
URL: https://github.com/apache/hudi/pull/18443

   ### Describe the issue this Pull Request addresses
   
   Closes #18442
   
   As part of #17152, validation and normalization was added for incremental 
and time travel timestamp parameters in the Spark datasource. The site 
documentation for these configs was not updated to reflect the newly supported 
formats.
   
   ### Summary and Changelog
   
   Update the Hudi website documentation to list all supported timestamp input 
formats for `hoodie.datasource.read.begin.instanttime`, 
`hoodie.datasource.read.end.instanttime`, and `as.of.instant`.
   
   Changelog:
   - Updated `website/docs/configurations.md` — `begin.instanttime`, 
`end.instanttime`, `as.of.instant` (both `TIME_TRAVEL_AS_OF_INSTANT` and 
`TIMESTAMP_AS_OF` entries)
   - Updated `website/docs/basic_configurations.md` — `begin.instanttime`, 
`end.instanttime`
   - Updated `website/docs/table_types.md` — `begin.instanttime`, 
`end.instanttime`, `as.of.instant`
   - Updated `website/versioned_docs/version-1.1.1/configurations.md` — same as 
above
   - Updated `website/versioned_docs/version-1.1.1/basic_configurations.md` — 
same as above
   - Updated `website/versioned_docs/version-1.1.1/table_types.md` — same as 
above
   
   ### Impact
   
   Documentation change only.
   
   ### Risk Level
   
   none
   
   ### Documentation Update
   
   This PR is the documentation update itself. The following supported formats 
are now documented for all three config options:
   - `yyyyMMddHHmmss[SSS]` (Hudi native)
   - `yyyy-MM-dd` (ISO date)
   - `yyyy-MM-dd HH:mm:ss[.SSS]` (ISO datetime with space separator)
   - `yyyy-MM-ddTHH:mm:ss[.SSS]` (ISO datetime with T separator)
   - Epoch seconds (10-digit number)
   - Epoch millis (13-digit number)
   - `earliest` (incremental queries only)
   
   Additionally, all three configs now note that invalid values throw an error 
immediately.
   
   ### Contributor's checklist
   
   - [x] Read through [contributor's 
guide](https://hudi.apache.org/contribute/how-to-contribute)
   - [x] Enough context is provided in the sections above
   - [x] Adequate tests were added if applicable


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to