[ROOT] / doc / toc / ARCQuery / Class / ValueComparerDateTime
EndPeriod , InitValue , IsAfter , IsBefore , IsGliding , IsInterval , Resolution , StartPeriod , Steps , ToDebugProperties , TryGetNext , TryGetPrevious , TryParse
ValueComparerDateTime is an attempt at offering a human language interface for date and time queries.
This class understands such terms as Today, BeforeYesterday, LastTwoDays, Last6Months, ThisYear, LastYear and so on.
Enables queries like 'Order/WHERE Created = ThisMonth', that is, a query where you do not have to change the condition of the query expression as time passes.
Understood by QueryExpressionWhere.
Terms like Ago and In means that specific period. For instance on Thursday TwoDaysAgo means Tuesday (only) while InTwoDays means Saturday (only).
Terms like Last and Next means an interval (until today or from today). For instance on Thursday LastTwoDays means Tuesday and Wednesday while NextTwoDays means Friday and Saturday.
(see IsInterval.)
See also IsAfter, IsBefore, IsGliding.
NOTE: As soon as an instance of ValueComparerDateTime is created in C#,
NOTE: it has a limited usefulness as time passes because the
NOTE: time of initialization decides the time range (StartPeriod / EndPeriod) that it compares against.
NOTE: For instance, at time 09:59 NextHour would mean 10:00 to 11:00, but the same object used later
NOTE: at 10:01 for instance would still compare against 10:00 to to 11:00.
NOTE: In other words, these object instances are time-limited and for one-time-use only.
| EndPeriod | The end of the interval which this instance compares against. |
| InitValue | For debugging purposes. The initial 'now' value used before calculating StartPeriod and EndPeriod. |
| IsAfter | The modifier 'After' can be prepended in order to mean any time after the specified time. |
| IsBefore | The modifier 'Before' can be prepended in order to mean from any time before the specified time. |
| IsGliding | The modifier 'Gliding' (or just 'G') can be appended in order to mean continous gliding periode, so for instance |
| IsInterval | Normally the interval which is compared against is the timespan corresponding to Resolution. |
| Resolution | See -ResolutionEnum-. |
| StartPeriod | The start of the interval which this instance compares against. |
| Steps | Value 0 would mean 'This', like ThisHour, Today, ThisMonth and so on. |
| ToDebugProperties | Exposes all members of this class. |
| TryGetNext | Suggestion for next query (browsing 'forwards') |
| TryGetPrevious | Suggestion for previous query (browsing 'backwards') |
| TryParse | Note: This parser is probably exhaustive but not necessarily logical |
Generated 2024-11-14 04:18:45.234 UTC