LoginSign Up
← Back to all sparks
R

r-datetimeoffset

ANALYTICS
Velocity0.0

Datetimes with Optional UTC Offsets and/or Heterogeneous Time Zones

github.com/trevorld/r-datetimeoffset ↗

A datetime type built for the messy metadata formats everyone else rounds off.

datetimeiso-8601metadatar-packagevctrs
◆Current state
datetimeoffset provides a vctrs record type for datetimes with optional UTC offsets, possibly heterogeneous time zones, and missing components — the shapes that appear in PDF, XMP and exiftool metadata. Its value sits in the format family around that type: ISO 8601, EDTF, pdfmark, exiftool, nanotime and strftime output. The 1.0.0 release is a dependency bump, not a feature milestone.
◆Where it's heading
Growth has come by adding output dialects and loosening parsing rather than by changing the core record. Recent releases handle TOML's ISO 8601 subset and times with no associated date, both narrow gaps in an otherwise settled design. The package tracks the clock package closely and much of its release traffic is keeping that alignment.
◆Prediction
Further format dialects and parser edge cases are the likely path; the 1.0.0 label suggests the author considers the record type itself stable.

◆Recent moves

  1. 1y ago

    1.0.0 raises the clock requirement; no functional change

    Despite the 1.0.0 label, the only change is raising the required clock version to 0.7.3. The version number marks the author's confidence in a stable API rather than any new behaviour.

    View source ↗
  2. 1y ago

    TOML output mode and support for time-only values

    Adds a TOML mode to format_iso8601(), teaches the parser and formatters to handle times with no associated date, and adds a get_tz() method for Date objects. Squarely in the package's pattern of absorbing one more real-world dialect per release.

    View source ↗
  3. 3y ago

    pdfmark prefix option and clock ambiguity handling

    format_pdfmark() gains a prefix argument and the clock conversion method picks up ambiguous, nonexistent and fill handling where the installed clock supports it. Small refinements to two of the package's core output paths.

    View source ↗
  4. 3y ago

    exiftool and XMP output formats

    Adds exiftool-format output, an XMP mode for ISO 8601, numeric coercion into the year field, and pdfmark parsing with a trailing Z offset. Each addition maps the type onto another metadata tool's expectations.

    View source ↗
  5. 3y ago

    Initial release: a datetime record with optional offsets and zones

    ⚡ SPARK

    The initial release, defining the whole package: a vctrs record type whose fields may individually be missing, whose time zones need not be homogeneous, and a set of formatters covering ISO 8601, EDTF, pdfmark, nanotime and strftime. Every later release extends this surface rather than revising it.

    View source ↗