1Date::Manip::Lang::englUissehr(3C)ontributed Perl DocumeDnattaet:i:oMnanip::Lang::english(3)
2
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 All strings are case insensitive.
18 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 The following month names may be used:
24 January
26 February
28 March
30 April
32 May
34 June
36 July
38 August
40 September
42 October
44 November
46 December
48 The following abbreviations may be used:
50 Jan
52 Jan.
53 Feb
55 Feb.
56 Mar
58 Mar.
59 Apr
61 Apr.
62 May
64 May.
65 Jun
67 Jun.
68 Jul
70 Jul.
71 Aug
73 Aug.
74 Sep
76 Sept
77 Sep.
78 Sept.
79 Oct
81 Oct.
82 Nov
84 Nov.
85 Dec
87 Dec.
88 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 The following day names may be used:
94 Monday
96 Tuesday
98 Wednesday
100 Thursday
102 Friday
104 Saturday
106 Sunday
108 The following abbreviations may be used:
110 Mon
112 Mon.
113 Tue
115 Tues
116 Tue.
117 Tues.
118 Wed
120 Wed.
121 Thu
123 Thur
124 Thu.
125 Thur.
126 Fri
128 Fri.
129 Sat
131 Sat.
132 Sun
134 Sun.
135 The following short (1-2 characters) abbreviations may be used:
137 M
139 T
141 W
143 Th
145 F
147 Sa
149 S
151 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 The names and abbreviations for these fields are:
158 years
160 y
161 yr
162 year
163 yrs
164 months
166 m
167 mon
168 month
169 mons
170 weeks
172 w
173 wk
174 wks
175 week
176 days
178 d
179 day
180 hours
182 h
183 hr
184 hrs
185 hour
186 minutes
188 mn
189 min
190 minute
191 mins
192 seconds
194 s
195 sec
196 second
197 secs
198 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 Morning and afternoon time may be designated by the following sets
206 of words:
207 AM
209 A.M.
210 PM
212 P.M.
213 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 EACH Monday
219 EVERY Monday
220 EVERY month
221 The following words may be used:
223 each
225 every
226 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 NEXT week
233 LAST Tuesday
235 PREVIOUS Tuesday
236 LAST day of the month
238 The following words may be used:
240 Next occurrence:
242 next
244 following
245 Previous occurrence:
247 previous
249 last
250 Last occurrence:
252 last
254 final
255 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 IN 5 days
263 5 days AGO
264 The following words may be used to specify deltas that refer to
266 dates in the past or future respectively:
267 ago
269 past
270 in the past
271 earlier
272 before now
273 in
275 later
276 future
277 in the future
278 from now
279 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 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 The following words may be used:
289 exactly
291 approximately
292 The following words may be used to specify a business delta:
294 business
296 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 1st
302 first
303 one
304 2nd
306 second
307 two
308 3rd
310 third
311 three
312 4th
314 fourth
315 four
316 5th
318 fifth
319 five
320 6th
322 sixth
323 six
324 7th
326 seventh
327 seven
328 8th
330 eighth
331 eight
332 9th
334 ninth
335 nine
336 10th
338 tenth
339 ten
340 11th
343 eleventh
344 eleven
345 12th
347 twelfth
348 twelve
349 13th
351 thirteenth
352 thirteen
353 14th
355 fourteenth
356 fourteen
357 15th
359 fifteenth
360 fifteen
361 16th
363 sixteenth
364 sixteen
365 17th
367 seventeenth
368 seventeen
369 18th
371 eighteenth
372 eighteen
373 19th
375 nineteenth
376 nineteen
377 20th
379 twentieth
380 twenty
381 21st
384 twenty-first
385 twenty-one
386 22nd
388 twenty-second
389 twenty-two
390 23rd
392 twenty-third
393 twenty-three
394 24th
396 twenty-fourth
397 twenty-four
398 25th
400 twenty-fifth
401 twenty-five
402 26th
404 twenty-sixth
405 twenty-six
406 27th
408 twenty-seventh
409 twenty-seven
410 28th
412 twenty-eighth
413 twenty-eight
414 29th
416 twenty-ninth
417 twenty-nine
418 30th
420 thirtieth
421 thirty
422 31st
425 thirty-first
426 thirty-one
427 32nd
429 thirty-two
430 thirty-second
431 33rd
433 thirty-three
434 thirty-third
435 34th
437 thirty-four
438 thirty-fourth
439 35th
441 thirty-five
442 thirty-fifth
443 36th
445 thirty-six
446 thirty-sixth
447 37th
449 thirty-seven
450 thirty-seventh
451 38th
453 thirty-eight
454 thirty-eighth
455 39th
457 thirty-nine
458 thirty-ninth
459 40th
461 forty
462 fortieth
463 41st
466 forty-one
467 forty-first
468 42nd
470 forty-two
471 forty-second
472 43rd
474 forty-three
475 forty-third
476 44th
478 forty-four
479 forty-fourth
480 45th
482 forty-five
483 forty-fifth
484 46th
486 forty-six
487 forty-sixth
488 47th
490 forty-seven
491 forty-seventh
492 48th
494 forty-eight
495 forty-eighth
496 49th
498 forty-nine
499 forty-ninth
500 50th
502 fifty
503 fiftieth
504 51st
507 fifty-one
508 fifty-first
509 52nd
511 fifty-two
512 fifty-second
513 53rd
515 fifty-three
516 fifty-third
517 Ignored words
519 In writing out dates in common forms, there are a number of words
520 that are typically not important.
521 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 December 3 at 12:00
527 The following words may be used:
529 at
531 Another word is used to designate one member of a set. In English,
533 you would use the words IN or OF:
534 1st day OF December
536 1st day IN December
537 The following words may be used:
539 of
541 in
542 Another word is use to specify that something is on a certain date.
544 In English, you would use ON:
545 ON July 5th
547 The following words may be used:
549 on
551 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 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 The following words may be used:
563 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 Words that set only the time of day are similar to the English
571 words 'noon' or 'midnight'.
572 The following words may be used:
574 midnight 00:00:00
576 noon 12:00:00
577 Words that set the entire time and date (relative to the current
579 time and date) are also available.
580 In English, the word 'now' is one of these.
582 The following words may be used:
584 now 0:0:0:0:0:0:0
586 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 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 : :
596 h :
597 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 A pair of colons is ALWAYS allowed for all languages. If a
605 language allows additional pairs, they are listed here:
606 Not defined in this language
608 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 The decimal point is ALWAYS allowed for all languages. If a
616 language allows another separator, it is listed here:
617 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)
636perl v5.36.0 2023-03-08 Date::Manip::Lang::english(3)