NAME

No::Worries::Date - date handling without worries

SYNOPSIS

  use No::Worries::Date qw(date_parse date_stamp date_string);

  $string = date_stamp();
  # e.g. 2012/04/12-11:01:42

  $string = date_string(time());
  # e.g. 2012-04-12T09:01:42Z

  $string = date_string(Time::HiRes::time());
  # e.g. 2012-04-12T09:01:42.48602Z

  $time = date_parse("Sun, 06 Nov 1994 08:49:37 GMT");

DESCRIPTION

This module eases date handling by providing convenient wrappers around standard date functions. All the functions die() on error.

The strings and times may include fractional seconds like in the example above.

date_parse() can accept many more formats than simply what date_stamp() and date_string() return.

FUNCTIONS

This module provides the following functions (none of them being exported by default):

date_parse(STRING)

parse the given string and return the corresponding numerical time (i.e. the number of non-leap seconds since the epoch) or an error; HTTP::Date's str2time() is used for the parsing

date_stamp([TIME])

convert the given numerical time (or the current time if not given) to a human friendly, compact, local time string

date_string([TIME])

convert the given numerical time (or the current time if not given) to a standard, ISO 8601 compliant, UTC based string

SEE ALSO

HTTP::Date, No::Worries.

AUTHOR

Lionel Cons http://cern.ch/lionel.cons

Copyright (C) CERN 2012-2019