DateFormatCSVs
A list of date formats that IDOL Server must be able to read from documents. Separate multiple date formats with commas. There must be no space before or after a comma.
You can use the following values:
-
AUTNDATE
. The IDOL date format (1 to a maximum of 10 digits). This format covers the epoch range (1 January 1970 to 19 January 2038) to a resolution of one second, and dates between 30 October 1093 BC and 26 October 3058 to a resolution of one minute. Dates outside this range are stored with values that allow IDOL Server to sort them correctly. You can convert another date to itsAUTNDATE
representation by using the DateConvert action.NOTE: Micro Focus recommends that you use one of the verbose date formats if you want to use dates outside the normal epoch.
-
#ISODATETIME
. An ISO-8601 date, optionally with a time. This format accepts the formatYYYY-MM-DDTHH:NN:SS.FFFFZ
.YYYY-MM-DD
is always required, but this format also accepts the following variations:- The year can have a plus (+) or minus (-) sign at the start. A plus sign (+) represents AD/CE years, and a minus sign (-) represents BC/BCE years.
- The time is optional, and can be to hour, minute, second, or fractional section precision.
- The date and time can be separated by a
T
or a space, or you can omit the separator between date and time. If you use theT
separator, it must have a valid time after it. - The time zone is optional. If you include a time zone, you can use
Z
,±HH
,±HHMM
, or±HH:MM
. - You can omit the separators in both the date and time (that is,
YYYYMMDDHHMMSS
, but notYYYYMMDDHH:MM:SS
orYYYY-MM-DDHHMMSS
).
-
a string that contains one or more of the date formats in the following table.
YY
Year (two digits). For example, 99, 00, 01, and so on. YYYY
Year (four digits). For example, 1999, 2000, 2001, and so on. #YY+
Year (two or four digits). If you provide two digits, it uses the
YY
format. If you provide four digits, it uses theYYYY
format.For example, it interprets
07
as2007 AD
and1007
as1007 AD
.#Y
Year (one to a maximum of 16 digits), optionally followed by AD
orBC
. An apostrophe ('
) immediately before the year denotes a truncated year. For example,2008
,'97
(interpreted as1997
),97
(interpreted as97 AD
),'08
(interpreted as2008
),2008 AD
, and200 BC
. A truncated year with a BC identifier is not valid ('08 BC
).#FULLYEAR
Year (one to a maximum of 16 digits). For example, 8
,98
,108
,2008
, each of which is taken literally. The year is taken relative to the common EPOCH (0 AD).#ADBC
Time period. For example,
AD
,CE
,BC
,BCE
, or any predefined list of EPOCH indicators. Typically, the year specified in the above formats is interpreted as untruncated and relative to the EPOCH. For example, 84 AD is interpreted as 1984 AD, and 84 BC is interpreted as 84 BC.The only exception to this is when you use both
#YY+
and#ADBC
. In this case, the format is interpreted as untruncated, even if the year was set to truncated by#YY+
. For example, 99 AD is interpreted as the year 99 AD.Micro Focus recommends that you use only
YY
,YYYY
, or#FULLYEAR
with#ADBC
.LONGMONTH
A long month, for example, January
,February
, and so on.SHORTMONTH
A short month, for example, Jan
,Feb
, and so on.MM
Month (two digits). For example, 01
,10
,12
, and so on.M+
Month (one or two digits). For example, 1
,2
,3
,10
, and so on.DD
Day (two digits). For example, 01
,02
,03
,12
,23
, and so on.D+
Day (one or two digits). For example, 1
,2
,12
,13
,31
, and so on.LONGDAY
Two digits with a postfix. For example, 1st
,2nd
, and so on.HH
Hour (two digits). For example, 01
,12
,13
, and so on.H+
Hour (one or two digits). NN
Minute (two digits). N+
Minute (one or two digits). SS
Second (two digits). S+
Second (one or two digits). ZZZ
Time zone, for example, GMT
,EST
,PST
, and so on.ZZZZZ
Time difference (one to nine digits). For example, +04
denotes four hours ahead of UTC. Other examples include+4
,+04
,+0400
,+0400 MSD
(the stringMSD
is ignored). A further example is+030
. In this case the time difference is interpreted as 30 minutes.
This option accepts a singleZ
character in a date string as UTC. It accepts time zones between-1300
and+1500
.#PM
An AM
orPM
indicator (two characters). For example,2001/09/09 02:46:40 PM
.#S
A space.
Notes
-
Specify formats in order of length (starting with the longest). IDOL Server matches format strings in the order in which you list them. If you list a shorter format first, IDOL Server might match against an incorrect format, for example, matching
19/10/2002
asDD/MM/YY
and indexing the document with the date19/10/20
. -
Separate multiple formats with commas. There must be no space before or after a comma. To specify a format that contains a space, put the format in quotation marks.
-
When the document field contains a partial date, IDOL Server assigns the document a metadata field with a full date.
-
If the day is not specified, the date is the first day of the specified month.
-
If neither the day or month are specified, the date is the first of January in the specified year.
-
Partial dates are indexed only if they are listed in DateFormatCSVs
.
Type: | String |
Default: | YYYY/MM/DD
|
Required: | No |
Configuration Section: | Server |
Example: | DateFormatCSVs=D+/SHORTMONTH/YYYY,DDMMYY
In this example, only document dates with the format D+/SHORTMONTH/YYYY (for example, 2/Jan/2001 ) or DDMMYY (for example, 020101 ) can be indexed with a date.DateFormatCSVs="D+SHORTMONTH YYYY","Date: D+ LONGMONTH, YYYY" In this example, only document dates with the format D+ SHORTMONTH YYYY (for example, 2 Jan 2001 ) or Date: D+ LONGMONTH, YYYY (for example, Date: 2 January, 2001 ) can be indexed with a date.DateFormatCSVs=LONGMONTH/D+/#Y H+:N+:S+ In this example, only document dates with the format LONGMONTH/D+/#Y H+:N+:S+ (for example, September/9/2001 AD 2:46:40 or September/9/2001 2:46:40 or September/9/'01 2:46:40 or September/9/'01 AD 2:46:40 ) can be indexed with a date.DateFormatCSVs=LONGMONTH/D+/#FULLYEAR #ADBC H+:N+:S+ In this example, only document dates with the format LONGMONTH/D+/#FULLYEAR #ADBC H+:N+:S+ (for example, September/9/8 AD 2:46:40 or September/9/2008 AD 2:46:40 or September/9/'01 2:46:40 or September/9/'01 AD 2:46:40 ) can be indexed with a date.DateFormatCSVs=D+ LONGMONTH YYYY HH:NN:SS ZZZZZ In this example, only document dates with the format D+ LONGMONTH YYYY HH:NN:SS ZZZZZ (for example, 17 May 2003 10:41:07 -0400 ) can be indexed with a date. |
See Also: |