FEATURE: Lexical Datetime

Field	Value
Version	20260814 V1
Description	Parses TOML offset datetime, local datetime, local date, and local time values.
Depends On	ARCHITECTURE.md
Provides	TOML datetime values
Consumes	parser module boundary

Behavior

The parser recognizes offset datetimes, local datetimes, local dates, and local times according to TOML 1.0.0. It accepts permitted T, t, and space separators, preserves local values without an offset, emits the required tagged representations, and truncates excess fractional precision rather than rounding it. Invalid date and time forms are rejected.

Programmatic Acceptance

Requires: executable=go; scope=test
Requires: executable=sh; scope=test

=== AC lexical-datetime-valid ===
Intent: The implementation passes the authoritative valid TOML datetime conformance slice.
Suite: scoped

import os import subprocess import sys

result = subprocess.run( ["sh", "sources/stage_test.sh", "valid/datetime/*"], capture_output=True, text=True, env={**os.environ, "TOML_TEST_VERSION": "v2.2.0"}, ) print(result.stdout) print(result.stderr, file=sys.stderr) assert result.returncode == 0 === END AC lexical-datetime-valid ===

=== AC lexical-datetime-invalid ===
Intent: The implementation rejects the authoritative invalid TOML datetime conformance slice.
Suite: scoped

import os import subprocess import sys

result = subprocess.run( ["sh", "sources/stage_test.sh", "invalid/datetime/*"], capture_output=True, text=True, env={**os.environ, "TOML_TEST_VERSION": "v2.2.0"}, ) print(result.stdout) print(result.stderr, file=sys.stderr) assert result.returncode == 0 === END AC lexical-datetime-invalid ===

User Acceptance

None.

Guardrails

Local date and time values do not acquire an implicit timezone.
Fractional seconds beyond supported precision are truncated, not rounded.