| 1 |
Time::Format version 1.16 |
| 2 |
========================= |
| 3 |
|
| 4 |
Time::Format provides a very easy way to format dates and times. The |
| 5 |
formatting functions are tied to hash variables, so they can be used |
| 6 |
inside strings as well as in ordinary expressions. The formatting |
| 7 |
codes used are meant to be easy to remember, use, and read. They |
| 8 |
follow a simple, consistent pattern. If I've done my job right, once |
| 9 |
you learn the codes, you should never have to refer to the |
| 10 |
documentation again. |
| 11 |
A quick-reference page is included, just in case. ;-) |
| 12 |
|
| 13 |
Time::Format can also format DateTime objects, and strings created |
| 14 |
with Date::Manip. |
| 15 |
|
| 16 |
Also provided is a tied-hash interface to POSIX::strftime and |
| 17 |
Date::Manip::UnixDate. |
| 18 |
|
| 19 |
If the I18N::Langinfo module is available, Time::Format provides |
| 20 |
weekday and month names in a language appropriate for your locale. |
| 21 |
|
| 22 |
A companion module, Time::Format_XS, is also available; if it is |
| 23 |
installed, Time::Format will detect and use it, which will result in a |
| 24 |
significant speed improvement. |
| 25 |
|
| 26 |
|
| 27 |
EXAMPLES |
| 28 |
|
| 29 |
$time{'Weekday Month d, yyyy'} Thursday June 5, 2003 |
| 30 |
$time{'Day Mon d, yyyy'} Thu Jun 5, 2003 |
| 31 |
$time{'DAY MON d, yyyy'} THU JUN 5, 2003 |
| 32 |
$time{'dd/mm/yyyy'} 05/06/2003 |
| 33 |
$time{yymmdd} 030605 |
| 34 |
$time{'yymmdd',time-86400} 030604 |
| 35 |
|
| 36 |
$time{'H:mm:ss am'} 1:02:14 pm |
| 37 |
$time{'hh:mm:ss.uuuuuu'} 13:02:14.171447 |
| 38 |
|
| 39 |
$time{'yyyy/mm/dd hh:mm:ss.mmm'} 2003/06/05 13:02:14.171 |
| 40 |
|
| 41 |
$strftime{'%A %B %d, %Y'} Thursday June 05, 2003 |
| 42 |
$strftime{'%A %B %d, %Y',time+86400} Friday June 06, 2003 |
| 43 |
|
| 44 |
$manip{'%m/%d/%Y'} 06/05/2003 |
| 45 |
$manip{'%m/%d/%Y','yesterday'} 06/04/2003 |
| 46 |
$manip{'%m/%d/%Y','first monday in November 2000'} 11/06/2000 |
| 47 |
|
| 48 |
There are also corresponding functions for each of these hashes, which |
| 49 |
you can use if you prefer (or need) a function-based interface. |
| 50 |
|
| 51 |
|
| 52 |
INSTALLATION |
| 53 |
|
| 54 |
To install this module, issue the following commands: |
| 55 |
|
| 56 |
perl Build.PL |
| 57 |
perl Build |
| 58 |
perl Build test |
| 59 |
perl Build install |
| 60 |
|
| 61 |
If you do not have Module::Build, use the old-style commands: |
| 62 |
|
| 63 |
perl Makefile.PL |
| 64 |
make |
| 65 |
make test |
| 66 |
make install |
| 67 |
|
| 68 |
If you're using Strawberry Perl, you may need to use 'gmake' instead |
| 69 |
of 'make' (or 'dmake' for older Strawberry versions). If you're using |
| 70 |
ActiveState Perl, you may need to use 'nmake'. |
| 71 |
|
| 72 |
|
| 73 |
DEPENDENCIES |
| 74 |
|
| 75 |
This module can use these other modules and libraries: |
| 76 |
|
| 77 |
Time::Local |
| 78 |
I18N::Langinfo (optional) |
| 79 |
POSIX (optional) |
| 80 |
Time::HiRes (optional) |
| 81 |
Date::Manip (optional) |
| 82 |
Time::Format_XS (optional) |
| 83 |
FindBin (used by the test suite only) |
| 84 |
Test::More (used by the test suite only) |
| 85 |
Module::Signature (optional) (used by the test suite only) |
| 86 |
|
| 87 |
|
| 88 |
COPYRIGHT AND LICENSE |
| 89 |
|
| 90 |
Eric J. Roode, roode @ cpan . org |
| 91 |
|
| 92 |
Copyright (c) 2003-2020 by Eric J. Roode. All Rights Reserved. |
| 93 |
This module is free software; See the copyright notice in the |
| 94 |
module source code for full details. |
| 95 |
|
| 96 |
To avoid my spam filter, please include "Perl", "module", or this |
| 97 |
module's name in the message's subject line, and/or GPG-sign your |
| 98 |
message. |