time: add documentation for remaining time-related functions and ISO 8601 parsing (#23867)

This commit is contained in:
Noa Santo 2025-03-05 13:11:19 +01:00 committed by GitHub
parent 2dc5f68894
commit a74f3171db
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 10 additions and 0 deletions

View file

@ -19,6 +19,11 @@ pub fn parse(s string) Time {
return res
}
// parse_iso8601 parses the ISO 8601 time format yyyy-MM-ddTHH:mm:ss.dddddd+dd:dd as local time.
// The fraction part is difference in milli seconds, and the last part is offset from UTC time.
// Both can be +/- HH:mm .
// See https://en.wikipedia.org/wiki/ISO_8601 .
// Remarks: not all of ISO 8601 is supported; checks and support for leapseconds should be added.
pub fn parse_iso8601(s string) !Time {
return parse(s)
}