NAME

SPVM::Time - Time manipulation

SYNOPSYS

  use SPVM::Time;
  
  # Epoch time
  my $time = SPVM::Time->time;
  
  # Local time information
  my $time_info = SPVM::Time->localtime(SPVM::Time->time);
  
  # GM time information
  my $time_info = SPVM::Time->gmtime(SPVM::Time->time);
  
  # Convert L<SPVM::Time::Info> which is local time zone to calender time as same as time method format.
  my $time = SPVM::Time->timelocal($time_info);
  
  # Convert L<SPVM::Time::Info> which is the standard Greenwich time zone to calender time as same as time method format.
  my $time = SPVM::Time->timegm($time_info);
  
  # Parse string and convert it to a L<SPVM::Time::Info> object.
  my $time_info = SPVM::Time->strptime("2019-12-15 10:24:55", "%Y-%m-%d %H:%M:%S")
  
  # Convert SPVM::Time::Info to string by specific format.
  my $datetime_str = SPVM::Time->strftime("%Y-%m-%d %H:%M:%S", $time_info)

DESCRIPTION

Time manipulation.

STATIC METHODS

time

  sub time : long ();

Returns the number of non-leap seconds since whatever time the system considers to be the epoch, suitable for feeding to "gmtime" and "localtime". On most systems the epoch is 00:00:00 UTC, January 1, 1970;

Example:

  my $time = SPVM::Time->time;

localtime

  sub localtime : SPVM::Time::Info ($time : long)

Converts a time as returned by the time method to a SPVM::Time::Info object with the time analyzed for the local time zone.

Example:

  my $time_info = SPVM::Time->localtime(SPVM::Time->time);

"mday" is the day of the month and "mon" the month in the range 0..11, with 0 indicating January and 11 indicating December.

"year" contains the number of years since 1900. To get a 4-digit year write:

    my $year = $time_info->year + 1900;

"wday" is the day of the week, with 0 indicating Sunday and 3 indicating Wednesday. "yday" is the day of the year, in the range 0..364 (or 0..365 in leap years.)

"isdst" is true if the specified time occurs during Daylight Saving Time, false otherwise.

If you get current time information, pass return value of "time" method.

  my $time_info = SPVM::Time->localtime(SPVM::Time->time)

See also the "timelocal" method. (for converting seconds, minutes, hours, and such back to the integer value returned by time()).

gmtime

  sub gmtime : SPVM::Time::Info ($time : long)

Works just like "localtime" but the returned values are localized for the standard Greenwich time zone.

See also the "timegm" method. (for converting seconds, minutes, hours, and such back to the integer value returned by time()).

timelocal

  sub timelocal : long ($time_info : SPVM::Time::Info)

timelocal method convert SPVM::Time::Info which is local time zone to calender time as same as time method format.

wday and yday is ignored.

  my $time = SPVM::Time->timelocal($time_info);

timegm

  sub timegm : long ($time_info : SPVM::Time::Info)

timegm method convert SPVM::Time::Info which is the standard Greenwich time zone to calender time as same as time method format.

wday and yday is ignored.

  my $time = SPVM::Time->timegm($time_info);

strftime

  sub strftime : string ($format : string, $time_info : SPVM::Time::Info)

Convert SPVM::Time::Info to string by specific format.

  my $datetime_str = SPVM::Time->strftime("%Y-%m-%d %H:%M:%S", $time_info)

Supported Format:

  %Y is replaced by the year with century as a decimal number.
  %m is replaced by the month as a decimal number (01-12).
  %d is replaced by the day of the month as a decimal number (01-31).
  %H is replaced by the hour (24-hour clock) as a decimal number (00-23).
  %M is replaced by the minute as a decimal number (00-59).
  %S is replaced by the second as a decimal number (00-60).

strptime

  sub strptime : SPVM::Time::Info ($str : string, $format : string)

Parse string and convert it to a SPVM::Time::Info object.

  my $time_info = SPVM::Time->strptime("2019-12-15 10:24:55", "%Y-%m-%d %H:%M:%S")

See strftime method about supported format.

cpanm SPVM

perl -MCPAN -e shell
install SPVM