# Copyright (c) 1996-2017 Sullivan Beck. All rights reserved.
# This program is free software; you can redistribute it and/or modify it
# under the same terms as Perl itself.
########################################################################
########################################################################
=pod
=encoding utf-8
=head1 NAME
Date::Manip::Lang::french - French language support.
=head1 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).
=head1 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.
=over 4
=item B<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:
janvier
février
fevrier
mars
avril
mai
juin
juillet
août
aout
septembre
octobre
novembre
décembre
decembre
The following abbreviations may be used:
jan
jan.
fév
fev
fev.
fév.
mar
mar.
avr
avr.
mai
mai.
juin
juin.
juil
juil.
août
aout
aout.
août.
sept
sept.
oct
oct.
nov
nov.
déc
dec
dec.
déc.
=item B<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:
lundi
mardi
mercredi
jeudi
vendredi
samedi
dimanche
The following abbreviations may be used:
lun
lun.
mar
mar.
mer
mer.
jeu
jeu.
ven
ven.
sam
sam.
dim
dim.
The following short (1-2 characters) abbreviations may be used:
l
ma
me
j
v
s
d
=item B<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:
annees
années
an
annee
ans
année
mois
m
semaine
semaines
sem
jours
j
jour
journee
journée
heures
h
heure
minutes
mn
min
minute
secondes
s
sec
seconde
=item B<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:
du matin
du soir
=item B<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:
chaque
tous les
toutes les
=item B<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:
suivant
suivante
prochain
prochaine
Previous occurrence:
precedent
précédent
precedente
précédente
derniere
dernière
Last occurrence:
dernier
=item B<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:
il y a
auparavant
dans le passé
plus tot
plus tôt
en
plus tard
dans l'avenir
a venir
à venir
dans
=item B<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:
exactement
approximativement
environ
The following words may be used to specify a business delta:
professionel
ouvrable
ouvrables
=item B<Numbers>
Numbers may be spelled out in a variety of ways. The following sets correspond
to the numbers from 1 to 53:
1er
1re
premier
un
2e
deux
deuxieme
deuxième
3e
trois
troisieme
troisième
4e
quatre
quatrieme
quatrième
5e
cinq
cinquieme
cinquième
6e
six
sixieme
sixième
7e
sept
septieme
septième
8e
huit
huitieme
huitième
9e
neuf
neuvieme
neuvième
10e
dix
dixieme
dixième
11e
onze
onzieme
onzième
12e
douze
douzieme
douzième
13e
treize
treizieme
treizième
14e
quatorze
quatorzieme
quatorzième
15e
quinze
quinzieme
quinzième
16e
seize
seizieme
seizième
17e
dix-sept
dix-septieme
dix-septième
18e
dix-huit
dix-huitieme
dix-huitième
19e
dix-neuf
dix-neuvieme
dix-neuvième
20e
vingt
vingtieme
vingtième
21e
vingt et un
vingt et unieme
vingt et unième
22e
vingt-deux
vingt-deuxieme
vingt-deuxième
23e
vingt-trois
vingt-troisieme
vingt-troisième
24e
vingt-quatre
vingt-quatrieme
vingt-quatrième
25e
vingt-cinq
vingt-cinquieme
vingt-cinquième
26e
vingt-six
vingt-sixieme
vingt-sixième
27e
vingt-sept
vingt-septieme
vingt-septième
28e
vingt-huit
vingt-huitieme
vingt-huitième
29e
vingt-neuf
vingt-neuvieme
vingt-neuvième
30e
trente
trentieme
trentième
31e
trente et un
trente et unieme
trente et unième
32e
trente-deux
trente-deuxieme
trente-deuxième
33e
trente-trois
trente-troisieme
trente-troisième
34e
trente-quatre
trente-quatrieme
trente-quatrième
35e
trente-cinq
trente-cinquieme
trente-cinquième
36e
trente-six
trente-sixieme
trente-sixième
37e
trente-sept
trente-septieme
trente-septième
38e
trente-huit
trente-huitieme
trente-huitième
39e
trente-neuf
trente-neuvieme
trente-neuvième
40e
quarante
quarantieme
quarantième
41e
quarante et un
quarante et unieme
quarante et unième
42e
quarante-deux
quarante-deuxieme
quarante-deuxième
43e
quarante-trois
quarante-troisieme
quarante-troisième
44e
quarante-quatre
quarante-quatrieme
quarante-quatrième
45e
quarante-cinq
quarante-cinquieme
quarante-cinquième
46e
quarante-six
quarante-sixieme
quarante-sixième
47e
quarante-sept
quarante-septieme
quarante-septième
48e
quarante-huit
quarante-huitieme
quarante-huitième
49e
quarante-neuf
quarante-neuvieme
quarante-neuvième
50e
cinquante
cinquantieme
cinquantième
51e
cinquante et un
cinquante et unieme
cinquante et unième
52e
cinquante-deux
cinquante-deuxieme
cinquante-deuxième
53e
cinquante-trois
cinquante-troisieme
cinquante-troisième
=item B<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:
a
à
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:
de
en
du
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:
sur
=item B<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:
aujourd'hui 0:0:0:0:0:0:0
aujourd’hui 0:0:0:0:0:0:0
demain +0:0:0:1:0:0:0
hier -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:
midi 12:00:00
minuit 00: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:
maintenant 0:0:0:0:0:0:0
=item B<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 ALWAY allowed for all languages. If a language allows
additional pairs, they are listed here:
h :
=item B<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
=back
=head1 KNOWN BUGS
None known.
=head1 BUGS AND QUESTIONS
Please refer to the L<Date::Manip::Problems> documentation for
information on submitting bug reports or questions to the author.
=head1 SEE ALSO
L<Date::Manip> - main module documentation
=head1 LICENSE
This script is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
=head1 AUTHOR
Sullivan Beck (sbeck@cpan.org)
=cut