1Date::Manip::Lang::englUissehr(3C)ontributed Perl DocumeDnattaet:i:oMnanip::Lang::english(3)
2
3
4
6 Date::Manip::Lang::english - English language support.
7
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
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
621 None known.
622
624 Please refer to the Date::Manip::Problems documentation for information
625 on submitting bug reports or questions to the author.
626
628 Date::Manip - main module documentation
629
631 This script is free software; you can redistribute it and/or modify it
632 under the same terms as Perl itself.
633
635 Sullivan Beck (sbeck@cpan.org)
636
637
638
639perl v5.36.0 2022-12-10 Date::Manip::Lang::english(3)