Make datetime.rs structs and fields public #431

[xpe]

In issue #431, @samuelcolvin wrote:

I'd like to be able to access the fields of Datetime (and then obviously Date and Time) directly rather than having to re-parse the result of to_string().

I don't need chrono integration, just direct access to the integer values.

Would you accept a PR for this?

Then @alexcrichton replied:

Seems reasonable to me to add!

[samuelcolvin]

LGTM

[alexcrichton]

Can you fill out the documentation for each field and what it corresponds to for datetimes as specified by toml?

[xpe]

Can you fill out the documentation for each field and what it corresponds to for datetimes as specified by toml?

I think I can gather the information to do that. I'll take a look.

[xpe]

@alexcrichton I added some docs, hope you like 'em!

[alexcrichton]

Thanks!

[samuelcolvin]

I've tested this in rtoml samuelcolvin/rtoml#30.

It's working great. Thank you both.

[huonw]

It's very minor, but I happened to notice that these docs are slightly incorrect: this can be as large as +13 or even +14 https://en.wikipedia.org/wiki/UTC%2B14:00 for real timezones, on some Pacific islands.

A special mention for Chatham Islands during DST, where the offset is +13:45.

[ehuss]

Filed #444

[xpe]

@huonw Nice find! This made my day on GitHub for sure!