Bug#1123023: Time::Moment.3pm: Some remarks and a patch with editorial changes for this man page
Bjarni Ingi Gislason
bjarniig at simnet.is
Mon Dec 15 23:42:21 GMT 2025
Package: Libtime-moment-perl
Version: 0.46-1
Severity: minor
Tags: patch
Dear Maintainer,
>From "/usr/share/doc/debian/bug-reporting.txt.gz":
Don't file bugs upstream
If you file a bug in Debian, don't send a copy to the upstream software
maintainers yourself, as it is possible that the bug exists only in
Debian. If necessary, the maintainer of the package will forward the
bug upstream.
-.-
I do not send reports upstream if I have to get an account there.
The Debian maintainers have one already.
If I get a negative (or no) response from upstream, I send henceforth
bugs to Debian.
-.-
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z < "man page"
[Use
grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>
to find (most) trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
Output from "test-nroff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z ":
troff:<stdin>:86: warning: trailing space in the line
troff:<stdin>:91: warning: trailing space in the line
troff:<stdin>:96: warning: trailing space in the line
troff:<stdin>:108: warning: trailing space in the line
troff:<stdin>:111: warning: trailing space in the line
troff:<stdin>:115: warning: trailing space in the line
troff:<stdin>:136: warning: trailing space in the line
troff:<stdin>:139: warning: trailing space in the line
troff:<stdin>:141: warning: trailing space in the line
troff:<stdin>:152: warning: trailing space in the line
troff:<stdin>:163: warning: trailing space in the line
troff:<stdin>:174: warning: trailing space in the line
troff:<stdin>:176: warning: trailing space in the line
troff:<stdin>:179: warning: trailing space in the line
troff:<stdin>:183: warning: trailing space in the line
troff:<stdin>:187: warning: trailing space in the line
troff:<stdin>:189: warning: trailing space in the line
troff:<stdin>:191: warning: trailing space in the line
troff:<stdin>:194: warning: trailing space in the line
troff:<stdin>:199: warning: trailing space in the line
troff:<stdin>:204: warning: trailing space in the line
troff:<stdin>:206: warning: trailing space in the line
troff:<stdin>:213: warning: trailing space in the line
troff:<stdin>:218: warning: trailing space in the line
troff:<stdin>:219: warning: trailing space in the line
troff:<stdin>:220: warning: trailing space in the line
troff:<stdin>:221: warning: trailing space in the line
troff:<stdin>:224: warning: trailing space in the line
troff:<stdin>:225: warning: trailing space in the line
troff:<stdin>:255: warning: trailing space in the line
troff:<stdin>:278: warning: trailing space in the line
troff:<stdin>:279: warning: trailing space in the line
troff:<stdin>:287: warning: trailing space in the line
troff:<stdin>:297: warning: trailing space in the line
troff:<stdin>:298: warning: trailing space in the line
troff:<stdin>:308: warning: trailing space in the line
troff:<stdin>:324: warning: trailing space in the line
troff:<stdin>:325: warning: trailing space in the line
troff:<stdin>:335: warning: trailing space in the line
troff:<stdin>:336: warning: trailing space in the line
troff:<stdin>:346: warning: trailing space in the line
troff:<stdin>:354: warning: trailing space in the line
troff:<stdin>:368: warning: trailing space in the line
troff:<stdin>:369: warning: trailing space in the line
troff:<stdin>:370: warning: trailing space in the line
troff:<stdin>:371: warning: trailing space in the line
troff:<stdin>:372: warning: trailing space in the line
troff:<stdin>:373: warning: trailing space in the line
troff:<stdin>:374: warning: trailing space in the line
troff:<stdin>:384: warning: trailing space in the line
troff:<stdin>:388: warning: trailing space in the line
troff:<stdin>:393: warning: trailing space in the line
troff:<stdin>:398: warning: trailing space in the line
troff:<stdin>:402: warning: trailing space in the line
troff:<stdin>:409: warning: trailing space in the line
troff:<stdin>:410: warning: trailing space in the line
troff:<stdin>:422: warning: trailing space in the line
troff:<stdin>:428: warning: trailing space in the line
troff:<stdin>:434: warning: trailing space in the line
troff:<stdin>:442: warning: trailing space in the line
troff:<stdin>:446: warning: trailing space in the line
troff:<stdin>:452: warning: trailing space in the line
troff:<stdin>:453: warning: trailing space in the line
troff:<stdin>:454: warning: trailing space in the line
troff:<stdin>:455: warning: trailing space in the line
troff:<stdin>:456: warning: trailing space in the line
troff:<stdin>:457: warning: trailing space in the line
troff:<stdin>:466: warning: trailing space in the line
troff:<stdin>:467: warning: trailing space in the line
troff:<stdin>:468: warning: trailing space in the line
troff:<stdin>:469: warning: trailing space in the line
troff:<stdin>:479: warning: trailing space in the line
troff:<stdin>:495: warning: trailing space in the line
troff:<stdin>:504: warning: trailing space in the line
troff:<stdin>:505: warning: trailing space in the line
troff:<stdin>:506: warning: trailing space in the line
troff:<stdin>:507: warning: trailing space in the line
troff:<stdin>:525: warning: trailing space in the line
troff:<stdin>:534: warning: trailing space in the line
troff:<stdin>:535: warning: trailing space in the line
troff:<stdin>:536: warning: trailing space in the line
troff:<stdin>:537: warning: trailing space in the line
troff:<stdin>:555: warning: trailing space in the line
troff:<stdin>:712: warning: trailing space in the line
troff:<stdin>:713: warning: trailing space in the line
troff:<stdin>:722: warning: trailing space in the line
troff:<stdin>:723: warning: trailing space in the line
troff:<stdin>:724: warning: trailing space in the line
troff:<stdin>:725: warning: trailing space in the line
troff:<stdin>:734: warning: trailing space in the line
troff:<stdin>:735: warning: trailing space in the line
troff:<stdin>:736: warning: trailing space in the line
troff:<stdin>:737: warning: trailing space in the line
troff:<stdin>:746: warning: trailing space in the line
troff:<stdin>:747: warning: trailing space in the line
troff:<stdin>:748: warning: trailing space in the line
troff:<stdin>:749: warning: trailing space in the line
troff:<stdin>:757: warning: trailing space in the line
troff:<stdin>:759: warning: trailing space in the line
troff:<stdin>:768: warning: trailing space in the line
troff:<stdin>:776: warning: trailing space in the line
troff:<stdin>:777: warning: trailing space in the line
troff:<stdin>:778: warning: trailing space in the line
troff:<stdin>:786: warning: trailing space in the line
troff:<stdin>:787: warning: trailing space in the line
troff:<stdin>:788: warning: trailing space in the line
troff:<stdin>:796: warning: trailing space in the line
troff:<stdin>:804: warning: trailing space in the line
troff:<stdin>:812: warning: trailing space in the line
troff:<stdin>:813: warning: trailing space in the line
troff:<stdin>:821: warning: trailing space in the line
troff:<stdin>:822: warning: trailing space in the line
troff:<stdin>:830: warning: trailing space in the line
troff:<stdin>:838: warning: trailing space in the line
troff:<stdin>:846: warning: trailing space in the line
troff:<stdin>:854: warning: trailing space in the line
troff:<stdin>:862: warning: trailing space in the line
troff:<stdin>:870: warning: trailing space in the line
troff:<stdin>:878: warning: trailing space in the line
troff:<stdin>:887: warning: trailing space in the line
troff:<stdin>:888: warning: trailing space in the line
troff:<stdin>:889: warning: trailing space in the line
troff:<stdin>:897: warning: trailing space in the line
troff:<stdin>:906: warning: trailing space in the line
troff:<stdin>:907: warning: trailing space in the line
troff:<stdin>:908: warning: trailing space in the line
troff:<stdin>:916: warning: trailing space in the line
troff:<stdin>:924: warning: trailing space in the line
troff:<stdin>:925: warning: trailing space in the line
troff:<stdin>:933: warning: trailing space in the line
troff:<stdin>:934: warning: trailing space in the line
troff:<stdin>:937: warning: trailing space in the line
troff:<stdin>:951: warning: trailing space in the line
troff:<stdin>:952: warning: trailing space in the line
troff:<stdin>:955: warning: trailing space in the line
troff:<stdin>:956: warning: trailing space in the line
troff:<stdin>:970: warning: trailing space in the line
troff:<stdin>:971: warning: trailing space in the line
troff:<stdin>:972: warning: trailing space in the line
troff:<stdin>:973: warning: trailing space in the line
troff:<stdin>:991: warning: trailing space in the line
troff:<stdin>:992: warning: trailing space in the line
troff:<stdin>:993: warning: trailing space in the line
troff:<stdin>:1001: warning: trailing space in the line
troff:<stdin>:1002: warning: trailing space in the line
troff:<stdin>:1003: warning: trailing space in the line
troff:<stdin>:1004: warning: trailing space in the line
troff:<stdin>:1047: warning: trailing space in the line
troff:<stdin>:1055: warning: trailing space in the line
troff:<stdin>:1063: warning: trailing space in the line
troff:<stdin>:1071: warning: trailing space in the line
troff:<stdin>:1072: warning: trailing space in the line
troff:<stdin>:1073: warning: trailing space in the line
troff:<stdin>:1081: warning: trailing space in the line
troff:<stdin>:1082: warning: trailing space in the line
troff:<stdin>:1083: warning: trailing space in the line
troff:<stdin>:1084: warning: trailing space in the line
troff:<stdin>:1127: warning: trailing space in the line
troff:<stdin>:1135: warning: trailing space in the line
troff:<stdin>:1143: warning: trailing space in the line
troff:<stdin>:1151: warning: trailing space in the line
troff:<stdin>:1152: warning: trailing space in the line
troff:<stdin>:1160: warning: trailing space in the line
troff:<stdin>:1161: warning: trailing space in the line
troff:<stdin>:1169: warning: trailing space in the line
troff:<stdin>:1170: warning: trailing space in the line
troff:<stdin>:1178: warning: trailing space in the line
troff:<stdin>:1179: warning: trailing space in the line
troff:<stdin>:1187: warning: trailing space in the line
troff:<stdin>:1188: warning: trailing space in the line
troff:<stdin>:1196: warning: trailing space in the line
troff:<stdin>:1197: warning: trailing space in the line
troff:<stdin>:1205: warning: trailing space in the line
troff:<stdin>:1206: warning: trailing space in the line
troff:<stdin>:1214: warning: trailing space in the line
troff:<stdin>:1215: warning: trailing space in the line
troff:<stdin>:1223: warning: trailing space in the line
troff:<stdin>:1224: warning: trailing space in the line
troff:<stdin>:1232: warning: trailing space in the line
troff:<stdin>:1233: warning: trailing space in the line
troff:<stdin>:1241: warning: trailing space in the line
troff:<stdin>:1253: warning: trailing space in the line
troff:<stdin>:1268: warning: trailing space in the line
troff:<stdin>:1283: warning: trailing space in the line
troff:<stdin>:1291: warning: trailing space in the line
troff:<stdin>:1299: warning: trailing space in the line
troff:<stdin>:1307: warning: trailing space in the line
troff:<stdin>:1315: warning: trailing space in the line
troff:<stdin>:1323: warning: trailing space in the line
troff:<stdin>:1332: warning: trailing space in the line
troff:<stdin>:1333: warning: trailing space in the line
troff:<stdin>:1334: warning: trailing space in the line
troff:<stdin>:1336: warning: trailing space in the line
troff:<stdin>:1337: warning: trailing space in the line
troff:<stdin>:1345: warning: trailing space in the line
troff:<stdin>:1354: warning: trailing space in the line
troff:<stdin>:1375: warning: trailing space in the line
troff:<stdin>:1384: warning: trailing space in the line
troff:<stdin>:1385: warning: trailing space in the line
troff:<stdin>:1386: warning: trailing space in the line
troff:<stdin>:1393: warning: trailing space in the line
troff:<stdin>:1413: warning: trailing space in the line
troff:<stdin>:1418: warning: trailing space in the line
troff:<stdin>:1431: warning: trailing space in the line
troff:<stdin>:1436: warning: trailing space in the line
troff:<stdin>:1437: warning: trailing space in the line
troff:<stdin>:1438: warning: trailing space in the line
troff:<stdin>:1439: warning: trailing space in the line
troff:<stdin>:1455: warning: trailing space in the line
troff:<stdin>:1461: warning: trailing space in the line
troff:<stdin>:1462: warning: trailing space in the line
troff:<stdin>:1465: warning: trailing space in the line
troff:<stdin>:1466: warning [page 1, line 1131]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1474: warning: trailing space in the line
troff:<stdin>:1499: warning: trailing space in the line
troff:<stdin>:1502: warning: trailing space in the line
troff:<stdin>:1503: warning [page 1, line 1154]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1507: warning: trailing space in the line
troff:<stdin>:1510: warning: trailing space in the line
troff:<stdin>:1511: warning [page 1, line 1160]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1527: warning: trailing space in the line
troff:<stdin>:1528: warning: trailing space in the line
troff:<stdin>:1529: warning: trailing space in the line
troff:<stdin>:1547: warning: trailing space in the line
troff:<stdin>:1550: warning: trailing space in the line
troff:<stdin>:1551: warning [page 1, line 1188]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1559: warning: trailing space in the line
troff:<stdin>:1568: warning: trailing space in the line
troff:<stdin>:1571: warning: trailing space in the line
troff:<stdin>:1572: warning [page 1, line 1201]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1588: warning: trailing space in the line
troff:<stdin>:1593: warning: trailing space in the line
troff:<stdin>:1594: warning: trailing space in the line
troff:<stdin>:1599: warning: trailing space in the line
troff:<stdin>:1600: warning: trailing space in the line
troff:<stdin>:1601: warning: trailing space in the line
troff:<stdin>:1602: warning: trailing space in the line
troff:<stdin>:1607: warning: trailing space in the line
troff:<stdin>:1612: warning: trailing space in the line
troff:<stdin>:1613: warning: trailing space in the line
troff:<stdin>:1642: warning: trailing space in the line
troff:<stdin>:1701: warning: trailing space in the line
troff:<stdin>:1728: warning: trailing space in the line
troff:<stdin>:1754: warning: trailing space in the line
troff:<stdin>:1767: warning: trailing space in the line
troff:<stdin>:1775: warning: trailing space in the line
troff:<stdin>:1781: warning: trailing space in the line
troff:<stdin>:1793: warning: trailing space in the line
troff:<stdin>:1794: warning: trailing space in the line
troff:<stdin>:1795: warning: trailing space in the line
troff:<stdin>:1798: warning: trailing space in the line
troff:<stdin>:1813: warning: trailing space in the line
troff:<stdin>:1818: warning: trailing space in the line
troff:<stdin>:1844: warning: trailing space in the line
troff:<stdin>:1876: warning: trailing space in the line
troff:<stdin>:1889: warning: trailing space in the line
troff:<stdin>:1951: warning: trailing space in the line
troff:<stdin>:1955: warning: trailing space in the line
troff:<stdin>:1964: warning: trailing space in the line
troff:<stdin>:2168: warning: trailing space in the line
troff:<stdin>:2177: warning: trailing space in the line
troff:<stdin>:2203: warning: trailing space in the line
troff:<stdin>:2204: warning: trailing space in the line
troff:<stdin>:2205: warning: trailing space in the line
troff:<stdin>:2208: warning: trailing space in the line
troff:<stdin>:2221: warning: trailing space in the line
troff:<stdin>:2235: warning: trailing space in the line
troff:<stdin>:2240: warning: trailing space in the line
troff:<stdin>:2241: warning: trailing space in the line
troff:<stdin>:2246: warning: trailing space in the line
troff:<stdin>:2252: warning: trailing space in the line
troff:<stdin>:2260: warning: trailing space in the line
troff:<stdin>:2270: warning: trailing space in the line
troff:<stdin>:2271: warning: trailing space in the line
troff:<stdin>:2272: warning: trailing space in the line
troff:<stdin>:2282: warning: trailing space in the line
troff:<stdin>:2293: warning: trailing space in the line
troff:<stdin>:2295: warning: trailing space in the line
troff:<stdin>:2345: warning: trailing space in the line
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: forky/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.17.11+deb14-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages Libtime-moment-perl depends on:
ii libc6 2.42-5
ii perl 5.40.1-7
ii perl-base [perlapi-5.40.1] 5.40.1-7
Libtime-moment-perl recommends no packages.
Libtime-moment-perl suggests no packages.
-- no debconf information
-------------- next part --------------
Input file is Time::Moment.3pm
Output from "mandoc -T lint Time::Moment.3pm": (shortened list)
88 STYLE: input text line longer than 80 bytes:
232 STYLE: whitespace at end of input line
10 WARNING: empty block: RS
Find most trailing spaces with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Output from
test-nroff -mandoc -t -ww -z Time::Moment.3pm: (shortened list)
5 cannot break line in l adjust mode; overset by 3n
274 line(s) with a trailing space
Find most trailing spaces with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Input file is Time::Moment.3pm
Show if Pod::Man generated this.
2:.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
Latest version in Debian testing:
This is perl 5, version 40, subversion 1 (v5.40.1) built for x86_64-linux-gnu-thread-multi
(with 48 registered patches, see perl -V for more detail)
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
Number of lines affected is
274
-.-.
Move a full stop (period) and a comma outside of a quoted text, if it is
at the end of the quote and does not end a quoted sentence.
2191:A span of "24 hours" does not always equate to "1 calendar day," particularly when factors like daylight saving time come into play.
-.-.
Strings longer than 3/4 of a standard line length (80).
Use "\:" to split the string at the end of an output line, for example a
long URL (web address).
This is a groff extension.
977 \& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T12:30:45.123456789Z\*(Aq);
1451 \& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45.123456Z\*(Aq);
1456 \& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45Z\*(Aq);
1466 "IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1503 "IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1511 "IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1541 \& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45.123456Z\*(Aq);
1551 "IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1572 "IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1763 HTML5 <http://www.w3.org/TR/html5/infrastructure.html#global-dates-and-times>
-.-.
Wrong distance (not two spaces) between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
Split (sometimes) lines after a punctuation mark; before a conjunction.
Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.
Use
#!/usr/bin/sh
sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\. */\1.\n/g' $1
to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"
[List of affected lines removed.]
-.-.
Split lines longer than 80 characters (fill completely
an A4 sized page line on a terminal)
into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Add "\:" to split the string for the output, "\<newline>" in the source.
[List of affected lines removed.]
Longest line is number 2115 with 652 characters
The quarter date format represents a date based on the year, the quarter of the year, and day within the quarter. It is structured as \f(CW\*(C`YYYY\-Qq\-dd\*(C'\fR, where \f(CW\*(C`YYYY\*(C'\fR is the year, \f(CW\*(C`Qq\*(C'\fR indicates the quarter (\f(CW\*(C`Q1\*(C'\fR, \f(CW\*(C`Q2\*(C'\fR, \f(CW\*(C`Q3\*(C'\fR, or \f(CW\*(C`Q4\*(C'\fR), and \f(CW\*(C`dd\*(C'\fR is the day of the quarter, ranging from \f(CW01\fR to \f(CW92\fR depending on the quarter. For example, \f(CW\*(C`Q1\*(C'\fR refers to the first quarter, which includes January, February, and March; \f(CW\*(C`Q2\*(C'\fR refers to the second quarter (April, May, and June), and so on.
-.-.
Add a zero (0) in front of a decimal fraction that begins with a period
(.)
7:.if t .sp .5v
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
[List of affected lines removed.]
-.-
Use a character "\(->" instead of plain "->" or "\->", if not typeset with
a constant width font.
68:\& $tm = Time::Moment\->new(
78:\& $tm = Time::Moment\->now;
79:\& $tm = Time::Moment\->now_utc;
80:\& $tm = Time::Moment\->from_epoch($seconds);
81:\& $tm = Time::Moment\->from_object($object);
82:\& $tm = Time::Moment\->from_string($string);
83:\& $tm = Time::Moment\->from_rd($rd);
84:\& $tm = Time::Moment\->from_jd($jd);
85:\& $tm = Time::Moment\->from_mjd($mjd);
87:\& $year = $tm\->year; # [1, 9999]
88:\& $quarter = $tm\->quarter; # [1, 4]
89:\& $month = $tm\->month; # [1, 12]
90:\& $week = $tm\->week; # [1, 53]
92:\& $day = $tm\->day_of_year; # [1, 366]
93:\& $day = $tm\->day_of_quarter; # [1, 92]
94:\& $day = $tm\->day_of_month; # [1, 31]
95:\& $day = $tm\->day_of_week; # [1=Monday, 7=Sunday]
97:\& $hour = $tm\->hour; # [0, 23]
98:\& $minute = $tm\->minute; # [0, 59]
99:\& $minute = $tm\->minute_of_day; # [0, 1439]
100:\& $second = $tm\->second; # [0, 59]
101:\& $second = $tm\->second_of_day; # [0, 86_399]
102:\& $millisecond = $tm\->millisecond; # [0, 999]
103:\& $millisecond = $tm\->millisecond_of_day; # [0, 86_399_999]
104:\& $microsecond = $tm\->microsecond; # [0, 999_999]
105:\& $microsecond = $tm\->microsecond_of_day; # [0, 86_399_999_999]
106:\& $nanosecond = $tm\->nanosecond; # [0, 999_999_999]
107:\& $nanosecond = $tm\->nanosecond_of_day; # [0, 86_399_999_999_999]
109:\& $epoch = $tm\->epoch;
110:\& $offset = $tm\->offset; # [\-1080, 1080] (?18:00)
112:\& $jd = $tm\->jd; # Julian Date
113:\& $mjd = $tm\->mjd; # Modified Julian Date
114:\& $rd = $tm\->rd; # Rata Die
116:\& $tm2 = $tm1\->with($adjuster);
117:\& $tm2 = $tm1\->with_year($year);
118:\& $tm2 = $tm1\->with_quarter($quarter);
119:\& $tm2 = $tm1\->with_month($month);
120:\& $tm2 = $tm1\->with_week($week);
121:\& $tm2 = $tm1\->with_day_of_year($day);
122:\& $tm2 = $tm1\->with_day_of_quarter($day);
123:\& $tm2 = $tm1\->with_day_of_month($day);
124:\& $tm2 = $tm1\->with_day_of_week($day);
125:\& $tm2 = $tm1\->with_hour($hour);
126:\& $tm2 = $tm1\->with_minute($minute);
127:\& $tm2 = $tm1\->with_minute_of_day($minute);
128:\& $tm2 = $tm1\->with_second($second);
129:\& $tm2 = $tm1\->with_second_of_day($second);
130:\& $tm2 = $tm1\->with_millisecond($millisecond);
131:\& $tm2 = $tm1\->with_millisecond_of_day($millisecond);
132:\& $tm2 = $tm1\->with_microsecond($microsecond);
133:\& $tm2 = $tm1\->with_microsecond_of_day($microsecond);
134:\& $tm2 = $tm1\->with_nanosecond($nanosecond);
135:\& $tm2 = $tm1\->with_nanosecond_of_day($nanosecond);
137:\& $tm2 = $tm1\->with_offset_same_instant($offset);
138:\& $tm2 = $tm1\->with_offset_same_local($offset);
140:\& $tm2 = $tm1\->with_precision($precision);
142:\& $tm2 = $tm1\->plus_years($years);
143:\& $tm2 = $tm1\->plus_months($months);
144:\& $tm2 = $tm1\->plus_weeks($weeks);
145:\& $tm2 = $tm1\->plus_days($days);
146:\& $tm2 = $tm1\->plus_hours($hours);
147:\& $tm2 = $tm1\->plus_minutes($minutes);
148:\& $tm2 = $tm1\->plus_seconds($seconds);
149:\& $tm2 = $tm1\->plus_milliseconds($milliseconds);
150:\& $tm2 = $tm1\->plus_microseconds($microseconds);
151:\& $tm2 = $tm1\->plus_nanoseconds($nanoseconds);
153:\& $tm2 = $tm1\->minus_years($years);
154:\& $tm2 = $tm1\->minus_months($months);
155:\& $tm2 = $tm1\->minus_weeks($weeks);
156:\& $tm2 = $tm1\->minus_days($days);
157:\& $tm2 = $tm1\->minus_hours($hours);
158:\& $tm2 = $tm1\->minus_minutes($minutes);
159:\& $tm2 = $tm1\->minus_seconds($seconds);
160:\& $tm2 = $tm1\->minus_milliseconds($milliseconds);
161:\& $tm2 = $tm1\->minus_microseconds($microseconds);
162:\& $tm2 = $tm1\->minus_nanoseconds($nanoseconds);
164:\& $years = $tm1\->delta_years($tm2);
165:\& $months = $tm1\->delta_months($tm2);
166:\& $weeks = $tm1\->delta_weeks($tm2);
167:\& $days = $tm1\->delta_days($tm2);
168:\& $hours = $tm1\->delta_hours($tm2);
169:\& $minutes = $tm1\->delta_minutes($tm2);
170:\& $seconds = $tm1\->delta_seconds($tm2);
171:\& $milliseconds = $tm1\->delta_milliseconds($tm2);
172:\& $microseconds = $tm1\->delta_microseconds($tm2);
173:\& $nanoseconds = $tm1\->delta_nanoseconds($tm2);
175:\& $tm2 = $tm1\->at_utc;
177:\& $tm2 = $tm1\->at_midnight; # T00:00:00.0
178:\& $tm2 = $tm1\->at_noon; # T12:00:00.0
180:\& $tm2 = $tm1\->at_last_day_of_year;
181:\& $tm2 = $tm1\->at_last_day_of_quarter;
182:\& $tm2 = $tm1\->at_last_day_of_month;
184:\& $boolean = $tm1\->is_before($tm2);
185:\& $boolean = $tm1\->is_after($tm2);
186:\& $boolean = $tm1\->is_equal($tm2);
188:\& $integer = $tm1\->compare($tm2);
190:\& $boolean = $tm\->is_leap_year;
192:\& $string = $tm\->to_string;
193:\& $string = $tm\->strftime($format);
195:\& $integer = $tm\->length_of_year; # [365, 366]
196:\& $integer = $tm\->length_of_quarter; # [90, 92]
197:\& $integer = $tm\->length_of_month; # [28, 31]
198:\& $integer = $tm\->length_of_week_year; # [52, 53]
200:\& @values = $tm\->utc_rd_values;
201:\& $seconds = $tm\->utc_rd_as_seconds;
202:\& @values = $tm\->local_rd_values;
203:\& $seconds = $tm\->local_rd_as_seconds;
232:\& $tm = Time::Moment\->new(
275:\& $tm = Time::Moment\->now;
284:\& $tm = Time::Moment\->now_utc;
292:\& $tm = Time::Moment\->from_epoch($seconds);
293:\& $tm = Time::Moment\->from_epoch($seconds, $nanosecond);
294:\& $tm = Time::Moment\->from_epoch($seconds [, nanosecond => 0] [, precision => 6]);
305:\& $tm = Time::Moment\->from_epoch($seconds, nanosecond => 0);
313:\& $tm = Time::Moment\->from_epoch($seconds, precision => 6);
321:\& $tm = Time::Moment\->from_object($object);
332:\& $tm = Time::Moment\->from_object( DateTime\->now );
341:\& $tm = Time::Moment\->from_object( scalar Time::Piece::localtime() );
351:\& $tm = Params::Coerce::coerce(\*(AqTime::Moment\*(Aq, DateTime\->now);
358:\& $dt = Params::Coerce::coerce(\*(AqDateTime\*(Aq, Time::Moment\->now);
359:\& $tp = Params::Coerce::coerce(\*(AqTime::Piece\*(Aq, Time::Moment\->now);
364:\& $tm = Time::Moment\->from_string($string);
365:\& $tm = Time::Moment\->from_string($string [, lenient => false]);
462:\& $tm = Time::Moment\->from_rd($rd);
463:\& $tm = Time::Moment\->from_rd($rd [, offset => 0] [, precision => 3] [, epoch => 0]);
476:\& $tm = Time::Moment\->from_rd($rd, offset => 0);
484:\& $tm = Time::Moment\->from_rd($rd, precision => 3);
492:\& $tm = Time::Moment\->from_rd($rd, epoch => 0);
500:\& $tm = Time::Moment\->from_jd($jd);
501:\& $tm = Time::Moment\->from_jd($jd [, precision => 3] [, epoch => \-1721424.5]);
514:\& $tm = Time::Moment\->from_jd($jd, precision => 3);
522:\& $tm = Time::Moment\->from_jd($jd, epoch => \-1721424.5);
530:\& $tm = Time::Moment\->from_mjd($mjd);
531:\& $tm = Time::Moment\->from_mjd($mjd [, precision => 3] [, epoch => 678576]);
544:\& $tm = Time::Moment\->from_mjd($mjd, precision => 3);
552:\& $tm = Time::Moment\->from_mjd($mjd, epoch => 678576);
562:\& $year = $tm\->year;
569:\& $quarter = $tm\->quarter;
576:\& $month = $tm\->month;
583:\& $week = $tm\->week;
590:\& $day = $tm\->day_of_year;
597:\& $day = $tm\->day_of_quarter;
604:\& $day = $tm\->day_of_month;
611:\& $day = $tm\->day_of_week;
618:\& $hour = $tm\->hour;
625:\& $minute = $tm\->minute;
632:\& $minute = $tm\->minute_of_day;
639:\& $second = $tm\->second;
646:\& $second = $tm\->second_of_day;
653:\& $millisecond = $tm\->millisecond;
660:\& $millisecond = $tm\->millisecond_of_day;
667:\& $microsecond = $tm\->microsecond;
674:\& $microsecond = $tm\->microsecond_of_day;
681:\& $nanosecond = $tm\->nanosecond;
688:\& $nanosecond = $tm\->nanosecond_of_day;
695:\& $epoch = $tm\->epoch;
702:\& $offset = $tm\->offset;
709:\& $precision = $tm\->precision;
718:\& $jd = $tm\->jd;
719:\& $jd = $tm\->jd([precision => 3]);
730:\& $mjd = $tm\->mjd;
731:\& $mjd = $tm\->mjd([precision => 3]);
742:\& $rd = $tm\->rd;
743:\& $rd = $tm\->rd([precision => 3]);
754:\& $tm2 = $tm1\->with($adjuster);
764:\& $tm2 = $tm1\->with_year($year);
773:\& $tm2 = $tm1\->with_quarter($quarter);
783:\& $tm2 = $tm1\->with_month($month);
793:\& $tm2 = $tm1\->with_week($week);
801:\& $tm2 = $tm1\->with_day_of_year($day);
809:\& $tm2 = $tm1\->with_day_of_quarter($day);
818:\& $tm2 = $tm1\->with_day_of_month($day);
827:\& $tm2 = $tm1\->with_day_of_week($day);
835:\& $tm2 = $tm1\->with_hour($hour);
843:\& $tm2 = $tm1\->with_minute($minute);
851:\& $tm2 = $tm1\->with_minute_of_day($minute);
859:\& $tm2 = $tm1\->with_second($second);
867:\& $tm2 = $tm1\->with_second_of_day($second);
875:\& $tm2 = $tm1\->with_millisecond($millisecond);
884:\& $tm2 = $tm1\->with_millisecond_of_day($millisecond);
894:\& $tm2 = $tm1\->with_microsecond($microsecond);
903:\& $tm2 = $tm1\->with_microsecond_of_day($microsecond);
913:\& $tm2 = $tm1\->with_nanosecond($nanosecond);
921:\& $tm2 = $tm1\->with_nanosecond_of_day($nanosecond);
930:\& $tm2 = $tm1\->with_offset_same_instant($offset);
941:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15\-05\*(Aq)
942:\& \->with_offset_same_instant(0);
948:\& $tm2 = $tm1\->with_offset_same_local($offset);
960:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15\-05\*(Aq)
961:\& \->with_offset_same_local(0);
967:\& $tm2 = $tm1\->with_precision($precision);
977:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T12:30:45.123456789Z\*(Aq);
978:\& say $tm\->with_precision(6); # T12:30:45.123456Z
979:\& say $tm\->with_precision(3); # T12:30:45.123Z
980:\& say $tm\->with_precision(0); # T12:30:45Z
981:\& say $tm\->with_precision(\-1); # T12:30:00Z
982:\& say $tm\->with_precision(\-2); # T12:00:00Z
983:\& say $tm\->with_precision(\-3); # T00:00:00Z
988:\& $tm2 = $tm1\->plus_years($years);
998:\& $tm2 = $tm1\->plus_months($months);
1009:\& $tm2 = $tm1\->plus_weeks($weeks);
1016:\& $tm2 = $tm1\->plus_days($days);
1023:\& $tm2 = $tm1\->plus_hours($hours);
1030:\& $tm2 = $tm1\->plus_minutes($minutes);
1037:\& $tm2 = $tm1\->plus_seconds($seconds);
1044:\& $tm2 = $tm1\->plus_milliseconds($milliseconds);
1052:\& $tm2 = $tm1\->plus_microseconds($microseconds);
1060:\& $tm2 = $tm1\->plus_nanoseconds($nanoeconds);
1068:\& $tm2 = $tm1\->minus_years($years);
1078:\& $tm2 = $tm1\->minus_months($months);
1089:\& $tm2 = $tm1\->minus_weeks($weeks);
1096:\& $tm2 = $tm1\->minus_days($days);
1103:\& $tm2 = $tm1\->minus_hours($hours);
1110:\& $tm2 = $tm1\->minus_minutes($minutes);
1117:\& $tm2 = $tm1\->minus_seconds($seconds);
1124:\& $tm2 = $tm1\->minus_milliseconds($milliseconds);
1132:\& $tm2 = $tm1\->minus_microseconds($microseconds);
1140:\& $tm2 = $tm1\->minus_nanoseconds($nanoseconds);
1148:\& $years = $tm\->delta_years($other);
1157:\& $months = $tm\->delta_months($other);
1166:\& $weeks = $tm\->delta_weeks($other);
1175:\& $days = $tm\->delta_days($other);
1184:\& $hours = $tm\->delta_hours($other);
1193:\& $minutes = $tm\->delta_minutes($other);
1202:\& $seconds = $tm\->delta_seconds($other);
1211:\& $milliseconds = $tm\->delta_milliseconds($other);
1220:\& $microseconds = $tm\->delta_microseconds($other);
1229:\& $nanoseconds = $tm\->delta_nanoseconds($other);
1238:\& $tm2 = $tm1\->at_utc;
1245:\& $tm2 = $tm1\->with_offset_same_instant(0);
1250:\& $tm2 = $tm1\->at_midnight;
1257:\& $tm2 = $tm1\->with_hour(0)
1258:\& \->with_minute(0)
1259:\& \->with_second(0)
1260:\& \->with_nanosecond(0);
1265:\& $tm2 = $tm1\->at_noon;
1272:\& $tm2 = $tm1\->with_hour(12)
1273:\& \->with_minute(0)
1274:\& \->with_second(0)
1275:\& \->with_nanosecond(0);
1280:\& $tm2 = $tm1\->at_last_day_of_year;
1288:\& $tm2 = $tm1\->at_last_day_of_quarter;
1296:\& $tm2 = $tm1\->at_last_day_of_month;
1304:\& $boolean = $tm\->is_before($other);
1312:\& $boolean = $tm\->is_after($other);
1320:\& $boolean = $tm\->is_equal($other);
1328:\& $integer = $tm\->compare($other);
1329:\& $integer = $tm\->compare($other [, precision => 9]);
1342:\& $boolean = $tm\->is_leap_year;
1350:\& $string = $tm\->to_string;
1351:\& $string = $tm\->to_string([reduced => false]);
1380:\& $string = $tm\->strftime($format);
1451:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45.123456Z\*(Aq);
1452:\& $tm\->strftime(\*(Aq%f\*(Aq); # \*(Aq.123456\*(Aq
1453:\& $tm\->strftime(\*(Aq%3f\*(Aq); # \*(Aq.123\*(Aq
1454:\& $tm\->strftime(\*(Aq%9f\*(Aq); # \*(Aq.123456000\*(Aq
1456:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45Z\*(Aq);
1457:\& $tm\->strftime(\*(Aq%f\*(Aq); # \*(Aq\*(Aq
1458:\& $tm\->strftime(\*(Aq%3f\*(Aq); # \*(Aq\*(Aq
1541:\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45.123456Z\*(Aq);
1542:\& $tm\->strftime(\*(Aq%N\*(Aq); # \*(Aq123456\*(Aq
1543:\& $tm\->strftime(\*(Aq%3N\*(Aq); # \*(Aq123\*(Aq
1544:\& $tm\->strftime(\*(Aq%9N\*(Aq); # \*(Aq123456000\*(Aq
1651:\& $integer = $tm\->length_of_year;
1658:\& $integer = $tm\->length_of_quarter;
1665:\& $integer = $tm\->length_of_month;
1672:\& $integer = $tm\->length_of_week_year;
1679:\& ($rdn, $sod, $nanosecond) = $tm\->utc_rd_values;
1698:\& $seconds = $tm\->utc_rd_as_seconds;
1706:\& ($rdn, $sod, $nanosecond) = $tm\->local_rd_values;
1725:\& $seconds = $tm\->local_rd_as_seconds;
1771:\& "$tm" eq $tm\->to_string;
1772:\& "$tm" eq $tm\->strftime("%Y\-%m\-%dT%H:%M:%S%f%Z");
1983:\& $string = $tm\->at_utc\->strftime("%a, %d %b %Y %H:%M:%S GMT");
1998:Time::Moment primarily supports four distinct calendars through \f(CW\*(C`\->from_string\*(C'\fR as well as accessor and adjustor (\f(CW\*(C`\->with\*(C'\fR) methods.
2028:\& $tm = Time::Moment\->new( year => 2024, month => 7, day => 1 );
2061:\& $tm = Time::Moment\->new( year => 2024 )
2062:\& \->with_day_of_year(366);
2107:\& $tm = Time::Moment\->new( year => 2023, day => 4 )
2108:\& \->with_week(52)
2109:\& \->with_day_of_week(7);
2142:\& $tm = Time::Moment\->new( year => 2023 )
2143:\& \->with_quarter(2)
2144:\& \->with_day_of_quarter(45);
2213:\& $tm = Time::Moment\->new(
2219:\& $zone = DateTime::TimeZone\->new(name => \*(AqAmerica/New_York\*(Aq);
2220:\& $offset = $zone\->offset_for_datetime($tm) / 60;
2222:\& say $tm\->with_offset_same_instant($offset); # 2012\-12\-24T10\-05
2227:\& $tm = Time::Moment\->new(
2233:\& $zone = DateTime::TimeZone\->new(name => \*(AqAmerica/New_York\*(Aq);
2234:\& $offset = $zone\->offset_for_local_datetime($tm) / 60;
2236:\& say $tm\->with_offset_same_local($offset); # 2012\-12\-24T15\-05
2245:\& $zone = DateTime::TimeZone\->new(name => \*(AqEurope/Brussels\*(Aq);
2249:\& my $offset = $zone\->offset_for_datetime($tm) / 60;
2250:\& return $tm\->with_offset_same_instant($offset);
2255:\& my $offset = $zone\->offset_for_local_datetime($tm) / 60;
2256:\& return $tm\->with_offset_same_local($offset);
2264:\& $tm1 = Time::Moment\->from_string(\*(Aq2014\-03\-29T12+01\*(Aq);
2265:\& $tm2 = $tm1\->plus_hours(24);
2276:\& $tm1 = Time::Moment\->from_string(\*(Aq2014\-03\-29T22+01\*(Aq);
2277:\& $tm2 = $tm1\->plus_hours(4);
2286:\& $tm1 = Time::Moment\->from_string(\*(Aq2014\-10\-25T12+02\*(Aq);
2287:\& $tm2 = $tm1\->plus_hours(24);
2299:\& $tm1 = Time::Moment\->from_string(\*(Aq2014\-10\-25T22+02\*(Aq);
2300:\& $tm2 = $tm1\->plus_hours(4);
-.-.
Only one space character is after a possible end of sentence
(after a punctuation, that can end a sentence).
[List of affected lines removed.]
-.-.
Add lines to use the CR font for groff instead of CW.
.if t \{\
. ie \\n(.g .ft CR
. el .ft CW
.\}
11:.ft CW
-.-.
.\" Define a fallback for the CW font
.
.if \n(.g \{\
. ie t .ftr CW CR
. el .ftr CW R
.\}
[List of affected lines removed.]
-.-.
Use "\-" instead of "-" in web addresses.
1759:RFC 4287 The Atom Syndication Format <http://tools.ietf.org/html/rfc4287#section-3.3>
1761:W3C Date and Time Formats <http://www.w3.org/TR/NOTE-datetime>
1763:HTML5 <http://www.w3.org/TR/html5/infrastructure.html#global-dates-and-times>
1765:XML Schema <http://www.w3.org/TR/xmlschema-2/#dateTime>
1809:See CBOR::XS, RFC 7049 Section 2.4.1 <http://tools.ietf.org/html/rfc7049#section-2.4.1>
1964:RFC 822 <http://tools.ietf.org/html/rfc822#section-5> as updated by
1973:RFC 2616 \- 3.3.1 Full Date <http://tools.ietf.org/html/rfc2616#section-3.3.1>.
1987:RFC 5322 \- 3.3. Date and Time Specification <http://tools.ietf.org/html/rfc5322#section-3.3>.
-.-.
Put a (long) web address on a new output line to reduce the posibility of
splitting the address between two output lines.
Or inhibit hyphenation with "\%" in front of the name.
1466:"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1503:"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1511:"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1551:"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1572:"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
1757:RFC 3339 Date and Time on the Internet: Timestamps <http://tools.ietf.org/html/rfc3339>
1759:RFC 4287 The Atom Syndication Format <http://tools.ietf.org/html/rfc4287#section-3.3>
1761:W3C Date and Time Formats <http://www.w3.org/TR/NOTE-datetime>
1763:HTML5 <http://www.w3.org/TR/html5/infrastructure.html#global-dates-and-times>
1765:XML Schema <http://www.w3.org/TR/xmlschema-2/#dateTime>
1809:See CBOR::XS, RFC 7049 Section 2.4.1 <http://tools.ietf.org/html/rfc7049#section-2.4.1>
1964:RFC 822 <http://tools.ietf.org/html/rfc822#section-5> as updated by
1965:RFC 1123 <http://tools.ietf.org/html/rfc1123>.
1973:RFC 2616 \- 3.3.1 Full Date <http://tools.ietf.org/html/rfc2616#section-3.3.1>.
1987:RFC 5322 \- 3.3. Date and Time Specification <http://tools.ietf.org/html/rfc5322#section-3.3>.
2242:European Summer Time <http://en.wikipedia.org/wiki/Summer_Time_in_Europe>.
2341:at <https://github.com/chansen/p5\-time\-moment/issues>.
2348:<https://github.com/chansen/p5\-time\-moment>
2351:\& git clone https://github.com/chansen/p5\-time\-moment
-.-.
Output from "test-nroff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z ":
troff:<stdin>:86: warning: trailing space in the line
troff:<stdin>:91: warning: trailing space in the line
troff:<stdin>:96: warning: trailing space in the line
troff:<stdin>:108: warning: trailing space in the line
troff:<stdin>:111: warning: trailing space in the line
troff:<stdin>:115: warning: trailing space in the line
troff:<stdin>:136: warning: trailing space in the line
troff:<stdin>:139: warning: trailing space in the line
troff:<stdin>:141: warning: trailing space in the line
troff:<stdin>:152: warning: trailing space in the line
troff:<stdin>:163: warning: trailing space in the line
troff:<stdin>:174: warning: trailing space in the line
troff:<stdin>:176: warning: trailing space in the line
troff:<stdin>:179: warning: trailing space in the line
troff:<stdin>:183: warning: trailing space in the line
troff:<stdin>:187: warning: trailing space in the line
troff:<stdin>:189: warning: trailing space in the line
troff:<stdin>:191: warning: trailing space in the line
troff:<stdin>:194: warning: trailing space in the line
troff:<stdin>:199: warning: trailing space in the line
troff:<stdin>:204: warning: trailing space in the line
troff:<stdin>:206: warning: trailing space in the line
troff:<stdin>:213: warning: trailing space in the line
troff:<stdin>:218: warning: trailing space in the line
troff:<stdin>:219: warning: trailing space in the line
troff:<stdin>:220: warning: trailing space in the line
troff:<stdin>:221: warning: trailing space in the line
troff:<stdin>:224: warning: trailing space in the line
troff:<stdin>:225: warning: trailing space in the line
troff:<stdin>:255: warning: trailing space in the line
troff:<stdin>:278: warning: trailing space in the line
troff:<stdin>:279: warning: trailing space in the line
troff:<stdin>:287: warning: trailing space in the line
troff:<stdin>:297: warning: trailing space in the line
troff:<stdin>:298: warning: trailing space in the line
troff:<stdin>:308: warning: trailing space in the line
troff:<stdin>:324: warning: trailing space in the line
troff:<stdin>:325: warning: trailing space in the line
troff:<stdin>:335: warning: trailing space in the line
troff:<stdin>:336: warning: trailing space in the line
troff:<stdin>:346: warning: trailing space in the line
troff:<stdin>:354: warning: trailing space in the line
troff:<stdin>:368: warning: trailing space in the line
troff:<stdin>:369: warning: trailing space in the line
troff:<stdin>:370: warning: trailing space in the line
troff:<stdin>:371: warning: trailing space in the line
troff:<stdin>:372: warning: trailing space in the line
troff:<stdin>:373: warning: trailing space in the line
troff:<stdin>:374: warning: trailing space in the line
troff:<stdin>:384: warning: trailing space in the line
troff:<stdin>:388: warning: trailing space in the line
troff:<stdin>:393: warning: trailing space in the line
troff:<stdin>:398: warning: trailing space in the line
troff:<stdin>:402: warning: trailing space in the line
troff:<stdin>:409: warning: trailing space in the line
troff:<stdin>:410: warning: trailing space in the line
troff:<stdin>:422: warning: trailing space in the line
troff:<stdin>:428: warning: trailing space in the line
troff:<stdin>:434: warning: trailing space in the line
troff:<stdin>:442: warning: trailing space in the line
troff:<stdin>:446: warning: trailing space in the line
troff:<stdin>:452: warning: trailing space in the line
troff:<stdin>:453: warning: trailing space in the line
troff:<stdin>:454: warning: trailing space in the line
troff:<stdin>:455: warning: trailing space in the line
troff:<stdin>:456: warning: trailing space in the line
troff:<stdin>:457: warning: trailing space in the line
troff:<stdin>:466: warning: trailing space in the line
troff:<stdin>:467: warning: trailing space in the line
troff:<stdin>:468: warning: trailing space in the line
troff:<stdin>:469: warning: trailing space in the line
troff:<stdin>:479: warning: trailing space in the line
troff:<stdin>:495: warning: trailing space in the line
troff:<stdin>:504: warning: trailing space in the line
troff:<stdin>:505: warning: trailing space in the line
troff:<stdin>:506: warning: trailing space in the line
troff:<stdin>:507: warning: trailing space in the line
troff:<stdin>:525: warning: trailing space in the line
troff:<stdin>:534: warning: trailing space in the line
troff:<stdin>:535: warning: trailing space in the line
troff:<stdin>:536: warning: trailing space in the line
troff:<stdin>:537: warning: trailing space in the line
troff:<stdin>:555: warning: trailing space in the line
troff:<stdin>:712: warning: trailing space in the line
troff:<stdin>:713: warning: trailing space in the line
troff:<stdin>:722: warning: trailing space in the line
troff:<stdin>:723: warning: trailing space in the line
troff:<stdin>:724: warning: trailing space in the line
troff:<stdin>:725: warning: trailing space in the line
troff:<stdin>:734: warning: trailing space in the line
troff:<stdin>:735: warning: trailing space in the line
troff:<stdin>:736: warning: trailing space in the line
troff:<stdin>:737: warning: trailing space in the line
troff:<stdin>:746: warning: trailing space in the line
troff:<stdin>:747: warning: trailing space in the line
troff:<stdin>:748: warning: trailing space in the line
troff:<stdin>:749: warning: trailing space in the line
troff:<stdin>:757: warning: trailing space in the line
troff:<stdin>:759: warning: trailing space in the line
troff:<stdin>:768: warning: trailing space in the line
troff:<stdin>:776: warning: trailing space in the line
troff:<stdin>:777: warning: trailing space in the line
troff:<stdin>:778: warning: trailing space in the line
troff:<stdin>:786: warning: trailing space in the line
troff:<stdin>:787: warning: trailing space in the line
troff:<stdin>:788: warning: trailing space in the line
troff:<stdin>:796: warning: trailing space in the line
troff:<stdin>:804: warning: trailing space in the line
troff:<stdin>:812: warning: trailing space in the line
troff:<stdin>:813: warning: trailing space in the line
troff:<stdin>:821: warning: trailing space in the line
troff:<stdin>:822: warning: trailing space in the line
troff:<stdin>:830: warning: trailing space in the line
troff:<stdin>:838: warning: trailing space in the line
troff:<stdin>:846: warning: trailing space in the line
troff:<stdin>:854: warning: trailing space in the line
troff:<stdin>:862: warning: trailing space in the line
troff:<stdin>:870: warning: trailing space in the line
troff:<stdin>:878: warning: trailing space in the line
troff:<stdin>:887: warning: trailing space in the line
troff:<stdin>:888: warning: trailing space in the line
troff:<stdin>:889: warning: trailing space in the line
troff:<stdin>:897: warning: trailing space in the line
troff:<stdin>:906: warning: trailing space in the line
troff:<stdin>:907: warning: trailing space in the line
troff:<stdin>:908: warning: trailing space in the line
troff:<stdin>:916: warning: trailing space in the line
troff:<stdin>:924: warning: trailing space in the line
troff:<stdin>:925: warning: trailing space in the line
troff:<stdin>:933: warning: trailing space in the line
troff:<stdin>:934: warning: trailing space in the line
troff:<stdin>:937: warning: trailing space in the line
troff:<stdin>:951: warning: trailing space in the line
troff:<stdin>:952: warning: trailing space in the line
troff:<stdin>:955: warning: trailing space in the line
troff:<stdin>:956: warning: trailing space in the line
troff:<stdin>:970: warning: trailing space in the line
troff:<stdin>:971: warning: trailing space in the line
troff:<stdin>:972: warning: trailing space in the line
troff:<stdin>:973: warning: trailing space in the line
troff:<stdin>:991: warning: trailing space in the line
troff:<stdin>:992: warning: trailing space in the line
troff:<stdin>:993: warning: trailing space in the line
troff:<stdin>:1001: warning: trailing space in the line
troff:<stdin>:1002: warning: trailing space in the line
troff:<stdin>:1003: warning: trailing space in the line
troff:<stdin>:1004: warning: trailing space in the line
troff:<stdin>:1047: warning: trailing space in the line
troff:<stdin>:1055: warning: trailing space in the line
troff:<stdin>:1063: warning: trailing space in the line
troff:<stdin>:1071: warning: trailing space in the line
troff:<stdin>:1072: warning: trailing space in the line
troff:<stdin>:1073: warning: trailing space in the line
troff:<stdin>:1081: warning: trailing space in the line
troff:<stdin>:1082: warning: trailing space in the line
troff:<stdin>:1083: warning: trailing space in the line
troff:<stdin>:1084: warning: trailing space in the line
troff:<stdin>:1127: warning: trailing space in the line
troff:<stdin>:1135: warning: trailing space in the line
troff:<stdin>:1143: warning: trailing space in the line
troff:<stdin>:1151: warning: trailing space in the line
troff:<stdin>:1152: warning: trailing space in the line
troff:<stdin>:1160: warning: trailing space in the line
troff:<stdin>:1161: warning: trailing space in the line
troff:<stdin>:1169: warning: trailing space in the line
troff:<stdin>:1170: warning: trailing space in the line
troff:<stdin>:1178: warning: trailing space in the line
troff:<stdin>:1179: warning: trailing space in the line
troff:<stdin>:1187: warning: trailing space in the line
troff:<stdin>:1188: warning: trailing space in the line
troff:<stdin>:1196: warning: trailing space in the line
troff:<stdin>:1197: warning: trailing space in the line
troff:<stdin>:1205: warning: trailing space in the line
troff:<stdin>:1206: warning: trailing space in the line
troff:<stdin>:1214: warning: trailing space in the line
troff:<stdin>:1215: warning: trailing space in the line
troff:<stdin>:1223: warning: trailing space in the line
troff:<stdin>:1224: warning: trailing space in the line
troff:<stdin>:1232: warning: trailing space in the line
troff:<stdin>:1233: warning: trailing space in the line
troff:<stdin>:1241: warning: trailing space in the line
troff:<stdin>:1253: warning: trailing space in the line
troff:<stdin>:1268: warning: trailing space in the line
troff:<stdin>:1283: warning: trailing space in the line
troff:<stdin>:1291: warning: trailing space in the line
troff:<stdin>:1299: warning: trailing space in the line
troff:<stdin>:1307: warning: trailing space in the line
troff:<stdin>:1315: warning: trailing space in the line
troff:<stdin>:1323: warning: trailing space in the line
troff:<stdin>:1332: warning: trailing space in the line
troff:<stdin>:1333: warning: trailing space in the line
troff:<stdin>:1334: warning: trailing space in the line
troff:<stdin>:1336: warning: trailing space in the line
troff:<stdin>:1337: warning: trailing space in the line
troff:<stdin>:1345: warning: trailing space in the line
troff:<stdin>:1354: warning: trailing space in the line
troff:<stdin>:1375: warning: trailing space in the line
troff:<stdin>:1384: warning: trailing space in the line
troff:<stdin>:1385: warning: trailing space in the line
troff:<stdin>:1386: warning: trailing space in the line
troff:<stdin>:1393: warning: trailing space in the line
troff:<stdin>:1413: warning: trailing space in the line
troff:<stdin>:1418: warning: trailing space in the line
troff:<stdin>:1431: warning: trailing space in the line
troff:<stdin>:1436: warning: trailing space in the line
troff:<stdin>:1437: warning: trailing space in the line
troff:<stdin>:1438: warning: trailing space in the line
troff:<stdin>:1439: warning: trailing space in the line
troff:<stdin>:1455: warning: trailing space in the line
troff:<stdin>:1461: warning: trailing space in the line
troff:<stdin>:1462: warning: trailing space in the line
troff:<stdin>:1465: warning: trailing space in the line
troff:<stdin>:1466: warning [page 1, line 1131]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1474: warning: trailing space in the line
troff:<stdin>:1499: warning: trailing space in the line
troff:<stdin>:1502: warning: trailing space in the line
troff:<stdin>:1503: warning [page 1, line 1154]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1507: warning: trailing space in the line
troff:<stdin>:1510: warning: trailing space in the line
troff:<stdin>:1511: warning [page 1, line 1160]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1527: warning: trailing space in the line
troff:<stdin>:1528: warning: trailing space in the line
troff:<stdin>:1529: warning: trailing space in the line
troff:<stdin>:1547: warning: trailing space in the line
troff:<stdin>:1550: warning: trailing space in the line
troff:<stdin>:1551: warning [page 1, line 1188]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1559: warning: trailing space in the line
troff:<stdin>:1568: warning: trailing space in the line
troff:<stdin>:1571: warning: trailing space in the line
troff:<stdin>:1572: warning [page 1, line 1201]: cannot break line in l adjust mode; overset by 3n
troff:<stdin>:1588: warning: trailing space in the line
troff:<stdin>:1593: warning: trailing space in the line
troff:<stdin>:1594: warning: trailing space in the line
troff:<stdin>:1599: warning: trailing space in the line
troff:<stdin>:1600: warning: trailing space in the line
troff:<stdin>:1601: warning: trailing space in the line
troff:<stdin>:1602: warning: trailing space in the line
troff:<stdin>:1607: warning: trailing space in the line
troff:<stdin>:1612: warning: trailing space in the line
troff:<stdin>:1613: warning: trailing space in the line
troff:<stdin>:1642: warning: trailing space in the line
troff:<stdin>:1701: warning: trailing space in the line
troff:<stdin>:1728: warning: trailing space in the line
troff:<stdin>:1754: warning: trailing space in the line
troff:<stdin>:1767: warning: trailing space in the line
troff:<stdin>:1775: warning: trailing space in the line
troff:<stdin>:1781: warning: trailing space in the line
troff:<stdin>:1793: warning: trailing space in the line
troff:<stdin>:1794: warning: trailing space in the line
troff:<stdin>:1795: warning: trailing space in the line
troff:<stdin>:1798: warning: trailing space in the line
troff:<stdin>:1813: warning: trailing space in the line
troff:<stdin>:1818: warning: trailing space in the line
troff:<stdin>:1844: warning: trailing space in the line
troff:<stdin>:1876: warning: trailing space in the line
troff:<stdin>:1889: warning: trailing space in the line
troff:<stdin>:1951: warning: trailing space in the line
troff:<stdin>:1955: warning: trailing space in the line
troff:<stdin>:1964: warning: trailing space in the line
troff:<stdin>:2168: warning: trailing space in the line
troff:<stdin>:2177: warning: trailing space in the line
troff:<stdin>:2203: warning: trailing space in the line
troff:<stdin>:2204: warning: trailing space in the line
troff:<stdin>:2205: warning: trailing space in the line
troff:<stdin>:2208: warning: trailing space in the line
troff:<stdin>:2221: warning: trailing space in the line
troff:<stdin>:2235: warning: trailing space in the line
troff:<stdin>:2240: warning: trailing space in the line
troff:<stdin>:2241: warning: trailing space in the line
troff:<stdin>:2246: warning: trailing space in the line
troff:<stdin>:2252: warning: trailing space in the line
troff:<stdin>:2260: warning: trailing space in the line
troff:<stdin>:2270: warning: trailing space in the line
troff:<stdin>:2271: warning: trailing space in the line
troff:<stdin>:2272: warning: trailing space in the line
troff:<stdin>:2282: warning: trailing space in the line
troff:<stdin>:2293: warning: trailing space in the line
troff:<stdin>:2295: warning: trailing space in the line
troff:<stdin>:2345: warning: trailing space in the line
-.-
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
-------------- next part --------------
--- Time::Moment.3pm 2025-12-15 23:28:22.045041999 +0000
+++ Time::Moment.3pm.new 2025-12-15 23:34:16.272434906 +0000
@@ -4,14 +4,23 @@
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
+.if t .sp 0.5v
.if n .sp
..
.de Vb \" Begin verbatim text
-.ft CW
+.if t \{\
+. ie \\n(.g .ft CR
+. el .ft CW
+.\}
.nf
.ne \\$1
..
+.\" Define a fallback for the CW font
+.
+.if \n(.g \{\
+. ie t .ftr CW CR
+. el .ftr CW R
+.\}
.de Ve \" End verbatim text
.ft R
.fi
@@ -83,17 +92,17 @@ Time::Moment \- Represents a date and ti
\& $tm = Time::Moment\->from_rd($rd);
\& $tm = Time::Moment\->from_jd($jd);
\& $tm = Time::Moment\->from_mjd($mjd);
-\&
+\&
\& $year = $tm\->year; # [1, 9999]
\& $quarter = $tm\->quarter; # [1, 4]
\& $month = $tm\->month; # [1, 12]
\& $week = $tm\->week; # [1, 53]
-\&
+\&
\& $day = $tm\->day_of_year; # [1, 366]
\& $day = $tm\->day_of_quarter; # [1, 92]
\& $day = $tm\->day_of_month; # [1, 31]
\& $day = $tm\->day_of_week; # [1=Monday, 7=Sunday]
-\&
+\&
\& $hour = $tm\->hour; # [0, 23]
\& $minute = $tm\->minute; # [0, 59]
\& $minute = $tm\->minute_of_day; # [0, 1439]
@@ -105,14 +114,14 @@ Time::Moment \- Represents a date and ti
\& $microsecond = $tm\->microsecond_of_day; # [0, 86_399_999_999]
\& $nanosecond = $tm\->nanosecond; # [0, 999_999_999]
\& $nanosecond = $tm\->nanosecond_of_day; # [0, 86_399_999_999_999]
-\&
+\&
\& $epoch = $tm\->epoch;
\& $offset = $tm\->offset; # [\-1080, 1080] (?18:00)
-\&
+\&
\& $jd = $tm\->jd; # Julian Date
\& $mjd = $tm\->mjd; # Modified Julian Date
\& $rd = $tm\->rd; # Rata Die
-\&
+\&
\& $tm2 = $tm1\->with($adjuster);
\& $tm2 = $tm1\->with_year($year);
\& $tm2 = $tm1\->with_quarter($quarter);
@@ -133,12 +142,12 @@ Time::Moment \- Represents a date and ti
\& $tm2 = $tm1\->with_microsecond_of_day($microsecond);
\& $tm2 = $tm1\->with_nanosecond($nanosecond);
\& $tm2 = $tm1\->with_nanosecond_of_day($nanosecond);
-\&
+\&
\& $tm2 = $tm1\->with_offset_same_instant($offset);
\& $tm2 = $tm1\->with_offset_same_local($offset);
-\&
+\&
\& $tm2 = $tm1\->with_precision($precision);
-\&
+\&
\& $tm2 = $tm1\->plus_years($years);
\& $tm2 = $tm1\->plus_months($months);
\& $tm2 = $tm1\->plus_weeks($weeks);
@@ -149,7 +158,7 @@ Time::Moment \- Represents a date and ti
\& $tm2 = $tm1\->plus_milliseconds($milliseconds);
\& $tm2 = $tm1\->plus_microseconds($microseconds);
\& $tm2 = $tm1\->plus_nanoseconds($nanoseconds);
-\&
+\&
\& $tm2 = $tm1\->minus_years($years);
\& $tm2 = $tm1\->minus_months($months);
\& $tm2 = $tm1\->minus_weeks($weeks);
@@ -160,7 +169,7 @@ Time::Moment \- Represents a date and ti
\& $tm2 = $tm1\->minus_milliseconds($milliseconds);
\& $tm2 = $tm1\->minus_microseconds($microseconds);
\& $tm2 = $tm1\->minus_nanoseconds($nanoseconds);
-\&
+\&
\& $years = $tm1\->delta_years($tm2);
\& $months = $tm1\->delta_months($tm2);
\& $weeks = $tm1\->delta_weeks($tm2);
@@ -171,58 +180,58 @@ Time::Moment \- Represents a date and ti
\& $milliseconds = $tm1\->delta_milliseconds($tm2);
\& $microseconds = $tm1\->delta_microseconds($tm2);
\& $nanoseconds = $tm1\->delta_nanoseconds($tm2);
-\&
+\&
\& $tm2 = $tm1\->at_utc;
-\&
+\&
\& $tm2 = $tm1\->at_midnight; # T00:00:00.0
\& $tm2 = $tm1\->at_noon; # T12:00:00.0
-\&
+\&
\& $tm2 = $tm1\->at_last_day_of_year;
\& $tm2 = $tm1\->at_last_day_of_quarter;
\& $tm2 = $tm1\->at_last_day_of_month;
-\&
+\&
\& $boolean = $tm1\->is_before($tm2);
\& $boolean = $tm1\->is_after($tm2);
\& $boolean = $tm1\->is_equal($tm2);
-\&
+\&
\& $integer = $tm1\->compare($tm2);
-\&
+\&
\& $boolean = $tm\->is_leap_year;
-\&
+\&
\& $string = $tm\->to_string;
\& $string = $tm\->strftime($format);
-\&
+\&
\& $integer = $tm\->length_of_year; # [365, 366]
\& $integer = $tm\->length_of_quarter; # [90, 92]
\& $integer = $tm\->length_of_month; # [28, 31]
\& $integer = $tm\->length_of_week_year; # [52, 53]
-\&
+\&
\& @values = $tm\->utc_rd_values;
\& $seconds = $tm\->utc_rd_as_seconds;
\& @values = $tm\->local_rd_values;
\& $seconds = $tm\->local_rd_as_seconds;
-\&
+\&
\& $integer = $tm1 <=> $tm2;
-\&
+\&
\& $boolean = $tm1 == $tm2;
\& $boolean = $tm1 != $tm2;
\& $boolean = $tm1 < $tm2;
\& $boolean = $tm1 > $tm2;
\& $boolean = $tm1 <= $tm2;
\& $boolean = $tm1 >= $tm2;
-\&
+\&
\& $string = "$tm";
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
-\&\f(CW\*(C`Time::Moment\*(C'\fR is an immutable object that represents a specific date and
-time of day, along with an offset from UTC, within the ISO 8601 calendar
-system. Time is measured in nanoseconds since \f(CW\*(C`0001\-01\-01T00Z\*(C'\fR. Leap seconds
-are not accounted for in \f(CW\*(C`Time::Moment\*(C'\fR; each day is assumed to have exactly
+\&\f(CW\*(C`Time::Moment\*(C'\fR is an immutable object that represents a specific date and
+time of day, along with an offset from UTC, within the ISO 8601 calendar
+system. Time is measured in nanoseconds since \f(CW\*(C`0001\-01\-01T00Z\*(C'\fR. Leap seconds
+are not accounted for in \f(CW\*(C`Time::Moment\*(C'\fR; each day is assumed to have exactly
\&\f(CW\*(C`86,400,000,000,000\*(C'\fR nanoseconds.
.PP
-Time::Moment supports all epoch integers from \f(CW\*(C`\-62,135,596,800\*(C'\fR to
-\&\f(CW\*(C`253,402,300,799\*(C'\fR, allowing for nanosecond precision for any instant within
+Time::Moment supports all epoch integers from \f(CW\*(C`\-62,135,596,800\*(C'\fR to
+\&\f(CW\*(C`253,402,300,799\*(C'\fR, allowing for nanosecond precision for any instant within
the range \f(CW\*(C`0001\-01\-01T00:00:00Z\*(C'\fR to \f(CW\*(C`9999\-12\-31T23:59:59Z\*(C'\fR.
.SH CONSTRUCTORS
.IX Header "CONSTRUCTORS"
@@ -252,7 +261,7 @@ The year [1, 9999].
The month of the year [1, 12].
.IP day 4
.IX Item "day"
-The day of the month [1, 31]. The day must be valid for the year and month,
+The day of the month [1, 31]. The day must be valid for the year and month,
otherwise an exception is raised.
.IP hour 4
.IX Item "hour"
@@ -275,8 +284,8 @@ The offset from UTC in minutes [\-1080,
\& $tm = Time::Moment\->now;
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR that is set to the current date
-and time from the system clock in the system time zone, with the offset
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR that is set to the current date
+and time from the system clock in the system time zone, with the offset
set to the system's time zone offset from UTC.
.SS now_utc
.IX Subsection "now_utc"
@@ -284,7 +293,7 @@ set to the system's time zone offset fro
\& $tm = Time::Moment\->now_utc;
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR that is set to the current date
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR that is set to the current date
and time from the system clock in the UTC time zone.
.SS from_epoch
.IX Subsection "from_epoch"
@@ -294,8 +303,8 @@ and time from the system clock in the UT
\& $tm = Time::Moment\->from_epoch($seconds [, nanosecond => 0] [, precision => 6]);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIseconds\fR from the
-epoch of 1970\-01\-01T00Z. Fractional seconds is supported if the constructor
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIseconds\fR from the
+epoch of 1970\-01\-01T00Z. Fractional seconds is supported if the constructor
is invoked with \fIseconds\fR only, the default precision is 6 (microseconds).
.PP
\&\fBParameters:\fR
@@ -305,7 +314,7 @@ is invoked with \fIseconds\fR only, the
\& $tm = Time::Moment\->from_epoch($seconds, nanosecond => 0);
.Ve
.Sp
-The optional parameter \fInanosecond\fR [0, 999_999_999] specifies the
+The optional parameter \fInanosecond\fR [0, 999_999_999] specifies the
nanosecond of the second.
.IP precision 4
.IX Item "precision"
@@ -321,8 +330,8 @@ fractional seconds. The default precisio
\& $tm = Time::Moment\->from_object($object);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIobject\fR. If the
-given object is an instance of \f(CW\*(C`Time::Moment\*(C'\fR it's returned otherwise an
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIobject\fR. If the
+given object is an instance of \f(CW\*(C`Time::Moment\*(C'\fR it's returned otherwise an
attempt is made to coerce the given object to an instance of \f(CW\*(C`Time::Moment\*(C'\fR.
.PP
\&\f(CW\*(C`Time::Moment\*(C'\fR implements coercion handlers for the following object types:
@@ -332,8 +341,8 @@ attempt is made to coerce the given obje
\& $tm = Time::Moment\->from_object( DateTime\->now );
.Ve
.Sp
-The given \f(CW\*(C`DateTime\*(C'\fR object must be within the supported range and must have
-a time zone or an offset from UTC, coercing from the 'floating' time zone is
+The given \f(CW\*(C`DateTime\*(C'\fR object must be within the supported range and must have
+a time zone or an offset from UTC, coercing from the 'floating' time zone is
not supported.
.IP Time::Piece 4
.IX Item "Time::Piece"
@@ -343,7 +352,7 @@ not supported.
.Sp
The given \f(CW\*(C`Time::Piece\*(C'\fR object must be within the supported date range.
.PP
-The coercion scheme is extensible and implemented as documented in
+The coercion scheme is extensible and implemented as documented in
Params::Coerce:
.PP
.Vb 2
@@ -351,7 +360,7 @@ Params::Coerce:
\& $tm = Params::Coerce::coerce(\*(AqTime::Moment\*(Aq, DateTime\->now);
.Ve
.PP
-\&\f(CW\*(C`Time::Moment\*(C'\fR also implements a coercion handler from \f(CW\*(C`Time::Moment\*(C'\fR to
+\&\f(CW\*(C`Time::Moment\*(C'\fR also implements a coercion handler from \f(CW\*(C`Time::Moment\*(C'\fR to
\&\f(CW\*(C`DateTime\*(C'\fR and \f(CW\*(C`Time::Piece\*(C'\fR:
.PP
.Vb 2
@@ -365,13 +374,13 @@ Params::Coerce:
\& $tm = Time::Moment\->from_string($string [, lenient => false]);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIstring\fR. The
-string must consist of a complete date representation and time of day
-followed by a zone designator. The time of day may be reduced to hour
-of the day, the second of the minute may have a decimal fraction. The decimal
-sign can be either the comma [,] or the full stop [.]. A decimal fraction
-must have at least one digit and may have a total of nine digits, if the
-fractional precision is greater than nine digits, the value will be
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given \fIstring\fR. The
+string must consist of a complete date representation and time of day
+followed by a zone designator. The time of day may be reduced to hour
+of the day, the second of the minute may have a decimal fraction. The decimal
+sign can be either the comma [,] or the full stop [.]. A decimal fraction
+must have at least one digit and may have a total of nine digits, if the
+fractional precision is greater than nine digits, the value will be
truncated.
.PP
The following are examples of complete date and time of day representations:
@@ -381,33 +390,33 @@ The following are examples of complete d
\& YYYYMMDDThhmmssZ 20121224T121530Z
\& YYYYMMDDThhmmss?hhmm 20121224T121530+0100
\& YYYYMMDDThhmmss?hh 20121224T121530+01
-\&
+\&
\& YYYYMMDDThhmmss.ssZ 20121224T121530.500Z
\& YYYYMMDDThhmmss.ss?hhmm 20121224T121530.500+0100
\& YYYYMMDDThhmmss.ss?hh 20121224T121530.500+01
-\&
+\&
\& YYYYMMDDThhZ 20121224T12Z (reduced accuracy)
\& YYYYMMDDThhmmZ 20121224T1215Z (reduced accuracy)
\& YYYYMMDDThhmm?hhmm 20121224T1215+0100 (reduced accuracy)
\& YYYYMMDDThhmm?hh 20121224T1215+01 (reduced accuracy)
-\&
+\&
\& Extended format: Example:
\& YYYY\-MM\-DDThh:mm:ssZ 2012\-12\-24T12:15:30Z
\& YYYY\-MM\-DDThh:mm:ss?hh:mm 2012\-12\-24T12:15:30+01:00
\& YYYY\-MM\-DDThh:mm:ss?hh 2012\-12\-24T12:15:30+01
-\&
+\&
\& YYYY\-MM\-DDThh:mm:ss.ssZ 2012\-12\-24T12:15:30.500Z
\& YYYY\-MM\-DDThh:mm:ss.ss?hh:mm 2012\-12\-24T12:15:30.500+01:00
\& YYYY\-MM\-DDThh:mm:ss.ss?hh 2012\-12\-24T12:15:30.500+01
-\&
+\&
\& YYYY\-MM\-DDThhZ 2012\-12\-24T12Z (reduced accuracy)
\& YYYY\-MM\-DDThh:mmZ 2012\-12\-24T12:15Z (reduced accuracy)
\& YYYY\-MM\-DDThh:mm?hh:mm 2012\-12\-24T12:15+01:00 (reduced accuracy)
\& YYYY\-MM\-DDThh:mm?hh 2012\-12\-24T12:15+01 (reduced accuracy)
.Ve
.PP
-Where representations using calendar dates are shown, ordinal dates or week
-dates may be substituted. This ISO 8601 profile correspond to a subset of
+Where representations using calendar dates are shown, ordinal dates or week
+dates may be substituted. This ISO 8601 profile correspond to a subset of
ISO 8601:2004 4.3 Date and time of day.
.PP
If the optional boolean parameter \fIlenient\fR is true, the following examples
@@ -419,19 +428,19 @@ are also accepted:
\& YYYY\-MM\-DD hh:mm:ss?hhmm 2012\-12\-24 12:15:30+0100
\& YYYY\-MM\-DD hh:mm:ss?hh:mm 2012\-12\-24 12:15:30+01:00
\& YYYY\-MM\-DD hh:mm:ss?hh 2012\-12\-24 12:15:30+01
-\&
+\&
\& YYYY\-MM\-DD hh:mm:ss.ssZ 2012\-12\-24 12:15:30.500Z
\& YYYY\-MM\-DD hh:mm:ss.ssz 2012\-12\-24 12:15:30.500z
\& YYYY\-MM\-DD hh:mm:ss.ss?hhmm 2012\-12\-24 12:15:30.500+0100
\& YYYY\-MM\-DD hh:mm:ss.ss?hh:mm 2012\-12\-24 12:15:30.500+01:00
\& YYYY\-MM\-DD hh:mm:ss.ss?hh 2012\-12\-24 12:15:30.500+01
-\&
+\&
\& YYYY\-MM\-DD hh:mmZ 2012\-12\-24 12:15Z
\& YYYY\-MM\-DD hh:mmz 2012\-12\-24 12:15z
\& YYYY\-MM\-DD hh:mm?hhmm 2012\-12\-24 12:15+0100
\& YYYY\-MM\-DD hh:mm?hh:mm 2012\-12\-24 12:15+01:00
\& YYYY\-MM\-DD hh:mm?hh 2012\-12\-24 12:15+01
-\&
+\&
\& YYYY\-MM\-DD hh:mm:ss ?hh:mm 2012\-12\-24 12:15:30 +01:00
\& YYYY\-MM\-DD hh:mm:ss ?hhmm 2012\-12\-24 12:15:30 +0100
\& YYYY\-MM\-DD hh:mm:ss ?hh 2012\-12\-24 12:15:30 +01
@@ -439,22 +448,22 @@ are also accepted:
\& YYYY\-MM\-DD hh:mm:ss GMT?hh 2012\-12\-24 12:15:30 GMT+01
\& YYYY\-MM\-DD hh:mm:ss UTC 2012\-12\-24 12:15:30 UTC
\& YYYY\-MM\-DD hh:mm:ss UTC?hh 2012\-12\-24 12:15:30 UTC+01
-\&
+\&
\& YYYY\-MM\-DD hh:mm:ss.ss ?hhmm 2012\-12\-24 12:15:30.500 +0100
\& YYYY\-MM\-DD hh:mm:ss.ss ?hh:mm 2012\-12\-24 12:15:30.500 +01:00
\& YYYY\-MM\-DD hh:mm:ss.ss ?hh 2012\-12\-24 12:15:30.500 +01
-\&
+\&
\& YYYY\-MM\-DD hh:mm ?hh:mm 2012\-12\-24 12:15 +01:00
\& YYYY\-MM\-DD hh:mm ?hhmm 2012\-12\-24 12:15 +0100
\& YYYY\-MM\-DD hh:mm ?hh 2012\-12\-24 12:15 +01
.Ve
.PP
-The string representation may consist of a mixture of the basic format and
-the extended format. The time designator [T] may be in lower case [t] or
-replaced with a single space. A single space is also accepted between the
-time of day and the zone designator. The UTC designator [Z] may also be in
-lower case [z]. The literal string GMT or UTC may be used as a UTC designator
-and may have an offset. Usage of these string representations is strongly
+The string representation may consist of a mixture of the basic format and
+the extended format. The time designator [T] may be in lower case [t] or
+replaced with a single space. A single space is also accepted between the
+time of day and the zone designator. The UTC designator [Z] may also be in
+lower case [z]. The literal string GMT or UTC may be used as a UTC designator
+and may have an offset. Usage of these string representations is strongly
discouraged as they do not conform to the ISO 8601 standard.
.SS from_rd
.IX Subsection "from_rd"
@@ -463,10 +472,10 @@ discouraged as they do not conform to th
\& $tm = Time::Moment\->from_rd($rd [, offset => 0] [, precision => 3] [, epoch => 0]);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Rata Die.
-The Rata Die is a count of days elapsed since 0000\-12\-31T00. The
-fractional part corresponds to the fraction of the day after midnight.
-The minimum acceptable Rata Die is \f(CW1\fR which corresponds to
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Rata Die.
+The Rata Die is a count of days elapsed since 0000\-12\-31T00. The
+fractional part corresponds to the fraction of the day after midnight.
+The minimum acceptable Rata Die is \f(CW1\fR which corresponds to
0001\-01\-01T00.
.PP
\&\fBParameters:\fR
@@ -476,7 +485,7 @@ The minimum acceptable Rata Die is \f(CW
\& $tm = Time::Moment\->from_rd($rd, offset => 0);
.Ve
.Sp
-The optional parameter \fIoffset\fR [\-1080, 1080] (?18:00) specifies the
+The optional parameter \fIoffset\fR [\-1080, 1080] (?18:00) specifies the
offset from UTC in minutes. The default offset is 0.
.IP precision 4
.IX Item "precision"
@@ -492,7 +501,7 @@ fractional seconds. The default precisio
\& $tm = Time::Moment\->from_rd($rd, epoch => 0);
.Ve
.Sp
-The optional parameter \fIepoch\fR specifies the epoch date relative to
+The optional parameter \fIepoch\fR specifies the epoch date relative to
0000\-12\-31T00. The epoch date for the Rata Die is \f(CW0\fR.
.SS from_jd
.IX Subsection "from_jd"
@@ -501,10 +510,10 @@ The optional parameter \fIepoch\fR speci
\& $tm = Time::Moment\->from_jd($jd [, precision => 3] [, epoch => \-1721424.5]);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Julian Date.
-The Julian Date is a count of days elapsed since \-4713\-11\-24T12Z. The
-fractional part corresponds to the fraction of the day after noon. The
-minimum acceptable Julian Date is \f(CW1721425.5\fR which corresponds to
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Julian Date.
+The Julian Date is a count of days elapsed since \-4713\-11\-24T12Z. The
+fractional part corresponds to the fraction of the day after noon. The
+minimum acceptable Julian Date is \f(CW1721425.5\fR which corresponds to
0001\-01\-01T00Z.
.PP
\&\fBParameters:\fR
@@ -522,7 +531,7 @@ fractional seconds. The default precisio
\& $tm = Time::Moment\->from_jd($jd, epoch => \-1721424.5);
.Ve
.Sp
-The optional parameter \fIepoch\fR specifies the epoch date relative to
+The optional parameter \fIepoch\fR specifies the epoch date relative to
0000\-12\-31T00Z. The epoch date for the Julian Date is \f(CW\-1721424.5\fR.
.SS from_mjd
.IX Subsection "from_mjd"
@@ -531,10 +540,10 @@ The optional parameter \fIepoch\fR speci
\& $tm = Time::Moment\->from_mjd($mjd [, precision => 3] [, epoch => 678576]);
.Ve
.PP
-Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Modified Julian
-Date. The Modified Julian Date is a count of days elapsed since
-1858\-11\-17T00Z. The fractional part corresponds to the fraction of the day
-after midnight. The minimum acceptable Modified Julian Date is \f(CW\-678575\fR
+Constructs an instance of \f(CW\*(C`Time::Moment\*(C'\fR from the given Modified Julian
+Date. The Modified Julian Date is a count of days elapsed since
+1858\-11\-17T00Z. The fractional part corresponds to the fraction of the day
+after midnight. The minimum acceptable Modified Julian Date is \f(CW\-678575\fR
which corresponds to 0001\-01\-01T00Z.
.PP
\&\fBParameters:\fR
@@ -552,7 +561,7 @@ fractional seconds. The default precisio
\& $tm = Time::Moment\->from_mjd($mjd, epoch => 678576);
.Ve
.Sp
-The optional parameter \fIepoch\fR specifies the epoch date relative to
+The optional parameter \fIepoch\fR specifies the epoch date relative to
0000\-12\-31T00Z. The epoch date for the Modified Julian Date is \f(CW678576\fR.
.SH "INSTANCE METHODS"
.IX Header "INSTANCE METHODS"
@@ -709,8 +718,8 @@ Returns the offset from UTC in minutes [
\& $precision = $tm\->precision;
.Ve
.PP
-Returns the precision of the time of the day [\-3, 9]. Please see
-with_precision for an explanation of the
+Returns the precision of the time of the day [\-3, 9]. Please see
+with_precision for an explanation of the
returned precision value.
.SS jd
.IX Subsection "jd"
@@ -719,10 +728,10 @@ returned precision value.
\& $jd = $tm\->jd([precision => 3]);
.Ve
.PP
-Returns the Julian Date. The Julian Date is a count of days elapsed since
-\&\-4713\-11\-24T12Z. The fractional part corresponds to the fraction of the
-day after noon. The optional named parameter \fIprecision\fR [0, 9] specifies
-the precision of the fractional seconds. The default precision is 3
+Returns the Julian Date. The Julian Date is a count of days elapsed since
+\&\-4713\-11\-24T12Z. The fractional part corresponds to the fraction of the
+day after noon. The optional named parameter \fIprecision\fR [0, 9] specifies
+the precision of the fractional seconds. The default precision is 3
(milliseconds).
.SS mjd
.IX Subsection "mjd"
@@ -731,10 +740,10 @@ the precision of the fractional seconds.
\& $mjd = $tm\->mjd([precision => 3]);
.Ve
.PP
-Returns the Modified Julian Date. The Modified Julian Date is a count of days
-elapsed since 1858\-11\-17T00Z. The fractional part corresponds to the fraction
-of the day after midnight. The optional named parameter \fIprecision\fR [0, 9]
-specifies the precision of the fractional seconds. The default precision is 3
+Returns the Modified Julian Date. The Modified Julian Date is a count of days
+elapsed since 1858\-11\-17T00Z. The fractional part corresponds to the fraction
+of the day after midnight. The optional named parameter \fIprecision\fR [0, 9]
+specifies the precision of the fractional seconds. The default precision is 3
(milliseconds).
.SS rd
.IX Subsection "rd"
@@ -743,10 +752,10 @@ specifies the precision of the fractiona
\& $rd = $tm\->rd([precision => 3]);
.Ve
.PP
-Returns the Rata Die. The Rata Die is a count of days elapsed since
-0000\-12\-31T00. The fractional part corresponds to the fraction of the day
-after midnight. The optional named parameter \fIprecision\fR [0, 9] specifies
-the precision of the fractional seconds. The default precision is 3
+Returns the Rata Die. The Rata Die is a count of days elapsed since
+0000\-12\-31T00. The fractional part corresponds to the fraction of the day
+after midnight. The optional named parameter \fIprecision\fR [0, 9] specifies
+the precision of the fractional seconds. The default precision is 3
(milliseconds).
.SS with
.IX Subsection "with"
@@ -754,9 +763,9 @@ the precision of the fractional seconds.
\& $tm2 = $tm1\->with($adjuster);
.Ve
.PP
-Returns a copy of this instance adjusted by the given \fIadjuster\fR. The
+Returns a copy of this instance adjusted by the given \fIadjuster\fR. The
adjuster is a CODE reference invoked with an instance of Time::Moment and
-is expected to return an instance of Time::Moment. Please see
+is expected to return an instance of Time::Moment. Please see
Time::Moment::Adjusters for available adjusters.
.SS with_year
.IX Subsection "with_year"
@@ -765,7 +774,7 @@ Time::Moment::Adjusters for available ad
.Ve
.PP
Returns a copy of this instance with the given \fIyear\fR [1, 9999] altered. The
-day of the month of the date is unchanged unless the day does not exist in the
+day of the month of the date is unchanged unless the day does not exist in the
month. In that case, the day is set to the last day of the month.
.SS with_quarter
.IX Subsection "with_quarter"
@@ -773,9 +782,9 @@ month. In that case, the day is set to t
\& $tm2 = $tm1\->with_quarter($quarter);
.Ve
.PP
-Returns a copy of this instance with the given \fIquarter\fR of the year [1, 4]
-altered. The day of the month of the date is unchanged unless the day does
-not exist in the month of the quarter. In that case, the day is set to the
+Returns a copy of this instance with the given \fIquarter\fR of the year [1, 4]
+altered. The day of the month of the date is unchanged unless the day does
+not exist in the month of the quarter. In that case, the day is set to the
last day of the month.
.SS with_month
.IX Subsection "with_month"
@@ -783,9 +792,9 @@ last day of the month.
\& $tm2 = $tm1\->with_month($month);
.Ve
.PP
-Returns a copy of this instance with the given \fImonth\fR of the year [1, 12]
-altered. The day of the month of the date is unchanged unless the day does not
-exist in the given month. In that case, the day is set to the last day of the
+Returns a copy of this instance with the given \fImonth\fR of the year [1, 12]
+altered. The day of the month of the date is unchanged unless the day does not
+exist in the given month. In that case, the day is set to the last day of the
given month.
.SS with_week
.IX Subsection "with_week"
@@ -793,7 +802,7 @@ given month.
\& $tm2 = $tm1\->with_week($week);
.Ve
.PP
-Returns a copy of this instance with the given \fIweek\fR of the year [1, 53]
+Returns a copy of this instance with the given \fIweek\fR of the year [1, 53]
altered. The week must be valid for the year, otherwise an exception is raised.
.SS with_day_of_year
.IX Subsection "with_day_of_year"
@@ -801,7 +810,7 @@ altered. The week must be valid for the
\& $tm2 = $tm1\->with_day_of_year($day);
.Ve
.PP
-Returns a copy of this instance with the given \fIday\fR of the year [1, 366]
+Returns a copy of this instance with the given \fIday\fR of the year [1, 366]
altered. The day must be valid for the year, otherwise an exception is raised.
.SS with_day_of_quarter
.IX Subsection "with_day_of_quarter"
@@ -809,8 +818,8 @@ altered. The day must be valid for the y
\& $tm2 = $tm1\->with_day_of_quarter($day);
.Ve
.PP
-Returns a copy of this instance with the given \fIday\fR of the quarter [1, 92]
-altered. The day must be valid for the year and quarter, otherwise an
+Returns a copy of this instance with the given \fIday\fR of the quarter [1, 92]
+altered. The day must be valid for the year and quarter, otherwise an
exception is raised.
.SS with_day_of_month
.IX Subsection "with_day_of_month"
@@ -818,8 +827,8 @@ exception is raised.
\& $tm2 = $tm1\->with_day_of_month($day);
.Ve
.PP
-Returns a copy of this instance with the given \fIday\fR of the month [1, 31]
-altered. The day must be valid for the year and month, otherwise an exception
+Returns a copy of this instance with the given \fIday\fR of the month [1, 31]
+altered. The day must be valid for the year and month, otherwise an exception
is raised.
.SS with_day_of_week
.IX Subsection "with_day_of_week"
@@ -827,7 +836,7 @@ is raised.
\& $tm2 = $tm1\->with_day_of_week($day);
.Ve
.PP
-Returns a copy of this instance with the given \fIday\fR of the week
+Returns a copy of this instance with the given \fIday\fR of the week
[1=Monday, 7=Sunday] altered.
.SS with_hour
.IX Subsection "with_hour"
@@ -835,7 +844,7 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->with_hour($hour);
.Ve
.PP
-Returns a copy of this instance with the given \fIhour\fR of the day [0, 23]
+Returns a copy of this instance with the given \fIhour\fR of the day [0, 23]
altered.
.SS with_minute
.IX Subsection "with_minute"
@@ -843,7 +852,7 @@ altered.
\& $tm2 = $tm1\->with_minute($minute);
.Ve
.PP
-Returns a copy of this instance with the given \fIminute\fR of the hour [0, 59]
+Returns a copy of this instance with the given \fIminute\fR of the hour [0, 59]
altered.
.SS with_minute_of_day
.IX Subsection "with_minute_of_day"
@@ -851,7 +860,7 @@ altered.
\& $tm2 = $tm1\->with_minute_of_day($minute);
.Ve
.PP
-Returns a copy of this instance with the given \fIminute\fR of the day [0, 1439]
+Returns a copy of this instance with the given \fIminute\fR of the day [0, 1439]
altered, any lower-order time elements is unaltered.
.SS with_second
.IX Subsection "with_second"
@@ -859,7 +868,7 @@ altered, any lower-order time elements i
\& $tm2 = $tm1\->with_second($second);
.Ve
.PP
-Returns a copy of this instance with the given \fIsecond\fR of the minute [0, 59]
+Returns a copy of this instance with the given \fIsecond\fR of the minute [0, 59]
altered.
.SS with_second_of_day
.IX Subsection "with_second_of_day"
@@ -867,7 +876,7 @@ altered.
\& $tm2 = $tm1\->with_second_of_day($second);
.Ve
.PP
-Returns a copy of this instance with the given \fIsecond\fR of the day [0, 86_399]
+Returns a copy of this instance with the given \fIsecond\fR of the day [0, 86_399]
altered, any lower-order time elements is unaltered.
.SS with_millisecond
.IX Subsection "with_millisecond"
@@ -875,7 +884,7 @@ altered, any lower-order time elements i
\& $tm2 = $tm1\->with_millisecond($millisecond);
.Ve
.PP
-Returns a copy of this instance with the given \fImillisecond\fR of the second
+Returns a copy of this instance with the given \fImillisecond\fR of the second
[0, 999] altered. The nanosecond of the second is replaced with the given
\&\fImillisecond\fR multiplied by 1,000,000.
.SS with_millisecond_of_day
@@ -884,9 +893,9 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->with_millisecond_of_day($millisecond);
.Ve
.PP
-Returns a copy of this instance with the given \fImillisecond\fR of the day
-[0, 86_400_000] altered. A millisecond value of 86_400_000 (T24:00) is
-normalized to midnight of the following day, any lower-order time elements
+Returns a copy of this instance with the given \fImillisecond\fR of the day
+[0, 86_400_000] altered. A millisecond value of 86_400_000 (T24:00) is
+normalized to midnight of the following day, any lower-order time elements
is truncated.
.SS with_microsecond
.IX Subsection "with_microsecond"
@@ -894,7 +903,7 @@ is truncated.
\& $tm2 = $tm1\->with_microsecond($microsecond);
.Ve
.PP
-Returns a copy of this instance with the given \fImicrosecond\fR of the second
+Returns a copy of this instance with the given \fImicrosecond\fR of the second
[0, 999_999] altered. The nanosecond of the second is replaced with the given
\&\fImicrosecond\fR multiplied by 1,000.
.SS with_microsecond_of_day
@@ -903,9 +912,9 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->with_microsecond_of_day($microsecond);
.Ve
.PP
-Returns a copy of this instance with the given \fImicrosecond\fR of the day
-[0, 86_400_000_000] altered. A microsecond value of 86_400_000_000 (T24:00)
-is normalized to midnight of the following day, any lower-order time elements
+Returns a copy of this instance with the given \fImicrosecond\fR of the day
+[0, 86_400_000_000] altered. A microsecond value of 86_400_000_000 (T24:00)
+is normalized to midnight of the following day, any lower-order time elements
is truncated.
.SS with_nanosecond
.IX Subsection "with_nanosecond"
@@ -913,7 +922,7 @@ is truncated.
\& $tm2 = $tm1\->with_nanosecond($nanosecond);
.Ve
.PP
-Returns a copy of this instance with the given \fInanosecond\fR of the second
+Returns a copy of this instance with the given \fInanosecond\fR of the second
[0, 999_999_999] altered.
.SS with_nanosecond_of_day
.IX Subsection "with_nanosecond_of_day"
@@ -921,8 +930,8 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->with_nanosecond_of_day($nanosecond);
.Ve
.PP
-Returns a copy of this instance with the given \fInanosecond\fR of the day
-[0, 86_400_000_000_000] altered. A nanosecond value of 86_400_000_000_000
+Returns a copy of this instance with the given \fInanosecond\fR of the day
+[0, 86_400_000_000_000] altered. A nanosecond value of 86_400_000_000_000
(T24:00) is normalized to midnight of the following day.
.SS with_offset_same_instant
.IX Subsection "with_offset_same_instant"
@@ -930,11 +939,11 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->with_offset_same_instant($offset);
.Ve
.PP
-Returns a copy of this instance with the given \fIoffset\fR from UTC in
-minutes [\-1080, 1080] (?18:00) altered. The resulting time is at the same
+Returns a copy of this instance with the given \fIoffset\fR from UTC in
+minutes [\-1080, 1080] (?18:00) altered. The resulting time is at the same
instant.
.PP
-This method ensures the exact UTC instant remains unchanged, but the local
+This method ensures the exact UTC instant remains unchanged, but the local
date and time are recalculated based on the new offset.
.PP
.Vb 3
@@ -948,12 +957,12 @@ date and time are recalculated based on
\& $tm2 = $tm1\->with_offset_same_local($offset);
.Ve
.PP
-Returns a copy of this instance with the given \fIoffset\fR from UTC in
-minutes [\-1080, 1080] (?18:00) altered. The resulting time has the same
+Returns a copy of this instance with the given \fIoffset\fR from UTC in
+minutes [\-1080, 1080] (?18:00) altered. The resulting time has the same
local time.
.PP
-This method ensures the local date and time remain unchanged, but the
-offset changes to reflect the new timezone. As a result, the UTC instant
+This method ensures the local date and time remain unchanged, but the
+offset changes to reflect the new timezone. As a result, the UTC instant
represented by the instance also changes.
.PP
.Vb 3
@@ -967,10 +976,10 @@ represented by the instance also changes
\& $tm2 = $tm1\->with_precision($precision);
.Ve
.PP
-Returns a copy of this instance with the time of the day altered to the
-given \fIprecision\fR [\-3, 9]. A precision value between [0, 9] alters the
-precision of the fractional seconds. A precision of \f(CW\-1\fR truncates to
-minute of the hour; \f(CW\-2\fR truncates to hour of the day; \f(CW\-3\fR truncates
+Returns a copy of this instance with the time of the day altered to the
+given \fIprecision\fR [\-3, 9]. A precision value between [0, 9] alters the
+precision of the fractional seconds. A precision of \f(CW\-1\fR truncates to
+minute of the hour; \f(CW\-2\fR truncates to hour of the day; \f(CW\-3\fR truncates
to midnight of the day.
.PP
.Vb 7
@@ -988,9 +997,9 @@ to midnight of the day.
\& $tm2 = $tm1\->plus_years($years);
.Ve
.PP
-Returns a copy of this instance with the given number of \fIyears\fR added. The
-day of the month of the date is unchanged unless the day does not exist in the
-resulting month. In that case, the day is set to the last day of the resulting
+Returns a copy of this instance with the given number of \fIyears\fR added. The
+day of the month of the date is unchanged unless the day does not exist in the
+resulting month. In that case, the day is set to the last day of the resulting
month. For example, 2012\-02\-29 plus one year results in 2013\-02\-28.
.SS plus_months
.IX Subsection "plus_months"
@@ -998,10 +1007,10 @@ month. For example, 2012\-02\-29 plus on
\& $tm2 = $tm1\->plus_months($months);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImonths\fR added. The
-day of the month of the date is unchanged unless the day does not exist in the
-resulting month. In that case, the day is set to the last day of the resulting
-month. For example, 2013\-01\-31 plus one month results in 2013\-02\-28;
+Returns a copy of this instance with the given number of \fImonths\fR added. The
+day of the month of the date is unchanged unless the day does not exist in the
+resulting month. In that case, the day is set to the last day of the resulting
+month. For example, 2013\-01\-31 plus one month results in 2013\-02\-28;
2013\-02\-28 plus one month results in 2013\-03\-28.
.SS plus_weeks
.IX Subsection "plus_weeks"
@@ -1044,7 +1053,7 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->plus_milliseconds($milliseconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImilliseconds\fR
+Returns a copy of this instance with the given number of \fImilliseconds\fR
added.
.SS plus_microseconds
.IX Subsection "plus_microseconds"
@@ -1052,7 +1061,7 @@ added.
\& $tm2 = $tm1\->plus_microseconds($microseconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImicroseconds\fR
+Returns a copy of this instance with the given number of \fImicroseconds\fR
added.
.SS plus_nanoseconds
.IX Subsection "plus_nanoseconds"
@@ -1060,7 +1069,7 @@ added.
\& $tm2 = $tm1\->plus_nanoseconds($nanoeconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fInanoseconds\fR
+Returns a copy of this instance with the given number of \fInanoseconds\fR
added.
.SS minus_years
.IX Subsection "minus_years"
@@ -1068,9 +1077,9 @@ added.
\& $tm2 = $tm1\->minus_years($years);
.Ve
.PP
-Returns a copy of this instance with the given number of \fIyears\fR subtracted.
-The day of the month of the date is unchanged unless the day does not exist in
-the resulting month. In that case, the day is set to the last day of the
+Returns a copy of this instance with the given number of \fIyears\fR subtracted.
+The day of the month of the date is unchanged unless the day does not exist in
+the resulting month. In that case, the day is set to the last day of the
resulting month. For example, 2012\-02\-29 minus one year results in 2011\-02\-28.
.SS minus_months
.IX Subsection "minus_months"
@@ -1078,10 +1087,10 @@ resulting month. For example, 2012\-02\-
\& $tm2 = $tm1\->minus_months($months);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImonths\fR subtracted.
-The day of the month of the date is unchanged unless the day does not exist in
-the resulting month. In that case, the day is set to the last day of the
-resulting month. For example, 2013\-03\-31 minus one month results in 2013\-02\-28;
+Returns a copy of this instance with the given number of \fImonths\fR subtracted.
+The day of the month of the date is unchanged unless the day does not exist in
+the resulting month. In that case, the day is set to the last day of the
+resulting month. For example, 2013\-03\-31 minus one month results in 2013\-02\-28;
2013\-02\-28 minus one month results in 2013\-01\-28.
.SS minus_weeks
.IX Subsection "minus_weeks"
@@ -1124,7 +1133,7 @@ Returns a copy of this instance with the
\& $tm2 = $tm1\->minus_milliseconds($milliseconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImilliseconds\fR
+Returns a copy of this instance with the given number of \fImilliseconds\fR
subtracted.
.SS minus_microseconds
.IX Subsection "minus_microseconds"
@@ -1132,7 +1141,7 @@ subtracted.
\& $tm2 = $tm1\->minus_microseconds($microseconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fImicroseconds\fR
+Returns a copy of this instance with the given number of \fImicroseconds\fR
subtracted.
.SS minus_nanoseconds
.IX Subsection "minus_nanoseconds"
@@ -1140,7 +1149,7 @@ subtracted.
\& $tm2 = $tm1\->minus_nanoseconds($nanoseconds);
.Ve
.PP
-Returns a copy of this instance with the given number of \fInanoseconds\fR
+Returns a copy of this instance with the given number of \fInanoseconds\fR
subtracted.
.SS delta_years
.IX Subsection "delta_years"
@@ -1148,8 +1157,8 @@ subtracted.
\& $years = $tm\->delta_years($other);
.Ve
.PP
-Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
-in terms of complete \fBcalendar years\fR. The result will be negative if the local date of
+Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
+in terms of complete \fBcalendar years\fR. The result will be negative if the local date of
the \fIother\fR moment is before this.
.SS delta_months
.IX Subsection "delta_months"
@@ -1157,8 +1166,8 @@ the \fIother\fR moment is before this.
\& $months = $tm\->delta_months($other);
.Ve
.PP
-Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
-in terms of complete \fBcalendar months\fR. The result will be negative if the local date of
+Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
+in terms of complete \fBcalendar months\fR. The result will be negative if the local date of
the \fIother\fR moment is before this.
.SS delta_weeks
.IX Subsection "delta_weeks"
@@ -1166,8 +1175,8 @@ the \fIother\fR moment is before this.
\& $weeks = $tm\->delta_weeks($other);
.Ve
.PP
-Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
-in terms of complete \fBcalendar weeks\fR. The result will be negative if the local date of
+Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
+in terms of complete \fBcalendar weeks\fR. The result will be negative if the local date of
the \fIother\fR moment is before this.
.SS delta_days
.IX Subsection "delta_days"
@@ -1175,8 +1184,8 @@ the \fIother\fR moment is before this.
\& $days = $tm\->delta_days($other);
.Ve
.PP
-Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
-in terms of complete \fBcalendar days\fR. The result will be negative if the local date of
+Returns the difference between the \fBlocal date\fR of this moment and the \fIother\fR
+in terms of complete \fBcalendar days\fR. The result will be negative if the local date of
the \fIother\fR moment is before this.
.SS delta_hours
.IX Subsection "delta_hours"
@@ -1184,8 +1193,8 @@ the \fIother\fR moment is before this.
\& $hours = $tm\->delta_hours($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR
-in terms of complete hours. The result will be negative if the instant of
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR
+in terms of complete hours. The result will be negative if the instant of
the \fIother\fR moment is before this.
.SS delta_minutes
.IX Subsection "delta_minutes"
@@ -1193,8 +1202,8 @@ the \fIother\fR moment is before this.
\& $minutes = $tm\->delta_minutes($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR
-in terms of complete minutes. The result will be negative if the instant of
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR
+in terms of complete minutes. The result will be negative if the instant of
the \fIother\fR moment is before this.
.SS delta_seconds
.IX Subsection "delta_seconds"
@@ -1202,8 +1211,8 @@ the \fIother\fR moment is before this.
\& $seconds = $tm\->delta_seconds($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
-terms of complete seconds. The result will be negative if the instant of the
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
+terms of complete seconds. The result will be negative if the instant of the
\&\fIother\fR moment is before this.
.SS delta_milliseconds
.IX Subsection "delta_milliseconds"
@@ -1211,8 +1220,8 @@ terms of complete seconds. The result wi
\& $milliseconds = $tm\->delta_milliseconds($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
-terms of complete milliseconds. The result will be negative if the instant of
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
+terms of complete milliseconds. The result will be negative if the instant of
the \fIother\fR moment is before this.
.SS delta_microseconds
.IX Subsection "delta_microseconds"
@@ -1220,8 +1229,8 @@ the \fIother\fR moment is before this.
\& $microseconds = $tm\->delta_microseconds($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
-terms of complete microseconds. The result will be negative if the instant of
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
+terms of complete microseconds. The result will be negative if the instant of
the \fIother\fR moment is before this.
.SS delta_nanoseconds
.IX Subsection "delta_nanoseconds"
@@ -1229,8 +1238,8 @@ the \fIother\fR moment is before this.
\& $nanoseconds = $tm\->delta_nanoseconds($other);
.Ve
.PP
-Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
-terms of complete nanoseconds. The result will be negative if the instant of
+Returns the difference between the \fBinstant\fR of this moment and the \fIother\fR in
+terms of complete nanoseconds. The result will be negative if the instant of
the \fIother\fR moment is before this.
.SS at_utc
.IX Subsection "at_utc"
@@ -1238,7 +1247,7 @@ the \fIother\fR moment is before this.
\& $tm2 = $tm1\->at_utc;
.Ve
.PP
-Returns a copy of this instance with the offset from UTC set to zero. This
+Returns a copy of this instance with the offset from UTC set to zero. This
method is equivalent to:
.PP
.Vb 1
@@ -1250,7 +1259,7 @@ method is equivalent to:
\& $tm2 = $tm1\->at_midnight;
.Ve
.PP
-Returns a copy of this instance with the time of day set to midnight,
+Returns a copy of this instance with the time of day set to midnight,
T00:00:00.0. This method is equivalent to:
.PP
.Vb 4
@@ -1265,7 +1274,7 @@ T00:00:00.0. This method is equivalent t
\& $tm2 = $tm1\->at_noon;
.Ve
.PP
-Returns a copy of this instance with the time of day set to noon,
+Returns a copy of this instance with the time of day set to noon,
T12:00:00.0. This method is equivalent to:
.PP
.Vb 4
@@ -1280,7 +1289,7 @@ T12:00:00.0. This method is equivalent t
\& $tm2 = $tm1\->at_last_day_of_year;
.Ve
.PP
-Returns a copy of this instance with the date adjusted to the last day of
+Returns a copy of this instance with the date adjusted to the last day of
the year, the time of the day is unaltered.
.SS at_last_day_of_quarter
.IX Subsection "at_last_day_of_quarter"
@@ -1288,7 +1297,7 @@ the year, the time of the day is unalter
\& $tm2 = $tm1\->at_last_day_of_quarter;
.Ve
.PP
-Returns a copy of this instance with the date adjusted to the last day of
+Returns a copy of this instance with the date adjusted to the last day of
the quarter, the time of the day is unaltered.
.SS at_last_day_of_month
.IX Subsection "at_last_day_of_month"
@@ -1296,7 +1305,7 @@ the quarter, the time of the day is unal
\& $tm2 = $tm1\->at_last_day_of_month;
.Ve
.PP
-Returns a copy of this instance with the date adjusted to the last day of
+Returns a copy of this instance with the date adjusted to the last day of
the month, the time of the day is unaltered.
.SS is_before
.IX Subsection "is_before"
@@ -1304,7 +1313,7 @@ the month, the time of the day is unalte
\& $boolean = $tm\->is_before($other);
.Ve
.PP
-Returns a boolean indicating whether or not the instant of this time is before
+Returns a boolean indicating whether or not the instant of this time is before
the \fIother\fR time.
.SS is_after
.IX Subsection "is_after"
@@ -1312,7 +1321,7 @@ the \fIother\fR time.
\& $boolean = $tm\->is_after($other);
.Ve
.PP
-Returns a boolean indicating whether or not the instant of this time is after
+Returns a boolean indicating whether or not the instant of this time is after
the \fIother\fR time.
.SS is_equal
.IX Subsection "is_equal"
@@ -1320,7 +1329,7 @@ the \fIother\fR time.
\& $boolean = $tm\->is_equal($other);
.Ve
.PP
-Returns a boolean indicating whether or not the instant of this time is equal
+Returns a boolean indicating whether or not the instant of this time is equal
the \fIother\fR time.
.SS compare
.IX Subsection "compare"
@@ -1329,12 +1338,12 @@ the \fIother\fR time.
\& $integer = $tm\->compare($other [, precision => 9]);
.Ve
.PP
-Returns an integer indicating whether the instant of this time is before,
-after or equal the \fIother\fR time. Returns a value less than zero if this
-time is before the other; zero if this date is equal the other time; a value
+Returns an integer indicating whether the instant of this time is before,
+after or equal the \fIother\fR time. Returns a value less than zero if this
+time is before the other; zero if this date is equal the other time; a value
greater than zero if this time is after the other time. The optional parameter
-\&\fIprecision\fR [\-3, 9] specifies the precision of the comparison. The default
-precision is 9 (nanoseconds). Please see with_precision
+\&\fIprecision\fR [\-3, 9] specifies the precision of the comparison. The default
+precision is 9 (nanoseconds). Please see with_precision
for an explanation of the precision value.
.SS is_leap_year
.IX Subsection "is_leap_year"
@@ -1342,7 +1351,7 @@ for an explanation of the precision valu
\& $boolean = $tm\->is_leap_year;
.Ve
.PP
-Returns a boolean indicating whether or not the year of the local date of
+Returns a boolean indicating whether or not the year of the local date of
this moment is a leap year.
.SS to_string
.IX Subsection "to_string"
@@ -1351,7 +1360,7 @@ this moment is a leap year.
\& $string = $tm\->to_string([reduced => false]);
.Ve
.PP
-Returns a string representation of the instance. If the optional named
+Returns a string representation of the instance. If the optional named
boolean parameter \fIreduced\fR is true a shorter representation is attempted.
.PP
The string will be in one of the following representations:
@@ -1372,7 +1381,7 @@ Followed by a zone designator in one of
\& ?hh:mm
.Ve
.PP
-The shortest representation will be used where the omitted parts are implied
+The shortest representation will be used where the omitted parts are implied
to be zero.
.SS strftime
.IX Subsection "strftime"
@@ -1381,16 +1390,16 @@ to be zero.
.Ve
.PP
Formats time according to the conversion specifications in the given \f(CW$format\fR
-string. The format string consists of zero or more conversion specifications
-and ordinary characters. All ordinary characters are copied directly into the
-resulting string. A conversion specification consists of a percent sign \f(CW\*(C`%\*(C'\fR
+string. The format string consists of zero or more conversion specifications
+and ordinary characters. All ordinary characters are copied directly into the
+resulting string. A conversion specification consists of a percent sign \f(CW\*(C`%\*(C'\fR
and one other character.
.PP
The following conversion specifications are supported:
.ie n .IP %a 4
.el .IP \f(CW%a\fR 4
.IX Item "%a"
-Replaced by the C locale's abbreviated day of the week name.
+Replaced by the C locale's abbreviated day of the week name.
Example: Mon, Tue, ..., Sun.
.ie n .IP %A 4
.el .IP \f(CW%A\fR 4
@@ -1410,12 +1419,12 @@ Example: January, February, ..., Decembe
.ie n .IP %c 4
.el .IP \f(CW%c\fR 4
.IX Item "%c"
-Replaced by the C locale's date and time representation.
+Replaced by the C locale's date and time representation.
Equivalent to \f(CW"%a %b %e %H:%M:%S %Y"\fR.
.ie n .IP %C 4
.el .IP \f(CW%C\fR 4
.IX Item "%C"
-Replaced by the year divided by 100 and truncated to an integer, as a
+Replaced by the year divided by 100 and truncated to an integer, as a
decimal number [00, 99].
.ie n .IP %d 4
.el .IP \f(CW%d\fR 4
@@ -1428,15 +1437,15 @@ Equivalent to \f(CW"%m/%d/%y"\fR.
.ie n .IP %e 4
.el .IP \f(CW%e\fR 4
.IX Item "%e"
-Replaced by the day of the month as a decimal number [1, 31];
+Replaced by the day of the month as a decimal number [1, 31];
a single digit is preceded by a space.
.ie n .IP %f 4
.el .IP \f(CW%f\fR 4
.IX Item "%f"
-Replaced by the fractional second including the preceding decimal point or
-by an empty string if no fractional seconds are present. This conversion
-specification permits use of an optional maximum field width [0, 9] where
-the default field width of 0 will use the shortest of the following
+Replaced by the fractional second including the preceding decimal point or
+by an empty string if no fractional seconds are present. This conversion
+specification permits use of an optional maximum field width [0, 9] where
+the default field width of 0 will use the shortest of the following
representations:
.Sp
.Vb 3
@@ -1452,17 +1461,17 @@ Example:
\& $tm\->strftime(\*(Aq%f\*(Aq); # \*(Aq.123456\*(Aq
\& $tm\->strftime(\*(Aq%3f\*(Aq); # \*(Aq.123\*(Aq
\& $tm\->strftime(\*(Aq%9f\*(Aq); # \*(Aq.123456000\*(Aq
-\&
+\&
\& $tm = Time::Moment\->from_string(\*(Aq2012\-12\-24T15:30:45Z\*(Aq);
\& $tm\->strftime(\*(Aq%f\*(Aq); # \*(Aq\*(Aq
\& $tm\->strftime(\*(Aq%3f\*(Aq); # \*(Aq\*(Aq
.Ve
.Sp
-\&\f(CW%3f\fR is replaced by decimal point and exactly three fractional digits
-(zero-padded on the right or truncated if needed) if fractional seconds
+\&\f(CW%3f\fR is replaced by decimal point and exactly three fractional digits
+(zero-padded on the right or truncated if needed) if fractional seconds
are present.
.Sp
-\&\fIThis conversion specification is an extension to the
+\&\fIThis conversion specification is an extension to the
"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
.ie n .IP %F 4
.el .IP \f(CW%F\fR 4
@@ -1471,7 +1480,7 @@ Equivalent to \f(CW"%Y\-%m\-%d"\fR.
.ie n .IP %g 4
.el .IP \f(CW%g\fR 4
.IX Item "%g"
-Replaced by the last 2 digits of the year of the week as a decimal
+Replaced by the last 2 digits of the year of the week as a decimal
number [00, 99].
.ie n .IP %G 4
.el .IP \f(CW%G\fR 4
@@ -1496,18 +1505,18 @@ Replaced by the day of the year as a dec
.ie n .IP %k 4
.el .IP \f(CW%k\fR 4
.IX Item "%k"
-Replaced by the hour of day (24\-hour clock) as a decimal number [1, 23];
+Replaced by the hour of day (24\-hour clock) as a decimal number [1, 23];
a single digit is preceded by a space.
.Sp
-\&\fIThis conversion specification is an extension to the
+\&\fIThis conversion specification is an extension to the
"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
.ie n .IP %l 4
.el .IP \f(CW%l\fR 4
.IX Item "%l"
-Replaced by the hour of day (12\-hour clock) as a decimal number [1, 12];
+Replaced by the hour of day (12\-hour clock) as a decimal number [1, 12];
a single digit is preceded by a space.
.Sp
-\&\fIThis conversion specification is an extension to the
+\&\fIThis conversion specification is an extension to the
"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
.ie n .IP %m 4
.el .IP \f(CW%m\fR 4
@@ -1524,9 +1533,9 @@ Replaced by a <newline> character.
.ie n .IP %N 4
.el .IP \f(CW%N\fR 4
.IX Item "%N"
-Replaced by the fractional second as a decimal number. This conversion
-specification permits use of an optional maximum field width [0, 9] where
-the default field width of 0 will use the shortest of the following
+Replaced by the fractional second as a decimal number. This conversion
+specification permits use of an optional maximum field width [0, 9] where
+the default field width of 0 will use the shortest of the following
representations:
.Sp
.Vb 3
@@ -1544,10 +1553,10 @@ Example:
\& $tm\->strftime(\*(Aq%9N\*(Aq); # \*(Aq123456000\*(Aq
.Ve
.Sp
-\&\f(CW%3N\fR is replaced by exactly three fractional digits (zero-padded on the
+\&\f(CW%3N\fR is replaced by exactly three fractional digits (zero-padded on the
right or truncated if needed).
.Sp
-\&\fIThis conversion specification is an extension to the
+\&\fIThis conversion specification is an extension to the
"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
.ie n .IP %p 4
.el .IP \f(CW%p\fR 4
@@ -1556,7 +1565,7 @@ Replaced by the C locale's meridian nota
.ie n .IP %r 4
.el .IP \f(CW%r\fR 4
.IX Item "%r"
-Replaced by the C locale's time in a.m. and p.m. notation. Equivalent
+Replaced by the C locale's time in a.m. and p.m. notation. Equivalent
to \f(CW"%I:%M:%S %p"\fR.
.ie n .IP %R 4
.el .IP \f(CW%R\fR 4
@@ -1565,10 +1574,10 @@ Replaced by the time in 24\-hour notatio
.ie n .IP %s 4
.el .IP \f(CW%s\fR 4
.IX Item "%s"
-Replaced by the number of seconds from the epoch of 1970\-01\-01T00:00:00Z
+Replaced by the number of seconds from the epoch of 1970\-01\-01T00:00:00Z
as a decimal number.
.Sp
-\&\fIThis conversion specification is an extension to the
+\&\fIThis conversion specification is an extension to the
"IEEE Std 1003.1" <http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html>\fR.
.ie n .IP %S 4
.el .IP \f(CW%S\fR 4
@@ -1585,32 +1594,32 @@ Replaced by the time of day. Equivalent
.ie n .IP %u 4
.el .IP \f(CW%u\fR 4
.IX Item "%u"
-Replaced by the day of the week as a decimal number [1, 7], with 1
+Replaced by the day of the week as a decimal number [1, 7], with 1
representing Monday.
.ie n .IP %U 4
.el .IP \f(CW%U\fR 4
.IX Item "%U"
-Replaced by the week number of the year as a decimal number [00, 53]. The
-first Sunday of January is the first day of week 1; days in the new year
+Replaced by the week number of the year as a decimal number [00, 53]. The
+first Sunday of January is the first day of week 1; days in the new year
before this are in week 0.
.ie n .IP %V 4
.el .IP \f(CW%V\fR 4
.IX Item "%V"
-Replaced by the week number of the year (Monday as the first day of the week)
-as a decimal number [01, 53]. If the week containing 1 January has four or
-more days in the new year, then it is considered week 1. Otherwise, it is the
-last week of the previous year, and the next week is week 1. Both January 4th
+Replaced by the week number of the year (Monday as the first day of the week)
+as a decimal number [01, 53]. If the week containing 1 January has four or
+more days in the new year, then it is considered week 1. Otherwise, it is the
+last week of the previous year, and the next week is week 1. Both January 4th
and the first Thursday of January are always in week 1.
.ie n .IP %w 4
.el .IP \f(CW%w\fR 4
.IX Item "%w"
-Replaced by the day of the week as a decimal number [0, 6], with 0
+Replaced by the day of the week as a decimal number [0, 6], with 0
representing Sunday.
.ie n .IP %W 4
.el .IP \f(CW%W\fR 4
.IX Item "%W"
-Replaced by the week number of the year as a decimal number [00, 53]. The
-first Monday of January is the first day of week 1; days in the new year
+Replaced by the week number of the year as a decimal number [00, 53]. The
+first Monday of January is the first day of week 1; days in the new year
before this are in week 0.
.ie n .IP %x 4
.el .IP \f(CW%x\fR 4
@@ -1639,7 +1648,7 @@ Replaced by the offset from UTC in the I
.ie n .IP %Z 4
.el .IP \f(CW%Z\fR 4
.IX Item "%Z"
-Replaced by the offset from UTC in the ISO 8601 extended format or by UTC
+Replaced by the offset from UTC in the ISO 8601 extended format or by UTC
designator (?hh:mm or Z).
.ie n .IP """%%""" 4
.el .IP \f(CW%%\fR 4
@@ -1698,7 +1707,7 @@ The nanosecond of the second [0, 999_999
\& $seconds = $tm\->utc_rd_as_seconds;
.Ve
.PP
-Returns the number of integral seconds from the Rata Die epoch of
+Returns the number of integral seconds from the Rata Die epoch of
0000\-12\-31T00:00:00Z.
.SS local_rd_values
.IX Subsection "local_rd_values"
@@ -1725,7 +1734,7 @@ The nanosecond of the second [0, 999_999
\& $seconds = $tm\->local_rd_as_seconds;
.Ve
.PP
-Returns the number of integral seconds from the Rata Die epoch of
+Returns the number of integral seconds from the Rata Die epoch of
0000\-12\-31T00:00:00.
.SH "OVERLOADED OPERATORS"
.IX Header "OVERLOADED OPERATORS"
@@ -1751,7 +1760,7 @@ Followed by a zone designator in one of
\& ?hh:mm
.Ve
.PP
-The shortest representation will be used where the omitted parts are implied
+The shortest representation will be used where the omitted parts are implied
to be zero. This representation is conformant with ISO 8601 profiles, such as:
.IP \(bu 4
RFC 3339 Date and Time on the Internet: Timestamps <http://tools.ietf.org/html/rfc3339>
@@ -1764,7 +1773,7 @@ HTML5 <http://www.w3.org/TR/html5/infras
.IP \(bu 4
XML Schema <http://www.w3.org/TR/xmlschema-2/#dateTime>
.PP
-The \f(CW\*(C`to_string\*(C'\fR method or the \f(CW\*(C`strftime\*(C'\fR format string \f(CW"%Y\-%m\-%dT%H:%M:%S%f%Z"\fR
+The \f(CW\*(C`to_string\*(C'\fR method or the \f(CW\*(C`strftime\*(C'\fR format string \f(CW"%Y\-%m\-%dT%H:%M:%S%f%Z"\fR
produces an equivalent string representation:
.PP
.Vb 2
@@ -1772,13 +1781,13 @@ produces an equivalent string representa
\& "$tm" eq $tm\->strftime("%Y\-%m\-%dT%H:%M:%S%f%Z");
.Ve
.PP
-The total length of the string representation will be between 20 and 35
+The total length of the string representation will be between 20 and 35
characters (inclusive).
.SS comparison
.IX Subsection "comparison"
.Vb 1
\& $integer = $tm1 <=> $tm2;
-\&
+\&
\& $boolean = $tm1 == $tm2;
\& $boolean = $tm1 != $tm2;
\& $boolean = $tm1 < $tm2;
@@ -1790,12 +1799,12 @@ characters (inclusive).
.IX Header "SERIALIZATION"
.SS Storable
.IX Subsection "Storable"
-The serialized representation of a \f(CW\*(C`Time::Moment\*(C'\fR is a string of 16 bytes that
-contains MAGIC (2 bytes), time zone offset from UTC (2 bytes), the number
-of days from Rata Die (4 bytes), second of the day (4 bytes) and nanosecond of
+The serialized representation of a \f(CW\*(C`Time::Moment\*(C'\fR is a string of 16 bytes that
+contains MAGIC (2 bytes), time zone offset from UTC (2 bytes), the number
+of days from Rata Die (4 bytes), second of the day (4 bytes) and nanosecond of
the second (4 bytes).
.PP
-The total size of the serialized \f(CW\*(C`Time::Moment\*(C'\fR instance using \f(CW\*(C`nfreeze\*(C'\fR is
+The total size of the serialized \f(CW\*(C`Time::Moment\*(C'\fR instance using \f(CW\*(C`nfreeze\*(C'\fR is
34 bytes.
.SS JSON
.IX Subsection "JSON"
@@ -1810,12 +1819,12 @@ See CBOR::XS, RFC 7049 Section 2.4.1 <ht
and \f(CW\*(C`eg/cbor.pl\*(C'\fR for an example how to roundtrip instances of \f(CW\*(C`Time::Moment\*(C'\fR.
.SS Sereal
.IX Subsection "Sereal"
-Sereal version 2.030 or later implements support for the generic serialization
+Sereal version 2.030 or later implements support for the generic serialization
protocol \f(CW\*(C`FREEZE/THAW\*(C'\fR.
.SS FREEZE/THAW
.IX Subsection "FREEZE/THAW"
\&\f(CW\*(C`Time::Moment\*(C'\fR implements a \f(CW\*(C`FREEZE\*(C'\fR method that returns the stringified
-representation of the instance and a \f(CW\*(C`THAW\*(C'\fR method according to the serialization
+representation of the instance and a \f(CW\*(C`THAW\*(C'\fR method according to the serialization
protocol specified in Types::Serialiser.
.SH "EXAMPLE FORMAT STRINGS"
.IX Header "EXAMPLE FORMAT STRINGS"
@@ -1841,7 +1850,7 @@ Ordinal date \- 24 December 2012
.Vb 2
\& Basic format: Example:
\& %Y%j 2012359
-\&
+\&
\& Extended format: Example:
\& %Y\-%j 2012\-359
.Ve
@@ -1873,7 +1882,7 @@ Local time \- 30 minutes and 45 seconds
\& %H:%M 15:30 (reduced accuracy)
.Ve
.PP
-Local time with decimal fractions \- 30 minutes and 45 and a half second
+Local time with decimal fractions \- 30 minutes and 45 and a half second
past 15 hours
.PP
.Vb 3
@@ -1886,7 +1895,7 @@ past 15 hours
\& %H:%M:%S.%1N 15:30:45.5
.Ve
.PP
-Local time and the difference from UTC \- 30 minutes and 45 seconds past
+Local time and the difference from UTC \- 30 minutes and 45 seconds past
15 hours, one hour ahead of UTC
.PP
.Vb 2
@@ -1948,11 +1957,11 @@ Literal values from Part 2: Foundation (
.Vb 2
\& Date: Example:
\& %Y\-%m\-%d 2012\-12\-24
-\&
+\&
\& Time: Example:
\& %H:%M:%S 15:30:45
\& %H:%M:%S%f 15:30:45.500
-\&
+\&
\& Timestamp: Example:
\& %Y\-%m\-%d %H:%M:%S 2012\-12\-24 15:30:45
\& %Y\-%m\-%d %H:%M:%S %:z 2012\-12\-24 15:30:45 +01:00
@@ -1961,7 +1970,7 @@ Literal values from Part 2: Foundation (
.Ve
.SS "RFC 1123 \- Requirements for Internet Hosts"
.IX Subsection "RFC 1123 - Requirements for Internet Hosts"
-RFC 822 <http://tools.ietf.org/html/rfc822#section-5> as updated by
+RFC 822 <http://tools.ietf.org/html/rfc822#section-5> as updated by
RFC 1123 <http://tools.ietf.org/html/rfc1123>.
.PP
.Vb 2
@@ -2165,7 +2174,7 @@ A year can be 365 or 366 days (leap year
.IP \(bu 4
In contrast, time units such as seconds, minutes, and hours are fixed. For instance, there are always 60 seconds in a minute and 60 minutes in an hour.
.PP
-\&\fBExample:\fR
+\&\fBExample:\fR
Adding 1 calendar month to January 31 may result in February 28 (or 29 in a leap year) rather than February 31, which does not exist.
.SS "2. Conceptual Differences Between Calendar and Time Units"
.IX Subsection "2. Conceptual Differences Between Calendar and Time Units"
@@ -2174,7 +2183,7 @@ Adding 1 calendar month to January 31 ma
.IP \(bu 4
\&\fBTime units\fR measure exact durations, such as the total number of seconds, minutes, or hours between two timestamps.
.PP
-\&\fBExample:\fR
+\&\fBExample:\fR
The difference between \f(CW\*(C`2012\-12\-31T23:59:59Z\*(C'\fR and \f(CW\*(C`2013\-01\-01T00:59:59Z\*(C'\fR:
.IP \(bu 4
In \fBcalendar terms\fR, this spans 2 calendar days, as moving even 1 second into January 1 is considered a new day.
@@ -2188,7 +2197,7 @@ Mixing calendar and time units can lead
.IP \(bu 4
Phrases like "1 day and 2 hours" might be ambiguous if not explicitly tied to a specific time context.
.IP \(bu 4
-A span of "24 hours" does not always equate to "1 calendar day," particularly when factors like daylight saving time come into play.
+A span of "24 hours" does not always equate to "1 calendar day", particularly when factors like daylight saving time come into play.
.RE
.RS 4
.RE
@@ -2200,12 +2209,12 @@ Use \fBcalendar units\fR when dealing wi
Use \fBtime units\fR when working with precise durations, such as timers, interval measurements, or elapsed time calculations.
.SH "TIME ZONES"
.IX Header "TIME ZONES"
-A \f(CW\*(C`Time::Moment\*(C'\fR instance represents a precise point in time but does
-not account for time zones. When performing arithmetic or modifying
-components of the local date/time, it may be necessary to apply a
+A \f(CW\*(C`Time::Moment\*(C'\fR instance represents a precise point in time but does
+not account for time zones. When performing arithmetic or modifying
+components of the local date/time, it may be necessary to apply a
time zone conversion to ensure accurate representation.
.PP
-\&\f(CW\*(C`Time::Moment\*(C'\fR is API compatible with DateTime::TimeZone and
+\&\f(CW\*(C`Time::Moment\*(C'\fR is API compatible with DateTime::TimeZone and
DateTime::TimeZone::Tzfile.
.SS "Converting from instant time to designated time zone"
.IX Subsection "Converting from instant time to designated time zone"
@@ -2218,7 +2227,7 @@ DateTime::TimeZone::Tzfile.
\& );
\& $zone = DateTime::TimeZone\->new(name => \*(AqAmerica/New_York\*(Aq);
\& $offset = $zone\->offset_for_datetime($tm) / 60;
-\&
+\&
\& say $tm\->with_offset_same_instant($offset); # 2012\-12\-24T10\-05
.Ve
.SS "Converting from local time to designated time zone"
@@ -2232,24 +2241,24 @@ DateTime::TimeZone::Tzfile.
\& );
\& $zone = DateTime::TimeZone\->new(name => \*(AqAmerica/New_York\*(Aq);
\& $offset = $zone\->offset_for_local_datetime($tm) / 60;
-\&
+\&
\& say $tm\->with_offset_same_local($offset); # 2012\-12\-24T15\-05
.Ve
.SS "The Effect of Daylight Saving Time"
.IX Subsection "The Effect of Daylight Saving Time"
-The time zone \fIEurope/Brussels\fR has 01:00 UTC as standard time, and 02:00
-UTC as daylight savings time, with transition dates according to the
+The time zone \fIEurope/Brussels\fR has 01:00 UTC as standard time, and 02:00
+UTC as daylight savings time, with transition dates according to the
European Summer Time <http://en.wikipedia.org/wiki/Summer_Time_in_Europe>.
.PP
.Vb 1
\& $zone = DateTime::TimeZone\->new(name => \*(AqEurope/Brussels\*(Aq);
-\&
+\&
\& sub convert_from_instant {
\& my ($tm, $zone) = @_;
\& my $offset = $zone\->offset_for_datetime($tm) / 60;
\& return $tm\->with_offset_same_instant($offset);
\& }
-\&
+\&
\& sub convert_from_local {
\& my ($tm, $zone) = @_;
\& my $offset = $zone\->offset_for_local_datetime($tm) / 60;
@@ -2257,7 +2266,7 @@ European Summer Time <http://en.wikipedi
\& }
.Ve
.PP
-European Summer Time begins (clocks go forward) at 01:00 UTC on the last
+European Summer Time begins (clocks go forward) at 01:00 UTC on the last
Sunday in March, in 2014 the transition date was March 30.
.PP
.Vb 4
@@ -2267,9 +2276,9 @@ Sunday in March, in 2014 the transition
\& say convert_from_local($tm2, $zone); # 2014\-03\-30T12+02
.Ve
.PP
-During the transition from standard time to daylight savings time, the
-local time interval between 02:00:00 and 02:59:59 does not exist. Local
-time values in that interval are invalid. \f(CW\*(C`DateTime::TimeZone\*(C'\fR raises
+During the transition from standard time to daylight savings time, the
+local time interval between 02:00:00 and 02:59:59 does not exist. Local
+time values in that interval are invalid. \f(CW\*(C`DateTime::TimeZone\*(C'\fR raises
an exception when attempting to convert non-existing local time.
.PP
.Vb 4
@@ -2279,7 +2288,7 @@ an exception when attempting to convert
\& say convert_from_local($tm2, $zone); # raises an exception
.Ve
.PP
-European Summer Time ends (clocks go backward) at 01:00 UTC on the last
+European Summer Time ends (clocks go backward) at 01:00 UTC on the last
Sunday in October, in 2014 the transition date was October 26.
.PP
.Vb 4
@@ -2290,9 +2299,9 @@ Sunday in October, in 2014 the transitio
.Ve
.PP
During the transition from daylight savings time to standard time, the
-local time interval between 02:00:00 and 02:59:59 is repeated. Local
+local time interval between 02:00:00 and 02:59:59 is repeated. Local
time values in that interval are ambiguous because they occur twice.
-When \f(CW\*(C`DateTime::TimeZone\*(C'\fR converts an ambiguous local time it returns
+When \f(CW\*(C`DateTime::TimeZone\*(C'\fR converts an ambiguous local time it returns
the numerically lowest offset (usually the standard one).
.PP
.Vb 4
@@ -2342,7 +2351,7 @@ at <https://github.com/chansen/p5\-time\
You will be notified automatically of any progress on your issue.
.SS "SOURCE CODE"
.IX Subsection "SOURCE CODE"
-This is open source software. The code repository is available for public
+This is open source software. The code repository is available for public
review and contribution under the terms of the license.
.PP
<https://github.com/chansen/p5\-time\-moment>
-------------- next part --------------
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
To find trailing space use
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
The same goes for man pages that are used as an input.
-.-
For a style guide use
mandoc -T lint
-.-
For general input conventions consult the man page "nroff(7)" (item
"Input conventions") or the Texinfo manual about the same item.
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
-.-
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
-.-
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced when that has been fixed.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original
and patched file can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
More information about the pkg-perl-maintainers
mailing list