Elizabeth Grace Frank-Backman > SVN-Friendly > SVN::Friendly::Dates

Download:
SVN-Friendly-0.999_002.tar.gz

Dependencies

Annotate this POD

Source  

NAME ^

SVN::Friendly::Dates - convert subversion times to Perl time

SYNOPSIS ^

  # ---------------------------------------------------------------
  # $iAprTime    Apache runtime timestamp, number of microseconds
  #              since 00:00:00 UTC, January 1, 1970
  #
  # $iPrecision  may be any one of the following constants
  #              SVN::Friendly::Dates->DAY
  #              SVN::Friendly::Dates->MINUTE
  #              SVN::Friendly::Dates->SECOND
  #              SVN::Friendly::Dates->USEC
  #
  # $sISOTime     ISO 8601 formatted timestamp provided by subversion
  #              (some functions provide the string rather than
  #               microseconds since epoch time).
  # ---------------------------------------------------------------

  use SVN::Friendly::Dates /.*/;  #import all


  # --------------------------------------------------
  # decompresses ISO time, replaces Z with UTC, e.g.
  #
  # 1970-01-01T00:00:00.000000
  #   DAY    => 1970-01-01
  #   MINUTE => 1970-01-01 00:00 UTC
  #   SECOND => 1970-01-01 00:00:00 UTC
  #   USEC   => 1970-01-01 00:00:00.000000 UTC
  # --------------------------------------------------

  $sTimestamp    = getTimestampFromISO8601($sISOTime, $iPrecision);

  $sTimestamp    = getTimestamp($iAprTime, $iPrecision);

  # --------------------------------------------------
  # local/utc seconds since the epoch in various units
  # --------------------------------------------------

  $iSeconds      = getUtcPerlTime($iAprTime);

  $iNanoseconds  = getUtcNanoTime($iAprTime);

  $iSeconds      = getLocalPerlTime($iAprTime);

  $iMicroseconds = getLocalUsecTime($iAprTime);

  $iNanoseconds  = getLocalNanoTime($iAprTime);

DESCRIPTION ^

This class defines tools for converting the timestamps used by subversion into Perl time. Subversion uses the apache runtime library and its timestamps have a different unit (microseconds) than Perl time which is calculated in non-leap seconds past 00:00:00 UTC, January 1, 1970.

VERSION COMPATIBILITY ^

See SVN::Friendly.

CAVEATS ^

None to date.

KNOWN BUGS ^

None to date.

TO DO/ROADMAP ^

See SVN::Friendly

VOLUNTEERS ^

If anyone would like to be involved in testing or expanding the user friendly interface, please contact the maintainer.

Feedback on the documentation, bugs, usability, or additional features desired is welcome. Time and person-power permitting the most commonly requested features will be implemented.

SEE ALSO ^

See SVN::Friendly

AUTHOR ^

Elizabeth Grace Frank-Backman

COPYRIGHT ^

Copyright (c) 2008-2011 Elizabeth Grace Frank-Backman. All rights reserved.

LICENSE ^

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: