docs: def date_options(func):
      """
      Decorator to add support for `--today/--not-today`, `--from` and `--to` options to the given command. The
      calculated date is then passed as a parameter named `date`.
      """
      @click.option(
          '--until', type=Date(), help="Only show entries until the given date."
      )
      @click.option(
          '--since', type=Date(), help="Only show entries starting at the given date.",
      )
      @click.option(
          '--today/--not-today', default=None, help="Only include today's entries (same as --since=today --until=today)"
          " or ignore today's entries (same as --until=yesterday)"
      )
      @functools.wraps(func)
      def wrapper(*args, **kwargs):
          since, until, today = kwargs.pop('since'), kwargs.pop('until'), kwargs.pop('today')
  
          if today is not None:
              if today:
                  date = datetime.date.today()
              else:
                  date = (None, datetime.date.today() - datetime.timedelta(days=1))
          elif since is not None or until is not None:
              date = (since, until)
          else:
              date = None
  
          kwargs['date'] = date
  
          return func(*args, **kwargs)
  
      return wrapper