.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DateTime::Format::Natural::Lang::EN 3pm"
.TH DateTime::Format::Natural::Lang::EN 3pm "2023-10-26" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
DateTime::Format::Natural::Lang::EN \- English language metadata
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`DateTime::Format::Natural::Lang::EN\*(C'\fR provides the english specific grammar
and variables. This class is loaded if the user either specifies the english
language or implicitly.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
Below are some examples of natural language date/time input in english (be aware
that the parser does usually not distinguish between lower/upper case; furthermore,
many expressions allow for additional leading/trailing time and all times are
also parsable with precision in (milli)seconds):
.SS "Simple"
.IX Subsection "Simple"
.Vb 10
\& now
\& yesterday
\& today
\& tomorrow
\& morning
\& afternoon
\& evening
\& noon
\& midnight
\& yesterday at noon
\& yesterday at midnight
\& today at noon
\& today at midnight
\& tomorrow at noon
\& tomorrow at midnight
\& this morning
\& this afternoon
\& this evening
\& yesterday morning
\& yesterday afternoon
\& yesterday evening
\& today morning
\& today afternoon
\& today evening
\& tomorrow morning
\& tomorrow afternoon
\& tomorrow evening
\& thursday morning
\& thursday afternoon
\& thursday evening
\& 6:00 yesterday
\& 6:00 today
\& 6:00 tomorrow
\& 5am yesterday
\& 5am today
\& 5am tomorrow
\& 4pm yesterday
\& 4pm today
\& 4pm tomorrow
\& last millisecond
\& this millisecond
\& next millisecond
\& last second
\& this second
\& next second
\& last minute
\& this minute
\& next minute
\& last hour
\& this hour
\& next hour
\& last day
\& this day
\& next day
\& last week
\& this week
\& next week
\& last month
\& this month
\& next month
\& last quarter
\& this quarter
\& next quarter
\& last year
\& this year
\& next year
\& last friday
\& this friday
\& next friday
\& tuesday last week
\& tuesday this week
\& tuesday next week
\& last week wednesday
\& this week wednesday
\& next week wednesday
\& 10 milliseconds ago
\& 10 seconds ago
\& 10 minutes ago
\& 10 hours ago
\& 10 days ago
\& 10 weeks ago
\& 10 months ago
\& 10 years ago
\& in 5 milliseconds
\& in 5 seconds
\& in 5 minutes
\& in 5 hours
\& in 5 days
\& in 5 weeks
\& in 5 months
\& in 5 years
\& saturday
\& sunday 11:00
\& yesterday at 4:00
\& today at 4:00
\& tomorrow at 4:00
\& yesterday at 6:45am
\& today at 6:45am
\& tomorrow at 6:45am
\& yesterday at 6:45pm
\& today at 6:45pm
\& tomorrow at 6:45pm
\& yesterday at 2:32 AM
\& today at 2:32 AM
\& tomorrow at 2:32 AM
\& yesterday at 2:32 PM
\& today at 2:32 PM
\& tomorrow at 2:32 PM
\& yesterday 02:32
\& today 02:32
\& tomorrow 02:32
\& yesterday 2:32am
\& today 2:32am
\& tomorrow 2:32am
\& yesterday 2:32pm
\& today 2:32pm
\& tomorrow 2:32pm
\& wednesday at 14:30
\& wednesday at 02:30am
\& wednesday at 02:30pm
\& wednesday 14:30
\& wednesday 02:30am
\& wednesday 02:30pm
\& friday 03:00 am
\& friday 03:00 pm
\& sunday at 05:00 am
\& sunday at 05:00 pm
\& 2nd monday
\& 100th day
\& 4th february
\& november 3rd
\& last june
\& next october
\& 6 am
\& 5am
\& 5:30am
\& 8 pm
\& 4pm
\& 4:20pm
\& 06:56:06 am
\& 06:56:06 pm
\& mon 2:35
\& 1:00 sun
\& 1am sun
\& 1pm sun
\& 1:00 on sun
\& 1am on sun
\& 1pm on sun
\& 12:14 PM
\& 12:14 AM
.Ve
.SS "Complex"
.IX Subsection "Complex"
.Vb 10
\& yesterday 7 milliseconds ago
\& yesterday 7 seconds ago
\& yesterday 7 minutes ago
\& yesterday 7 hours ago
\& yesterday 7 days ago
\& yesterday 7 weeks ago
\& yesterday 7 months ago
\& yesterday 7 years ago
\& today 5 milliseconds ago
\& today 5 seconds ago
\& today 5 minutes ago
\& today 5 hours ago
\& today 5 days ago
\& today 5 weeks ago
\& today 5 months ago
\& today 5 years ago
\& tomorrow 3 milliseconds ago
\& tomorrow 3 seconds ago
\& tomorrow 3 minutes ago
\& tomorrow 3 hours ago
\& tomorrow 3 days ago
\& tomorrow 3 weeks ago
\& tomorrow 3 months ago
\& tomorrow 3 years ago
\& 2 milliseconds before now
\& 2 seconds before now
\& 2 minutes before now
\& 2 hours before now
\& 2 days before now
\& 2 weeks before now
\& 2 months before now
\& 2 years before now
\& 4 milliseconds from now
\& 4 seconds from now
\& 4 minutes from now
\& 4 hours from now
\& 4 days from now
\& 4 weeks from now
\& 4 months from now
\& 4 years from now
\& 6 in the morning
\& 4 in the afternoon
\& 9 in the evening
\& monday 6 in the morning
\& monday 4 in the afternoon
\& monday 9 in the evening
\& last sunday at 21:45
\& monday last week
\& 6th day last week
\& 6th day this week
\& 6th day next week
\& 12th day last month
\& 12th day this month
\& 12th day next month
\& 1st day last year
\& 1st day this year
\& 1st day next year
\& 1st tuesday last november
\& 1st tuesday this november
\& 1st tuesday next november
\& 11 january next year
\& 11 january this year
\& 11 january last year
\& 6 milliseconds before yesterday
\& 6 seconds before yesterday
\& 6 minutes before yesterday
\& 6 hours before yesterday
\& 6 milliseconds before today
\& 6 seconds before today
\& 6 minutes before today
\& 6 hours before today
\& 6 milliseconds before tomorrow
\& 6 seconds before tomorrow
\& 6 minutes before tomorrow
\& 6 hours before tomorrow
\& 3 milliseconds after yesterday
\& 3 seconds after yesterday
\& 3 minutes after yesterday
\& 3 hours after yesterday
\& 3 milliseconds after today
\& 3 seconds after today
\& 3 minutes after today
\& 3 hours after today
\& 3 milliseconds after tomorrow
\& 3 seconds after tomorrow
\& 3 minutes after tomorrow
\& 3 hours after tomorrow
\& 10 milliseconds before noon
\& 10 seconds before noon
\& 10 minutes before noon
\& 10 hours before noon
\& 10 milliseconds before midnight
\& 10 seconds before midnight
\& 10 minutes before midnight
\& 10 hours before midnight
\& 5 milliseconds after noon
\& 5 seconds after noon
\& 5 minutes after noon
\& 5 hours after noon
\& 5 milliseconds after midnight
\& 5 seconds after midnight
\& 5 minutes after midnight
\& 5 hours after midnight
\& noon last friday
\& midnight last friday
\& noon this friday
\& midnight this friday
\& noon next friday
\& midnight next friday
\& last friday at 20:00
\& this friday at 20:00
\& next friday at 20:00
\& 1:00 last friday
\& 1:00 this friday
\& 1:00 next friday
\& 1am last friday
\& 1am this friday
\& 1am next friday
\& 1pm last friday
\& 1pm this friday
\& 1pm next friday
\& 5 am last monday
\& 5 am this monday
\& 5 am next monday
\& 5 pm last monday
\& 5 pm this monday
\& 5 pm next monday
\& last wednesday 7am
\& this wednesday 7am
\& next wednesday 7am
\& last wednesday 7pm
\& this wednesday 7pm
\& next wednesday 7pm
\& last tuesday 11 am
\& this tuesday 11 am
\& next tuesday 11 am
\& last tuesday 11 pm
\& this tuesday 11 pm
\& next tuesday 11 pm
\& yesterday at 13:00
\& today at 13:00
\& tomorrow at 13
\& 2nd friday in august
\& 3rd wednesday in november
\& tomorrow 1 year ago
\& saturday 3 months ago at 17:00
\& saturday 3 months ago at 5:00am
\& saturday 3 months ago at 5:00pm
\& 11 january 2 years ago
\& 4th day last week
\& 8th month last year
\& 8th month this year
\& 8th month next year
\& 6 mondays from now
\& fri 3 months ago at 5am
\& wednesday 1 month ago at 8pm
\& final thursday in april
\& last thursday in april
\& beginning of last month
\& end of last month
.Ve
.SS "Timespans"
.IX Subsection "Timespans"
.Vb 10
\& monday to friday
\& 1 April to 31 August
\& 1999\-12\-31 to tomorrow
\& now to 2010\-01\-01
\& 2009\-03\-10 9:00 to 11:00
\& 26 oct 10:00 am to 11:00 am
\& jan 1 to 2
\& 16:00 nov 6 to 17:00
\& may 2nd to 5th
\& 100th day to 200th
\& 6am dec 5 to 7am
\& 30th to 31st dec
\& 30th to dec 31st
\& 21:00 to mar 3 22:00
\& 21:00 to 22:00 mar 3
\& 10th to 20th day
\& 1/3 to 2/3
\& 2/3 to in 1 week
\& 3/3 21:00 to in 5 days
\& first day of 2009 to last day of 2009
\& first day of may to last day of may
\& first to last day of 2008
\& first to last day of september
\& for 4 milliseconds
\& for 4 seconds
\& for 4 minutes
\& for 4 hours
\& for 4 days
\& for 4 weeks
\& for 4 months
\& for 4 years
.Ve
.SS "Specific"
.IX Subsection "Specific"
.Vb 10
\& march
\& january 11
\& 11 january
\& 18 oct 17:00
\& 18 oct 5am
\& 18 oct 5pm
\& 18 oct 5 am
\& 18 oct 5 pm
\& dec 25
\& feb 28 3:00
\& feb 28 3am
\& feb 28 3pm
\& feb 28 3 am
\& feb 28 3 pm
\& 19:00 jul 1
\& 7am jul 1
\& 7pm jul 1
\& 7 am jul 1
\& 7 pm jul 1
\& jan 24, 2011 12:00
\& jan 24, 2011 12am
\& jan 24, 2011 12pm
\& may 27th
\& 2005
\& march 1st 2009
\& October 2006
\& february 14, 2004
\& jan 3 2010
\& 3 jan 2000
\& 2010 october 28
\& 2011\-jan\-04
\& 27/5/1979
\& 1/3
\& 1/3 16:00
\& 3/1
\& 3/1 16:00
\& 4:00
\& 17:00
\& 3:20:00
\& \-5min
\& +2d
\& 20111018000000
\& 2016\-06\-19T12:12:11
.Ve
.SS "Aliases"
.IX Subsection "Aliases"
.Vb 10
\& 1 msec ago
\& 4 msecs ago
\& 1 sec ago
\& 10 secs ago
\& 1 min ago
\& 5 mins ago
\& 1 hr ago
\& 3 hrs ago
\& 1 yr ago
\& 7 yrs ago
\& yesterday @ noon
\& tues this week
\& final thurs in sep
\& tues
\& thurs
\& thur
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
DateTime::Format::Natural
.SH "AUTHOR"
.IX Header "AUTHOR"
Steven Schubiger <schubiger@cpan.org>
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you may redistribute it and/or
modify it under the same terms as Perl itself.
.PP
See <http://dev.perl.org/licenses/>