Support Alternate Datetime Formats

[GumpacG]

Description

Supports using date/time/timestamp formats obtained from OpenSearch. Contains some changes from OpenSearchDataType rework (Bit-Quill@8b2f65d). Resolves some issues previously seen on the forum (please see Issues Resolved section below).

Formats that require only dates will return type of date. For example, the format "basic_date" will have type date in the result. Formats that require only times will return type of time. For example, the format "basic_time" will have type time in the result. Formats that can have either date or time will return type of timestamp. For example, the format "basic_date||basic_time" will have type timestamp in the result. This is also the case when using aggregation like AVG.

Out of scope

Custom formats in the index mapping will be supported in a follow-up issue

TODO: Follow up with support for user-defined formats

Based on PoC (Here: https://github.com/Bit-Quill/opensearch-project-sql/pull/169/files).

Note: With these changes, issues may be introduced where data is read differently if a user's mapping defines a format. This is because the plugin previously used a hardcoded formatter to parse the data, while with these changes it will use the formatter defined in the mapping.

Supported formats include named formats listed in: opensearch/src/main/java/org/opensearch/sql/opensearch/data/type/OpenSearchDateType.java or https://opensearch.org/docs/latest/field-types/supported-field-types/date/

Issues Resolved

#794
https://forum.opensearch.org/t/sql-select-fails-on-date-fields-format-epoch-second/11521

Check List

• New functionality includes testing.
  • All tests pass, including unit test, integration test and doctest
• New functionality has been documented.
  • New functionality has javadoc added
  • New functionality has user manual doc added
• Commits are signed per the DCO using --signoff

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[codecov]

Codecov Report

Merging #1664 (1591a85) into main (9824b1c) will increase coverage by 0.02%.
The diff coverage is 100.00%.

@@             Coverage Diff              @@
##               main    #1664      +/-   ##
============================================
+ Coverage     97.16%   97.19%   +0.02%     
- Complexity     4120     4165      +45     
============================================
  Files           371      372       +1     
  Lines         10373    10478     +105     
  Branches        704      720      +16     
============================================
+ Hits          10079    10184     +105     
  Misses          287      287              
  Partials          7        7              

Flag	Coverage Δ
sql-engine	97.19% <100.00%> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...h/sql/opensearch/data/type/OpenSearchDataType.java	100.00% <100.00%> (ø)
...h/sql/opensearch/data/type/OpenSearchDateType.java	100.00% <100.00%> (ø)
...h/sql/opensearch/data/type/OpenSearchTextType.java	100.00% <100.00%> (ø)
...nsearch/data/value/OpenSearchExprValueFactory.java	100.00% <100.00%> (ø)
...pensearch/sql/opensearch/mapping/IndexMapping.java	100.00% <100.00%> (ø)