Library / Date and time / Date and time / DateTimeFactory
DateTimeFactory
Fallible DateTime construction surface.
Methods 2
METHOD parseDateTime(REFERENCE String text, REFERENCE String pattern) RETURNS | DateTimereads
Strict-parse a DateTime from text against a pattern using
the Phase 5 token grammar: YYYY (4-digit year), MM/DD/HH/
mm/ss (2-digit), SSS (3-digit milliseconds). Each token
consumes exactly its width in decimal digits; every other
pattern character must match the next text character exactly.
On any mismatch (width / non-digit / literal mismatch / trailing
text / out-of-range components / invalid calendar date such as
Feb 30), returns FAILURE rather than a partial DateTime.
METHOD newDateTime(int32 year, int32 month, int32 day, int32 hour, int32 minute, int32 second, int32 millisecond) RETURNS | DateTimereads
Construct a DateTime from explicit year-through-millisecond components. UTC. Pipe-XOR FAILURE on out-of-range per Phase 0 #5: year must lie in [1, 9999] (ISO 8601 range), month in [1, 12], day in [1, 31] (and a day the month has — Feb 30 is a FAILURE), hour in [0, 23], minute in [0, 59], second in [0, 60] (leap-second permissible), millisecond in [0, 999].