Skip to content

messydates

1.1.1Package record

A Flexible Class for Messy Dates

1packages dependsuggested by 3
4.5Kdownloads / year
91.3%test coverage
13/13flavors OK

Overview

About

Contains a set of tools for constructing and coercing into and from the "mdate" class. This date class implements ISO 8601-2:2019(E) and allows regular dates and times to be annotated to express unspecified date or time components, approximate or uncertain components, ranges, and sets of dates. The package therefore retains, represents, and reasons about data and time imprecision, resolving to a single data/time only on demand. This is useful for describing and analysing temporal information, whether historical or recent, where date or time precision may vary.

Changes in 1.1.1

Package

  • Added a reverse dependency job to the PR checks workflow

Coercion

  • Added parsing of a day of the year, e.g. "the 103rd day of 2026" (closes #97)
  • Gives "2026-04-13"; "2026-103" notation is still rejected as ambiguous
  • Added parsing of a week of the year, e.g. "the 5th week of 2026" (closes #96)
  • Gives the range "2026-01-26..2026-02-01"
  • Weeks follow ISO 8601, so week 1 can start in December of the year before
  • "2026-W05" and "2026-W05-3" are read too, but recorded as dates/ranges
  • Updated the documentation of seasons in prose, e.g. "summer 2026" (closes #98)
  • Gives the northern-hemisphere month range "2026-06..2026-08"
  • "2026-22" season codes are still rejected as ambiguous
Show all changes in 1.1.1Hide the rest of the changes in 1.1.1
  • Improved the errors for ordinal dates and season codes to name the prose form
  • Fixed "before" and "after" keeping both bounds of a range that followed
  • "before summer 2026" gave "..2026-06..2026-08" and now gives "..2026-06"
  • Fixed prose naming an impossible date becoming NA without a warning
  • "the 53rd week of 2025" now warns, as other unparseable text does

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 2.3 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
  • OK13 OK2026-05-08
Show 2 earlier changesHide 2 earlier changes
  • WARNING12 OK, 1 WARNING2026-05-07
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.1.1
READMEYes · 1,891 wordsVignettesNoNEWSYes · 100% structured · mentions 1.1.1Citation fileYes · software entry onlyWebsiteYes · pkgdown
Help pages
21 (2 internal)
Examples that run
95%18 run in a plain check · 1 only when donttest examples are enabled (R CMD check --as-cran)
Exported functions with examples
87%
Documented parameters
83%
Return-value docs
77%
Help pages citing references
0%

Downloads

4.5K
CRAN downloads in the past year
Rank #7,178 · ~12/day · ~377/mo
Daily download trend is not available in this view yet.
47530 days
1.2K90 days
4.5K1 year
Compare downloads with other packages →
Also on151 r2u7 autocran1.5K conda_forge

Repository

17Stars
2Forks
7Open issues
0Open PRs
21Releases
947Commits
10Commit identities
rdates
947 commits · Last activity 2026-09-01 · +6.3% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
97%
Median days to close, 50 most recently updated closed issues
78
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-06-11 · 162026-10-02 · 17
PracticesBeta

15 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/globalgov/messydates on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows

Governance and community (4)
Code of conductContributing guideIssue templatesPR template
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-09-01 · The repository has a site deploy workflow

pkgdown site last built 2026-09-01

Coverage (1)
Coverage reporting
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Lint, format, editor (2)
Lint workflowRStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-07-02
    Named in .Rbuildignore: .claude, CLAUDE.md
    Named in .gitignore: CLAUDE.md
  • GitHub Copilotfirst seen 2026-07-03
    Commits: 1 by its own account
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
6 external dependencies (excludes base and recommended)

Installing messydates adds 5 packages (3 with compiled code, 12 MB of source tarballs). Heaviest: stringi 11 MB, lubridate 420 KB, cpp11 298 KB.

Depends (1)
R >= 4.1
Imports (3)
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
1direct
1indirect
Depends 1
Suggested by 3
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

Datasets

People & History

People (4)
Maintainer since 0.1.1 (2021), Author, Contributor
IHEID
Contributor
IHEID
Contributor · added in 0.2.0
IHEID
Contributor · added in 0.4.1
Releases (14)

Pick two releases to compare their code metrics.

  • 1.1.1Latest
    record
    2026-09-01 · current release · diff ↗
  • 1.1.0
    record
    2026-07-27 · diff ↗ ·
    added 1 export
    md_problems
  • 1.0.0
    record
    2026-07-16 · diff ↗ ·
    added 8 exports
    approximate, hour, make_messyduration, mday, minute, second, tz, uncertain
  • R
    R 4.6.0 released · 2026-04-24
  • 0.5.4
    record
    2025-06-02 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 0.5.3
    record
    2025-03-20 · diff ↗
  • 0.5.2
    record
    2025-03-07 · diff ↗ ·
    removed 1 export
    mreport
    added 7 exports
    is_bce, vmax, vmean, vmedian, vmin, vmodal, vrandom
  • R
    R 4.4.0 released · 2024-04-24
  • 0.4.1
    record
    2024-04-19 · diff ↗ ·
    removed 1 export
    NA_mdate_
    added 13 exports
    %><%, %>=<%, %g%, %ge%, %intersect%, %l%, %le%, %union%, is_subset, mdate, messyduration, new_messyduration, validate_messyduration
  • R
    R 4.3.0 released · 2023-04-21
  • 0.3.5
    record
    2023-01-20 · diff ↗
  • 0.3.3
    record
    2022-12-21 · diff ↗
  • 0.3.1
    record
    2022-07-21 · diff ↗ ·
    removed 2 exports
    maxmax, minmin
    added 3 exports
    is_approximate, is_uncertain, mreport
  • 0.3.0
    record
    2022-06-02 · diff ↗ ·
    removed 3 exports
    NA_messydt_, interleave, resequence
    added 4 exports
    NA_mdate_, is_precise, maxmax, minmin
  • R
    R 4.2.0 released · 2022-04-22
Show 4 earlier eventsHide 4 earlier events
  • 0.2.1
    record
    2022-02-23 · diff ↗ ·
    added 1 export
    interleave
  • 0.2.0
    record
    2021-11-12 · diff ↗ ·
    added 5 exports
    as_approximate, as_uncertain, on_or_after, on_or_before, resequence
  • 0.1.1
    record
    2021-07-19
  • R
    R 4.1.0 released · 2021-05-18

Package metadata

First published
2021-07-19
Total releases
14 / 5 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1
Bundled data
0.8 KB / 1 file
Download size
3.6 MB

Cite

Cite this package

Run in R for the authors' entry:

citation("messydates")

The package provides a citation file, so citation() returns the authors' own entry.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for messydates version 1.1.1 [Data set]. HJJB, LLC. Data release v2026-10-19. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy