1Date::Manip::Lang::englUissehr(3C)ontributed Perl DocumeDnattaet:i:oMnanip::Lang::english(3)
2
3
4

NAME

6       Date::Manip::Lang::english - English language support.
7

SYNOPSIS

9       This module contains a list of words and expressions supporting the
10       language. It is not intended to be used directly (other Date::Manip
11       modules will load it as needed).
12

LANGUAGE EXPRESSIONS

14       The following is a list of all language words and expressions used to
15       write times and/or dates.
16
17       All strings are case insensitive.
18
19       Month names and abbreviations
20           When writing out the name of the month, several different
21           variations may exist including full names and abbreviations.
22
23           The following month names may be used:
24
25              January
26
27              February
28
29              March
30
31              April
32
33              May
34
35              June
36
37              July
38
39              August
40
41              September
42
43              October
44
45              November
46
47              December
48
49           The following abbreviations may be used:
50
51              Jan
52              Jan.
53
54              Feb
55              Feb.
56
57              Mar
58              Mar.
59
60              Apr
61              Apr.
62
63              May
64              May.
65
66              Jun
67              Jun.
68
69              Jul
70              Jul.
71
72              Aug
73              Aug.
74
75              Sep
76              Sept
77              Sep.
78              Sept.
79
80              Oct
81              Oct.
82
83              Nov
84              Nov.
85
86              Dec
87              Dec.
88
89       Day names and abbreviations
90           When writing out the name of the day, several different variations
91           may exist including full names and abbreviations.
92
93           The following day names may be used:
94
95              Monday
96
97              Tuesday
98
99              Wednesday
100
101              Thursday
102
103              Friday
104
105              Saturday
106
107              Sunday
108
109           The following abbreviations may be used:
110
111              Mon
112              Mon.
113
114              Tue
115              Tues
116              Tue.
117              Tues.
118
119              Wed
120              Wed.
121
122              Thu
123              Thur
124              Thu.
125              Thur.
126
127              Fri
128              Fri.
129
130              Sat
131              Sat.
132
133              Sun
134              Sun.
135
136           The following short (1-2 characters) abbreviations may be used:
137
138              M
139
140              T
141
142              W
143
144              Th
145
146              F
147
148              Sa
149
150              S
151
152       Delta field names
153           These are the names (and abbreviations) for the fields in a delta.
154           There are 7 fields: years, months, weeks, days, hours, minutes,
155           seconds.
156
157           The names and abbreviations for these fields are:
158
159              years
160              y
161              yr
162              year
163              yrs
164
165              months
166              m
167              mon
168              month
169              mons
170
171              weeks
172              w
173              wk
174              wks
175              week
176
177              days
178              d
179              day
180
181              hours
182              h
183              hr
184              hrs
185              hour
186
187              minutes
188              mn
189              min
190              minute
191              mins
192
193              seconds
194              s
195              sec
196              second
197              secs
198
199       Morning/afternoon times
200           This is a list of expressions use to designate morning or afternoon
201           time when a time is entered as a 12-hour time rather than a 24-hour
202           time.  For example, in English, the time "17:00" could be specified
203           as "5:00 PM".
204
205           Morning and afternoon time may be designated by the following sets
206           of words:
207
208              AM
209              A.M.
210
211              PM
212              P.M.
213
214       Each or every
215           There are a list of words that specify every occurrence of
216           something.  These are used in the following phrases:
217
218              EACH Monday
219              EVERY Monday
220              EVERY month
221
222           The following words may be used:
223
224              each
225              every
226
227       Next/Previous/Last occurrence
228           There are a list of words that may be used to specify the next,
229           previous, or last occurrence of something.  These words could be
230           used in the following phrases:
231
232              NEXT week
233
234              LAST Tuesday
235              PREVIOUS Tuesday
236
237              LAST day of the month
238
239           The following words may be used:
240
241           Next occurrence:
242
243              next
244              following
245
246           Previous occurrence:
247
248              previous
249              last
250
251           Last occurrence:
252
253              last
254              final
255
256       Delta words for going forward/backward in time
257           When parsing deltas, there are words that may be used to specify
258           the the delta will refer to a time in the future or to a time in
259           the past (relative to some date).  In English, for example, you
260           might say:
261
262              IN 5 days
263              5 days AGO
264
265           The following words may be used to specify deltas that refer to
266           dates in the past or future respectively:
267
268              ago
269              past
270              in the past
271              earlier
272              before now
273
274              in
275              later
276              future
277              in the future
278              from now
279
280       Business mode
281           This contains two lists of words which can be used to specify a
282           standard (i.e. non-business) delta or a business delta.
283
284           Previously, it was used to tell whether the delta was approximate
285           or exact, but now this list is not used except to force the delta
286           to be standard.
287
288           The following words may be used:
289
290              exactly
291              approximately
292
293           The following words may be used to specify a business delta:
294
295              business
296
297       Numbers
298           Numbers may be spelled out in a variety of ways.  The following
299           sets correspond to the numbers from 1 to 53:
300
301              1st
302              first
303              one
304
305              2nd
306              second
307              two
308
309              3rd
310              third
311              three
312
313              4th
314              fourth
315              four
316
317              5th
318              fifth
319              five
320
321              6th
322              sixth
323              six
324
325              7th
326              seventh
327              seven
328
329              8th
330              eighth
331              eight
332
333              9th
334              ninth
335              nine
336
337              10th
338              tenth
339              ten
340
341
342              11th
343              eleventh
344              eleven
345
346              12th
347              twelfth
348              twelve
349
350              13th
351              thirteenth
352              thirteen
353
354              14th
355              fourteenth
356              fourteen
357
358              15th
359              fifteenth
360              fifteen
361
362              16th
363              sixteenth
364              sixteen
365
366              17th
367              seventeenth
368              seventeen
369
370              18th
371              eighteenth
372              eighteen
373
374              19th
375              nineteenth
376              nineteen
377
378              20th
379              twentieth
380              twenty
381
382
383              21st
384              twenty-first
385              twenty-one
386
387              22nd
388              twenty-second
389              twenty-two
390
391              23rd
392              twenty-third
393              twenty-three
394
395              24th
396              twenty-fourth
397              twenty-four
398
399              25th
400              twenty-fifth
401              twenty-five
402
403              26th
404              twenty-sixth
405              twenty-six
406
407              27th
408              twenty-seventh
409              twenty-seven
410
411              28th
412              twenty-eighth
413              twenty-eight
414
415              29th
416              twenty-ninth
417              twenty-nine
418
419              30th
420              thirtieth
421              thirty
422
423
424              31st
425              thirty-first
426              thirty-one
427
428              32nd
429              thirty-two
430              thirty-second
431
432              33rd
433              thirty-three
434              thirty-third
435
436              34th
437              thirty-four
438              thirty-fourth
439
440              35th
441              thirty-five
442              thirty-fifth
443
444              36th
445              thirty-six
446              thirty-sixth
447
448              37th
449              thirty-seven
450              thirty-seventh
451
452              38th
453              thirty-eight
454              thirty-eighth
455
456              39th
457              thirty-nine
458              thirty-ninth
459
460              40th
461              forty
462              fortieth
463
464
465              41st
466              forty-one
467              forty-first
468
469              42nd
470              forty-two
471              forty-second
472
473              43rd
474              forty-three
475              forty-third
476
477              44th
478              forty-four
479              forty-fourth
480
481              45th
482              forty-five
483              forty-fifth
484
485              46th
486              forty-six
487              forty-sixth
488
489              47th
490              forty-seven
491              forty-seventh
492
493              48th
494              forty-eight
495              forty-eighth
496
497              49th
498              forty-nine
499              forty-ninth
500
501              50th
502              fifty
503              fiftieth
504
505
506              51st
507              fifty-one
508              fifty-first
509
510              52nd
511              fifty-two
512              fifty-second
513
514              53rd
515              fifty-three
516              fifty-third
517
518       Ignored words
519           In writing out dates in common forms, there are a number of words
520           that are typically not important.
521
522           There is frequently a word that appears in a phrase to designate
523           that a time is going to be specified next.  In English, you would
524           use the word AT in the example:
525
526              December 3 at 12:00
527
528           The following words may be used:
529
530              at
531
532           Another word is used to designate one member of a set.  In English,
533           you would use the words IN or OF:
534
535              1st day OF December
536              1st day IN December
537
538           The following words may be used:
539
540              of
541              in
542
543           Another word is use to specify that something is on a certain date.
544           In English, you would use ON:
545
546              ON July 5th
547
548           The following words may be used:
549
550              on
551
552       Words that set the date, time, or both
553           There are some words that can be used to specify a date, a time, or
554           both relative to now.
555
556           Words that set the date are similar to the English words
557           'yesterday' or 'tomorrow'.  These are specified as a delta which is
558           added to the current time to get a date.  The time is NOT set
559           however, so the delta is only partially used (it should only
560           include year, month, week, and day fields).
561
562           The following words may be used:
563
564              ereyesterday         -0:0:0:2:0:0:0
565              overmorrow           +0:0:0:2:0:0:0
566              today                0:0:0:0:0:0:0
567              tomorrow             +0:0:0:1:0:0:0
568              yesterday            -0:0:0:1:0:0:0
569
570           Words that set only the time of day are similar to the English
571           words 'noon' or 'midnight'.
572
573           The following words may be used:
574
575              midnight             00:00:00
576              noon                 12:00:00
577
578           Words that set the entire time and date (relative to the current
579           time and date) are also available.
580
581           In English, the word 'now' is one of these.
582
583           The following words may be used:
584
585              now                  0:0:0:0:0:0:0
586
587       Hour/Minute/Second separators
588           When specifying the time of day, the most common separator is a
589           colon (:) which can be used for both separators.
590
591           Some languages use different pairs.  For example, French allows you
592           to specify the time as 13h30:20, so it would use the following
593           pairs:
594
595              : :
596              h :
597
598           The first column is the hour-minute separator and the second column
599           is the minute-second separator.  Both are perl regular expressions.
600           When creating a new translation, be aware that regular expressions
601           with utf-8 characters may be tricky.  For example, don't include
602           the expression '[x]' where 'x' is a utf-8 character.
603
604           A pair of colons is ALWAYS allowed for all languages.  If a
605           language allows additional pairs, they are listed here:
606
607              Not defined in this language
608
609       Fractional second separator
610           When specifying fractional seconds, the most common way is to use a
611           decimal point (.).  Some languages may specify a different
612           separator that might be used.  If this is done, it is a regular
613           expression.
614
615           The decimal point is ALWAYS allowed for all languages.  If a
616           language allows another separator, it is listed here:
617
618              Not defined in this language
619

KNOWN BUGS

621       None known.
622

BUGS AND QUESTIONS

624       Please refer to the Date::Manip::Problems documentation for information
625       on submitting bug reports or questions to the author.
626

SEE ALSO

628       Date::Manip       - main module documentation
629

LICENSE

631       This script is free software; you can redistribute it and/or modify it
632       under the same terms as Perl itself.
633

AUTHOR

635       Sullivan Beck (sbeck@cpan.org)
636
637
638
639perl v5.36.0                      2023-03-08     Date::Manip::Lang::english(3)
Impressum