ENH: Expose date parsing arguments in `read_html` function

[csala]

Feature Type

• Adding new functionality to pandas

• Changing existing functionality in pandas

• Removing existing functionality in pandas

Problem Description

The current read_html function exposes the same parse_dates argument that read_csv has, but it does not expose the rest of arguments that let the user control how the dates are parsed (infer_datetime_format, keep_date_col, date_parser, dayfirst, cache_dates).

Other arguments unrelated to date parsing may be in the same situation, so maybe this issue could be extended to cover them all.

Feature Description

These arguments, or at least some of them, could be easily exposed directly in the read_html without much hassle, which would be very convenient for the user.

Alternative Solutions

Right now the only viable solution is to skip date parsing altogether during the data loading step and then manually implement the date parsing over the returned data frame.

The problem with this is that it breaks the API uniformity with read_csv, making the implementation of integrations with different input data sources different depending on the data format (function call with arguments vs function call with arguments + postprocessing), while also potentially skipping any optimizations implemented during the read_csv workflow.

Additional Context

From what I could tell skimming over the code, the read_html function only adds a few layers of code on top of the underlying parser, which already supports all the mentioned arguments, and parse_dates is simply pushed down to it untouched letting the parser use the default values for all the others arguments in the list above.

[csala]

I can actually confirm that the mentioned arguments work by simply adding them here:

pandas/pandas/io/html.py

Line 1028 in 6122c7d

def read_html(

And then passing them down here:

pandas/pandas/io/html.py

Line 1204 in 6122c7d

return _parse(

since, they are automatically added within the generic **kwargs dict here:

pandas/pandas/io/html.py

Line 975 in 6122c7d

def _parse(flavor, io, match, attrs, encoding, displayed_only, extract_links, **kwargs):

which is later on pushed down until the corresponding parser reads them.

I'd be happy to make a PR if this is an acceptable change.

[MarcoGorelli]

thanks for the request

date_format will be added as part of #51019, but for the others the advice will likely keep being to parse as object and convert to datetime after that

[csala]

@MarcoGorelli So after #51019 will the read_csv and read_html signatures be aligned? Or will they continue to behave differently.

To be honest, I am not in favor of forcing multiple steps (read data first and then parse datetimes), but my concern was not really that much about the date parsing step, and more about the fact that ingesting data via read_csv and read_html had different steps required.

In any case, if this is not going to be addressed, please feel free to close this issue.