NAME

       datalad check-dates - find repository dates that are more recent than a reference date.

SYNOPSIS

       datalad  check-dates  [-h]  [-D  DATE]  [--rev  REVISION] [--annex {all|tree|none}] [--no-tags] [--older]
              [--version] [PATH ...]

DESCRIPTION

       The main purpose of this tool is to find "leaked" real dates in repositories that are configured  to  use
       fake  dates.  It checks dates from three sources: (1) commit timestamps (author and committer dates), (2)
       timestamps within files of the "git-annex" branch, and (3) the timestamps of annotated tags.

OPTIONS

       PATH   Root directory in which to search for Git repositories. The current working directory will be used
              by default. Constraints: value must be a string or value must be NONE

       -h, --help, --help-np
              show this help message. --help-np forcefully disables the use of a pager for displaying  the  help
              message

       -D DATE, --reference-date DATE
              Compare dates to this date. If dateutil is installed, this value can be any format that its parser
              recognizes.  Otherwise,  it  should  be a unix timestamp that starts with a "@". The default value
              corresponds to 01 Jan, 2018  00:00:00  -0000.  Constraints:  value  must  be  a  string  [Default:
              '@1514764800']

       --rev REVISION
              Search  timestamps  from commits that are reachable from REVISION. Any revision specification sup‐
              ported by git log, including flags like --all and --tags, can be used. This option  can  be  given
              multiple times.

       --annex {all|tree|none}
              Mode  for  "git-annex"  branch  search. If 'all', all blobs within the branch are searched. 'tree'
              limits the search to blobs that are referenced by the tree at the tip of the branch.  'none'  dis‐
              ables  search of "git-annex" blobs. Constraints: value must be one of ('all', 'tree', 'none') [De‐
              fault: 'all']

       --no-tags
              Don't check the dates of annotated tags.

       --older
              Find dates which are older than the reference date rather than newer.

       --version
              show the module and its version which provides the command

AUTHORS

        datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

datalad check-dates 1.1.5                          2025-06-15                             datalad check-dates(1)