REVISIONATTIME{"topic" web="..." time="..."} -- returns the revision of a topic that was valid on a given date

  • The macro will return the Foswiki revision as a number, that was valid on the time given to the macro.
  • The time can be relative to the current time (always in the past) by giving a negative number in seconds.
  • If you asks for a revision on date in the format DD Mmm YYYY without a time one minute the time will be set to one minute to midnight end of the given day.
  • If the date given is older than the first revision of the topic, revision 0 is returned.
  • Syntax: %REVISIONATTIME{"topic" web="webname" time="time format - see below"}%
  • Supported parameters:
    Parameter: Description: Default:
    "topic" The topic that is expanded. It can be prefixed by the web name in which case the web parameter is ignorred Current topic
    web="webname" The web of the topic to be expanded. Current web
    time="time" Time can be in the formats DD Mmm YYYY, or in epoch (seconds since 1 Jan 1970), or as a negative number in seconds relative to now. If no time is given the current time is assumed. "0"
  • Example - give the revision of 1 week ago : %REVISIONATTIME{"TemplateTestTemplate" time="-604800"}%
  • Example of WikiUsers a week ago: %REVISIONATTIME{"Main.WikiUsers" time="-604800"}%
  • Example of WikiUsers 01 Jan 2012: %REVISIONATTIME{"Main.WikiUsers" time="01 Jan 2012"}%
  • Example of WikiUsers 01 Jan 1990: %REVISIONATTIME{"WikiUsers" web="Main" time="01 Jan 1990"}%
  • Example of defaults: %REVISIONATTIME{}%
Topic revision: r3 - 22 Jan 2016, KennethLavrsen
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy