6.2.901.900
15 Formatting and Parsing
15.1 Formatting Dates and Times
procedure
t : (or/c date-provider? time-provider?) pattern : string? locale : string? = (current-locale)
Examples: | ||||||||||||||||||
|
15.2 Parsing Dates and Times
15.2.1 Parsing ISO 8601 representations
procedure
(iso8601->date str) → date?
str : string?
Parses an ISO 8601 representation of a date into a date. Note that the input must
use the ISO 8601 extended format.
Examples: | ||||
|
procedure
(iso8601->time str) → date?
str : string?
Parses an ISO 8601 representation of a time into a time. Note that the input must
use the ISO 8601 extended format.
Example: | ||
|
procedure
(iso8601->datetime str) → date?
str : string?
Parses an ISO 8601 combined date and time representation into a datetime. Note that
the input must use the ISO 8601 extended format.
Example: | ||
|
procedure
(iso8601->moment str) → date?
str : string?
Parses an ISO 8601 combined date and time representation into a moment. Note that
the input must use the ISO 8601 extended format.
Example: | ||
|
procedure
(iso8601/tzid->moment str) → date?
str : string?
Parses a non-standard format, consisting of an ISO 8601 combined date and time representation
and an IANA time zone ID in brackets, into a moment. The input format is the same
as that produced by moment->iso8601/tzid. Note that the ISO 8601 portion of
the input must use the ISO 8601 extended format.
Example: | ||
|
15.2.2 Flexible parsing based on patterns
procedure
(parse-date str pattern [ #:ci? ci? #:locale locale]) → date? str : string? pattern : string? ci? : boolean? = #t locale : string? = (current-locale)
Parses str according to pattern, which uses the CLDR
pattern syntax.
The result is returned as a date. If the input cannot be parsed as a date,
exn:gregor:parse is raised.
Example: | ||||||
|
procedure
(parse-time str pattern [ #:ci? ci? #:locale locale]) → time? str : string? pattern : string? ci? : boolean? = #t locale : string? = (current-locale)
Parses str according to pattern, which uses the CLDR
pattern syntax.
The result is returned as a time. If the input cannot be parsed as a time,
exn:gregor:parse is raised.
Example: | ||||||
|
procedure
(parse-datetime str pattern [ #:ci? ci? #:locale locale]) → datetime? str : string? pattern : string? ci? : boolean? = #t locale : string? = (current-locale)
Parses str according to pattern, which uses the CLDR
pattern syntax.
The result is returned as a datetime. If the input cannot be parsed as a datetime,
exn:gregor:parse is raised.
Example: | ||||||
|
procedure
(parse-moment str pattern [ #:ci? ci? #:locale locale] #:resolve-offset resolve) → moment? str : string? pattern : string? ci? : boolean? = #t locale : string? = (current-locale) resolve : resolve-offset/raise
Parses str according to pattern, which uses the CLDR
pattern syntax.
The result is returned as a moment. If the input cannot be parsed as a moment,
exn:gregor:parse is raised. If the result’s UTC offset is ambigous, resolve
is used to resolve the ambiguity.
Example: | |||||||||
|
parameter
→ (-> (integer-in 0 99) exact-integer?) (current-two-digit-year-resolver resolver) → void? resolver : (-> (integer-in 0 99) exact-integer?)
A parameter used to control how parsed two-digit years are resolved into complete years.
The default implementation is:
(λ (parsed-year) (define current-year (->year (now))) (define lo (- current-year 50)) (define t (if (>= lo 0) (remainder lo 100) (+ 99 (remainder (add1 lo) 100)))) (+ parsed-year lo (if (< parsed-year t) 100 0) (- t)))
Example: | ||||
|