Therefore Programming Interface 3.0

Zoom Window Out
Larger Text | Smaller Text
Hide Page Header
Show Expanding Text
Printable Version
Save Permalink URL

Therefore API > API Reference > Classes > TheCondition > Properties

Condition

Gets or sets the condition string.

Namespace: Therefore.API

Condition strings can contain any value or operator valid for the associated field's type. Values 0-9 are valid for Currency and Number type fields, any alphanumeric text string for Text types, any date (in the local PC's date format) for Date fields or all valid keywords for keyword fields. The format used for decimal numbers (. or ,) and Date (mm/dd/yy, dd/mm/yy etc) are dependent on the local PC's (Windows O/S) default setting.

Operator	Description
And	Hits are generated only if both search terms are found
Or	Hits are generated if either of two search terms are found
To	Hits are generated for a range of values (e.g. 100 To 110, ab* To am*)
Empty	Hits are generated only for documents where this Index field is 'blank' (typically, this means 'not yet used' - for example 'Leaving Date' (when not yet left) or 'Final Cost' (when not yet finalized). Note that a 'mandatory' field can never be empty.
<	Hits are generated when 'less than' the entered value (e.g. < 10)
>	Hits are generated when 'greater than' the entered value (e.g. > 10)
<=	Hits 'less than or equal to' the entered value
>=	Hits 'greater than or equal to' the entered value
*	The standard 'wildcard' function, valid for Text (or Keyword) data types only. e.g. for 'a*' (in a keywords field), Hits all Documents containing any keyword that starts with the letter 'a'.
Today	Hits are generated for documents containing "today's date" (the current date shown by the Server). Valid only for Date type fields.

Functions can be combined to form complex search expressions.

For example:

">4711 AND <=5607" searches for index data 'greater than' 4711 and 'smaller than or equal to' 5607.

">=4711 OR 2303" searches for index data 'greater than or equal to' 4711 or (equal to) 2303.

UTC and time zones

By default all date and time values are considered to be in UTC, except it is specified otherwise by the IsUTC property or the bIsUTC parameter in TheConditionList.Add method overloads.

If IsUTC is false, the time zone specified in TheCultureInfo.TimeZoneInfoID returned by TheServer.GetCultureInfo is used for UTC conversion internally. If no culture info has been set, the time zone of the current user context will be used.