New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
localtime docs #7779
Comments
From rirans@comcast.netCreated by rirans@comcast.netThe localtime documentation is misleading. The header That is the header is: localtime EXPR but should be: localtime EXPR Thanks, Perl Info
|
From @petdanceOn Mon, Jan 31, 2005 at 10:21:29PM -0000, rirans @ comcast. net (perlbug-followup@perl.org) wrote:
Fixed, plus some other cleanup on the text to make it easier for the xoxo, -- |
From @petdanceperlfunc.patch--- pod/perlfunc.pod 2004-12-10 16:30:06.000000000 -0600
+++ perlfunc.pod 2005-01-31 21:11:39.208826147 -0600
@@ -2519,36 +2519,44 @@
=item localtime EXPR
+=item localtime
+
Converts a time as returned by the time function to a 9-element list
with the time analyzed for the local time zone. Typically used as
follows:
# 0 1 2 3 4 5 6 7 8
($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) =
- localtime(time);
+ localtime(time);
All list elements are numeric, and come straight out of the C `struct
-tm'. $sec, $min, and $hour are the seconds, minutes, and hours of the
-specified time. $mday is the day of the month, and $mon is the month
-itself, in the range C<0..11> with 0 indicating January and 11
-indicating December. $year is the number of years since 1900. That
-is, $year is C<123> in year 2023. $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 C<0..364> (or C<0..365> in leap years.) $isdst
-is true if the specified time occurs during daylight savings time,
-false otherwise.
-
-Note that the $year element is I<not> simply the last two digits of
-the year. If you assume it is, then you create non-Y2K-compliant
-programs--and you wouldn't want to do that, would you?
+tm'. C<$sec>, C<$min>, and C<$hour> are the seconds, minutes, and hours
+of the specified time.
+
+C<$mday> is the day of the month, and C<$mon> is the month itself, in
+the range C<0..11> with 0 indicating January and 11 indicating December.
+This makes it easy to get a month name from a list:
+
+ my @abbr = qw( Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec );
+ print "$abbr[$mon] $mday";
+ # $mon=9, $mday=18 gives "Oct 18"
+
+C<$year> is the number of years since 1900, not just the last two digits
+of the year. That is, C<$year> is C<123> in year 2023. The proper way
+to get a complete 4-digit year is simply:
+
+ $year += 1900;
-The proper way to get a complete 4-digit year is simply:
+To get the last two digits of the year (e.g., '01' in 2001) do:
- $year += 1900;
+ $year = sprintf("%02d", $year % 100);
-And to get the last two digits of the year (e.g., '01' in 2001) do:
+C<$wday> is the day of the week, with 0 indicating Sunday and 3 indicating
+Wednesday. C<$yday> is the day of the year, in the range C<0..364>
+(or C<0..365> in leap years.)
- $year = sprintf("%02d", $year % 100);
+C<$isdst> is true if the specified time occurs during Daylight Saving
+Time, false otherwise.
If EXPR is omitted, C<localtime()> uses the current time (C<localtime(time)>).
|
The RT System itself - Status changed from 'new' to 'open' |
From @rgsAndy Lester wrote:
Thanks, applied as #23916 to BleadPerl. |
@rgs - Status changed from 'open' to 'resolved' |
Migrated from rt.perl.org#34010 (status was 'resolved')
Searchable as RT34010$
The text was updated successfully, but these errors were encountered: