Debian Codegraph @

README

raw
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.