home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _fe3687c784bf3363267efdc19e25b9bc < prev    next >
Text File  |  2000-03-23  |  6KB  |  171 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Date::Format - Date formating subroutines</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Date::Format - Date formating subroutines</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#multilanguage support">MULTI-LANGUAGE SUPPORT</A></LI>
  26.     <LI><A HREF="#conversion specification">CONVERSION SPECIFICATION</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>Date::Format - Date formating subroutines</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <PRE>
  47.         use Date::Format;
  48. </PRE>
  49. <PRE>
  50.  
  51.         @lt = timelocal(time);</PRE>
  52. <PRE>
  53.  
  54.         print time2str($template, time);
  55.         print strftime($template, @lt);</PRE>
  56. <PRE>
  57.  
  58.         print time2str($template, time, $zone);
  59.         print strftime($template, @lt, $zone);</PRE>
  60. <PRE>
  61.  
  62.         print ctime(time);
  63.         print ascctime(@lt);</PRE>
  64. <PRE>
  65.  
  66.         print ctime(time, $zone);
  67.         print asctime(@lt, $zone);</PRE>
  68. <P>
  69. <HR>
  70. <H1><A NAME="description">DESCRIPTION</A></H1>
  71. <P>This module provides routines to format dates into ASCII strings. They
  72. correspond to the C library routines <A HREF="#item_strftime"><CODE>strftime</CODE></A> and <A HREF="#item_ctime"><CODE>ctime</CODE></A>.</P>
  73. <DL>
  74. <DT><STRONG><A NAME="item_time2str">time2str(TEMPLATE, TIME [, ZONE])</A></STRONG><BR>
  75. <DD>
  76. <A HREF="#item_time2str"><CODE>time2str</CODE></A> converts <CODE>TIME</CODE> into an ASCII string using the conversion
  77. specification given in <CODE>TEMPLATE</CODE>. <CODE>ZONE</CODE> if given specifies the zone
  78. which the output is required to be in, <CODE>ZONE</CODE> defaults to your current zone.
  79. <P></P>
  80. <DT><STRONG><A NAME="item_strftime">strftime(TEMPLATE, TIME [, ZONE])</A></STRONG><BR>
  81. <DD>
  82. <A HREF="#item_strftime"><CODE>strftime</CODE></A> is similar to <A HREF="#item_time2str"><CODE>time2str</CODE></A> with the exception that the time is
  83. passed as an array, such as the array returned by <A HREF="../../../lib/Pod/perlfunc.html#item_localtime"><CODE>localtime</CODE></A>.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_ctime">ctime(TIME [, ZONE])</A></STRONG><BR>
  86. <DD>
  87. <A HREF="#item_ctime"><CODE>ctime</CODE></A> calls <A HREF="#item_time2str"><CODE>time2str</CODE></A> with the given arguments using the
  88. conversion specification <CODE>"%a %b %e %T %Y\n"</CODE>
  89. <P></P>
  90. <DT><STRONG><A NAME="item_asctime">asctime(TIME [, ZONE])</A></STRONG><BR>
  91. <DD>
  92. <A HREF="#item_asctime"><CODE>asctime</CODE></A> calls <A HREF="#item_time2str"><CODE>time2str</CODE></A> with the given arguments using the
  93. conversion specification <CODE>"%a %b %e %T %Y\n"</CODE>
  94. <P></P></DL>
  95. <P>
  96. <HR>
  97. <H1><A NAME="multilanguage support">MULTI-LANGUAGE SUPPORT</A></H1>
  98. <P>Date::Format is capable of formating into several languages, these are
  99. English, French, German and Italian. Changing the language is done via
  100. a static method call, for example</P>
  101. <PRE>
  102.         Date::Format->language('German');</PRE>
  103. <P>will change the language in which all subsequent dates are formatted.</P>
  104. <P>This is only a first pass, I am considering changing this to be</P>
  105. <PRE>
  106.         $lang = Date::Language->new('German');
  107.         $lang->time2str("%a %b %e %T %Y\n", time);</PRE>
  108. <P>I am open to suggestions on this.</P>
  109. <P>
  110. <HR>
  111. <H1><A NAME="conversion specification">CONVERSION SPECIFICATION</A></H1>
  112. <P>Each conversion specification  is  replaced  by  appropriate
  113. characters   as   described  in  the  following  list.   The
  114. appropriate  characters  are  determined  by   the   LC_TIME
  115. category of the program's locale.</P>
  116. <PRE>
  117.         %%      PERCENT
  118.         %a      day of the week abbr
  119.         %A      day of the week
  120.         %b      month abbr
  121.         %B      month
  122.         %c      ctime format: Sat Nov 19 21:05:57 1994
  123.         %d      numeric day of the month
  124.         %e      DD
  125.         %D      MM/DD/YY
  126.         %h      month abbr
  127.         %H      hour, 24 hour clock, leading 0's)
  128.         %I      hour, 12 hour clock, leading 0's)
  129.         %j      day of the year
  130.         %k      hour
  131.         %l      hour, 12 hour clock
  132.         %m      month number, starting with 1
  133.         %M      minute, leading 0's
  134.         %n      NEWLINE
  135.         %o      ornate day of month -- "1st", "2nd", "25th", etc.
  136.         %p      AM or PM 
  137.         %r      time format: 09:05:57 PM
  138.         %R      time format: 21:05
  139.         %s      seconds since the Epoch, UCT
  140.         %S      seconds, leading 0's
  141.         %t      TAB
  142.         %T      time format: 21:05:57
  143.         %U      week number, Sunday as first day of week
  144.         %w      day of the week, numerically, Sunday == 0
  145.         %W      week number, Monday as first day of week
  146.         %x      date format: 11/19/94
  147.         %X      time format: 21:05:57
  148.         %y      year (2 digits)
  149.         %Y      year (4 digits)
  150.         %Z      timezone in ascii. eg: PST
  151.         %z      timezone in format -/+0000</PRE>
  152. <P>
  153. <HR>
  154. <H1><A NAME="author">AUTHOR</A></H1>
  155. <P>Graham Barr <<A HREF="mailto:Graham.Barr@pobox.com">Graham.Barr@pobox.com</A>></P>
  156. <P>
  157. <HR>
  158. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  159. <P>Copyright (c) 1995-8 Graham Barr. All rights reserved. This program is free
  160. software; you can redistribute it and/or modify it under the same terms
  161. as Perl itself.</P>
  162. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  163. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  164. <STRONG><P CLASS=block> Date::Format - Date formating subroutines</P></STRONG>
  165. </TD></TR>
  166. </TABLE>
  167.  
  168. </BODY>
  169.  
  170. </HTML>
  171.