Crate whatwg_datetime

A Rust crate for parsing the datetime microsyntax, as defined by the WHATWG HTML Standard.

Install

cargo add whatwg-datetime

Usage

This library currently implements 8 of the 9 datetime formats defined by the WHATWG HTML Standard. The only format not implemented is the duration format, which is tracked in issue #23.

use chrono::{NaiveDate, NaiveDateTime, NaiveTime, TimeZone, Utc};
use whatwg_datetime::parse_global_datetime;

assert_eq!(
    parse_global_datetime("2011-11-18T14:54Z"),
    Some(Utc.from_utc_datetime(
        &NaiveDateTime::new(
            NaiveDate::from_ymd_opt(2011, 11, 18).unwrap(),
            NaiveTime::from_hms_opt(14, 54, 0).unwrap(),
        )
    ))
);

Structs

• TimeZoneOffset
  A time-zone offset, with a signed number of hours and minutes.
• YearMonth
  A proleptic-Gregorian date consisting of a year and a month, with no time-zone or date information.
• YearWeek
  A week date consisting of a year and a week number.
• YearlessDate
  A yearless date, consisting of a gregorian month and a day within the month, without an associated year.

Functions

• parse_date
  Parse a proleptic-Gregorian date, in the format of YYYY-MM-DD
• parse_date_component
  Low-level function for parsing an individual date component at a given position
• parse_global_datetime
  Parse a proleptic-Gregorian date consisting of a date, time, and an optional time-zone offset
• parse_local_datetime
  Parse a proleptic-Gregorian date consisting of a date, time, with no time-zone information
• parse_month
  Parse a proleptic-Gregorian date consisting of a year and a month, with no time-zone or date information
• parse_month_component
  Low-level function for parsing an individual month component at a given position
• parse_time
  Parse a specific time containing an hour, minute, and optionally a second, and a fraction of a second
• parse_time_component
  Low-level function for parsing an individual time component at a given position
• parse_timezone_offset
  Parse a time-zone offset, with a signed number of hours and minutes
• parse_timezone_offset_component
  Low-level function for parsing an individual timezone offset component at a given position
• parse_week
  Parse a week-year number and a week-number
• parse_yearless_date
  Parses a string consisting of a gregorian month and a day within the month, without an associated year
• parse_yearless_date_component
  Low-level function for parsing an individual yearless date component at a given position

Type Aliases

• ParseComponentFn
• ParseStringFn