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
170              weeks
171              w
172              wk
173              wks
174              week
175
176              days
177              d
178              day
179
180              hours
181              h
182              hr
183              hrs
184              hour
185
186              minutes
187              mn
188              min
189              minute
190
191              seconds
192              s
193              sec
194              second
195
196       Morning/afternoon times
197           This is a list of expressions use to designate morning or afternoon
198           time when a time is entered as a 12-hour time rather than a 24-hour
199           time.  For example, in English, the time "17:00" could be specified
200           as "5:00 PM".
201
202           Morning and afternoon time may be designated by the following sets
203           of words:
204
205              AM
206              A.M.
207
208              PM
209              P.M.
210
211       Each or every
212           There are a list of words that specify every occurence of
213           something.  These are used in the following phrases:
214
215              EACH Monday
216              EVERY Monday
217              EVERY month
218
219           The following words may be used:
220
221              each
222              every
223
224       Next/Previous/Last occurence
225           There are a list of words that may be used to specify the next,
226           previous, or last occurence of something.  These words could be
227           used in the following phrases:
228
229              NEXT week
230
231              LAST tuesday
232              PREVIOUS tuesday
233
234              LAST day of the month
235
236           The following words may be used:
237
238           Next occurence:
239
240              next
241              following
242
243           Previous occurence:
244
245              previous
246              last
247
248           Last occurence:
249
250              last
251              final
252
253       Delta words for going forward/backward in time
254           When parsing deltas, there are words that may be used to specify
255           the the delta will refer to a time in the future or to a time in
256           the past (relative to some date).  In English, for example, you
257           might say:
258
259              IN 5 days
260              5 days AGO
261
262           The following words may be used to specify deltas that refer to
263           dates in the past or future respectively:
264
265              ago
266              past
267              in the past
268              earlier
269              before now
270
271              in
272              later
273              future
274              in the future
275              from now
276
277       Business mode
278           This contains two lists of words which can be used to specify a
279           standard (i.e. non-business) delta or a business delta.
280
281           Previously, it was used to tell whether the delta was approximate
282           or exact, but now this list is not used except to force the delta
283           to be standard.
284
285           The following words may be used:
286
287              exactly
288              approximately
289
290           The following words may be used to specify a business delta:
291
292              business
293
294       Numbers
295           Numbers may be spelled out in a variety of ways.  The following
296           sets correspond to the numbers from 1 to 53:
297
298              1st
299              first
300              one
301
302              2nd
303              second
304              two
305
306              3rd
307              third
308              three
309
310              4th
311              fourth
312              four
313
314              5th
315              fifth
316              five
317
318              6th
319              sixth
320              six
321
322              7th
323              seventh
324              seven
325
326              8th
327              eighth
328              eight
329
330              9th
331              ninth
332              nine
333
334              10th
335              tenth
336              ten
337
338
339              11th
340              eleventh
341              eleven
342
343              12th
344              twelfth
345              twelve
346
347              13th
348              thirteenth
349              thirteen
350
351              14th
352              fourteenth
353              fourteen
354
355              15th
356              fifteenth
357              fifteen
358
359              16th
360              sixteenth
361              sixteen
362
363              17th
364              seventeenth
365              seventeen
366
367              18th
368              eighteenth
369              eighteen
370
371              19th
372              nineteenth
373              nineteen
374
375              20th
376              twentieth
377              twenty
378
379
380              21st
381              twenty-first
382              twenty-one
383
384              22nd
385              twenty-second
386              twenty-two
387
388              23rd
389              twenty-third
390              twenty-three
391
392              24th
393              twenty-fourth
394              twenty-four
395
396              25th
397              twenty-fifth
398              twenty-five
399
400              26th
401              twenty-sixth
402              twenty-six
403
404              27th
405              twenty-seventh
406              twenty-seven
407
408              28th
409              twenty-eighth
410              twenty-eight
411
412              29th
413              twenty-ninth
414              twenty-nine
415
416              30th
417              thirtieth
418              thirty
419
420
421              31st
422              thirty-first
423              thirty-one
424
425              32nd
426              thirty-two
427              thirty-second
428
429              33rd
430              thirty-three
431              thirty-third
432
433              34th
434              thirty-four
435              thirty-fourth
436
437              35th
438              thirty-five
439              thirty-fifth
440
441              36th
442              thirty-six
443              thirty-sixth
444
445              37th
446              thirty-seven
447              thirty-seventh
448
449              38th
450              thirty-eight
451              thirty-eighth
452
453              39th
454              thirty-nine
455              thirty-ninth
456
457              40th
458              forty
459              fortieth
460
461
462              41st
463              forty-one
464              forty-first
465
466              42nd
467              forty-two
468              forty-second
469
470              43rd
471              forty-three
472              forty-third
473
474              44th
475              forty-four
476              forty-fourth
477
478              45th
479              forty-five
480              forty-fifth
481
482              46th
483              forty-six
484              forty-sixth
485
486              47th
487              forty-seven
488              forty-seventh
489
490              48th
491              forty-eight
492              forty-eighth
493
494              49th
495              forty-nine
496              forty-ninth
497
498              50th
499              fifty
500              fiftieth
501
502
503              51st
504              fifty-one
505              fifty-first
506
507              52nd
508              fifty-two
509              fifty-second
510
511              53rd
512              fifty-three
513              fifty-third
514
515       Ignored words
516           In writing out dates in common forms, there are a number of words
517           that are typically not important.
518
519           There is frequently a word that appears in a phrase to designate
520           that a time is going to be specified next.  In English, you would
521           use the word AT in the example:
522
523              December 3 at 12:00
524
525           The following words may be used:
526
527              at
528
529           Another word is used to designate one member of a set.  In English,
530           you would use the words IN or OF:
531
532              1st day OF December
533              1st day IN December
534
535           The following words may be used:
536
537              of
538              in
539
540           Another word is use to specify that something is on a certain date.
541           In English, you would use ON:
542
543              ON July 5th
544
545           The following words may be used:
546
547              on
548
549       Words that set the date, time, or both
550           There are some words that can be used to specify a date, a time, or
551           both relative to now.
552
553           Words that set the date are similar to the English words
554           'yesterday' or 'tomorrow'.  These are specified as a delta which is
555           added to the current time to get a date.  The time is NOT set
556           however, so the delta is only partially used (it should only
557           include year, month, week, and day fields).
558
559           The following words may be used:
560
561              ereyesterday         -0:0:0:2:0:0:0
562              overmorrow           +0:0:0:2:0:0:0
563              today                0:0:0:0:0:0:0
564              tomorrow             +0:0:0:1:0:0:0
565              yesterday            -0:0:0:1:0:0:0
566
567           Words that set only the time of day are similar to the English
568           words 'noon' or 'midnight'.
569
570           The following words may be used:
571
572              midnight             00:00:00
573              noon                 12:00:00
574
575           Words that set the entire time and date (relative to the current
576           time and date) are also available.
577
578           In English, the word 'now' is one of these.
579
580           The following words may be used:
581
582              now                  0:0:0:0:0:0:0
583
584       Hour/Minute/Second separators
585           When specifying the time of day, the most common separator is a
586           colon (:) which can be used for both separators.
587
588           Some languages use different pairs.  For example, French allows you
589           to specify the time as 13h30:20, so it would use the following
590           pairs:
591
592              : :
593              [h] [:]
594
595           The first column is the hour-minute separator and the second column
596           is the minute-second separator.  Both are perl regular expressions.
597
598           A pair of colons is ALWAY allowed for all languages.  If a language
599           allows additional pairs, they are listed here:
600
601              Not defined in this language
602

KNOWN BUGS

604       None known.
605

BUGS AND QUESTIONS

607       Please refer to the Date::Manip::Problems documentation for information
608       on submitting bug reports or questions to the author.
609

SEE ALSO

611       Date::Manip        - main module documentation
612

LICENSE

614       This script is free software; you can redistribute it and/or modify it
615       under the same terms as Perl itself.
616

AUTHOR

618       Sullivan Beck (sbeck@cpan.org)
619
620
621
622perl v5.16.3                      2014-06-09     Date::Manip::Lang::english(3)
Impressum