Date::Manip::Lang::english

NAME

Date::Manip::Lang::english − English language support.

SYNOPSIS

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

LANGUAGE EXPRESSIONS

The following is a list of all language words and expressions used to write times and/or dates.

All strings are case insensitive.
Month names and abbreviations

When writing out the name of the month, several different variations may exist including full names and abbreviations.

The following month names may be used:

January
February
March
April
May
June
July
August
September
October
November
December

The following abbreviations may be used:

Jan
Jan.
Feb
Feb.
Mar
Mar.
Apr
Apr.
May
May.
Jun
Jun.
Jul
Jul.
Aug
Aug.
Sep
Sept
Sep.
Sept.
Oct
Oct.
Nov
Nov.
Dec
Dec.

Day names and abbreviations

When writing out the name of the day, several different variations may exist including full names and abbreviations.

The following day names may be used:

Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

The following abbreviations may be used:

Mon
Mon.
Tue
Tues
Tue.
Tues.
Wed
Wed.
Thu
Thur
Thu.
Thur.
Fri
Fri.
Sat
Sat.
Sun
Sun.

The following short (1−2 characters) abbreviations may be used:

M
T
W
Th
F
Sa
S

Delta field names

These are the names (and abbreviations) for the fields in a delta. There are 7 fields: years, months, weeks, days, hours, minutes, seconds.

The names and abbreviations for these fields are:

years
y
yr
year
yrs
months
m
mon
month
mons
weeks
w
wk
wks
week
days
d
day
hours
h
hr
hrs
hour
minutes
mn
min
minute
mins
seconds
s
sec
second
secs

Morning/afternoon times

This is a list of expressions use to designate morning or afternoon time when a time is entered as a 12−hour time rather than a 24−hour time. For example, in English, the time "17:00" could be specified as "5:00 PM".

Morning and afternoon time may be designated by the following sets of words:

AM
A.M.
PM
P.M.

Each or every

There are a list of words that specify every occurrence of something. These are used in the following phrases:

EACH Monday
EVERY Monday
EVERY month

The following words may be used:

each
every

Next/Previous/Last occurrence

There are a list of words that may be used to specify the next, previous, or last occurrence of something. These words could be used in the following phrases:

NEXT week
LAST Tuesday
PREVIOUS Tuesday
LAST day of the month

The following words may be used:

Next occurrence:

next
following

Previous occurrence:

previous
last

Last occurrence:

last
final

Delta words for going forward/backward in time

When parsing deltas, there are words that may be used to specify the the delta will refer to a time in the future or to a time in the past (relative to some date). In English, for example, you might say:

IN 5 days
5 days AGO

The following words may be used to specify deltas that refer to dates in the past or future respectively:

ago
past
in the past
earlier
before now
in
later
future
in the future
from now

Business mode

This contains two lists of words which can be used to specify a standard (i.e. non-business) delta or a business delta.

Previously, it was used to tell whether the delta was approximate or exact, but now this list is not used except to force the delta to be standard.

The following words may be used:

exactly
approximately

The following words may be used to specify a business delta:

business

Numbers

Numbers may be spelled out in a variety of ways. The following sets correspond to the numbers from 1 to 53:

1st
first
one
2nd
second
two
3rd
third
three
4th
fourth
four
5th
fifth
five
6th
sixth
six
7th
seventh
seven
8th
eighth
eight
9th
ninth
nine
10th
tenth
ten
11th
eleventh
eleven
12th
twelfth
twelve
13th
thirteenth
thirteen
14th
fourteenth
fourteen
15th
fifteenth
fifteen
16th
sixteenth
sixteen
17th
seventeenth
seventeen
18th
eighteenth
eighteen
19th
nineteenth
nineteen
20th
twentieth
twenty
21st
twenty−first
twenty−one
22nd
twenty−second
twenty−two
23rd
twenty−third
twenty−three
24th
twenty−fourth
twenty−four
25th
twenty−fifth
twenty−five
26th
twenty−sixth
twenty−six
27th
twenty−seventh
twenty−seven
28th
twenty−eighth
twenty−eight
29th
twenty−ninth
twenty−nine
30th
thirtieth
thirty
31st
thirty−first
thirty−one
32nd
thirty−two
thirty−second
33rd
thirty−three
thirty−third
34th
thirty−four
thirty−fourth
35th
thirty−five
thirty−fifth
36th
thirty−six
thirty−sixth
37th
thirty−seven
thirty−seventh
38th
thirty−eight
thirty−eighth
39th
thirty−nine
thirty−ninth
40th
forty
fortieth
41st
forty−one
forty−first
42nd
forty−two
forty−second
43rd
forty−three
forty−third
44th
forty−four
forty−fourth
45th
forty−five
forty−fifth
46th
forty−six
forty−sixth
47th
forty−seven
forty−seventh
48th
forty−eight
forty−eighth
49th
forty−nine
forty−ninth
50th
fifty
fiftieth
51st
fifty−one
fifty−first
52nd
fifty−two
fifty−second
53rd
fifty−three
fifty−third

Ignored words

In writing out dates in common forms, there are a number of words that are typically not important.

There is frequently a word that appears in a phrase to designate that a time is going to be specified next. In English, you would use the word AT in the example:

December 3 at 12:00

The following words may be used:

at

Another word is used to designate one member of a set. In English, you would use the words IN or OF:

1st day OF December
1st day IN December

The following words may be used:

of
in

Another word is use to specify that something is on a certain date. In English, you would use ON:

ON July 5th

The following words may be used:

on

Words that set the date, time, or both

There are some words that can be used to specify a date, a time, or both relative to now.

Words that set the date are similar to the English words ’yesterday’ or ’tomorrow’. These are specified as a delta which is added to the current time to get a date. The time is NOT set however, so the delta is only partially used (it should only include year, month, week, and day fields).

The following words may be used:

ereyesterday −0:0:0:2:0:0:0
overmorrow +0:0:0:2:0:0:0
today 0:0:0:0:0:0:0
tomorrow +0:0:0:1:0:0:0
yesterday −0:0:0:1:0:0:0

Words that set only the time of day are similar to the English words ’noon’ or ’midnight’.

The following words may be used:

midnight 00:00:00
noon 12:00:00

Words that set the entire time and date (relative to the current time and date) are also available.

In English, the word ’now’ is one of these.

The following words may be used:

now 0:0:0:0:0:0:0

Hour/Minute/Second separators

When specifying the time of day, the most common separator is a colon (:) which can be used for both separators.

Some languages use different pairs. For example, French allows you to specify the time as 13h30:20, so it would use the following pairs:

: :
h :

The first column is the hour-minute separator and the second column is the minute-second separator. Both are perl regular expressions. When creating a new translation, be aware that regular expressions with utf−8 characters may be tricky. For example, don’t include the expression ’[x]’ where ’x’ is a utf−8 character.

A pair of colons is ALWAYS allowed for all languages. If a language allows additional pairs, they are listed here:

Not defined in this language

Fractional second separator

When specifying fractional seconds, the most common way is to use a decimal point (.). Some languages may specify a different separator that might be used. If this is done, it is a regular expression.

The decimal point is ALWAYS allowed for all languages. If a language allows another separator, it is listed here:

Not defined in this language

KNOWN BUGS

None known.

BUGS AND QUESTIONS

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

SEE ALSO

Date::Manip − main module documentation

LICENSE

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

AUTHOR

Sullivan Beck (sbeck@cpan.org)