PubMan Func Spec Date Search

Basic Rules

• the start date always ...

has to be sooner than or

has to be equal in time to

... the end date.

=> start date ≤ end date

• the end date always ...

has to be later than or

has to be equal in time to

the start date.

=> end date ≥ start date

• when the user is searching for time ranges ...

the start date is always the minimum and

the end date is always the maximum

... of the time range.

=> start date {minumum} ≤ set of search results ≤ end date {maximum}

Automatic Serializations

That paragraph describes how date entries which are made by PubMan users should always be handled on technical level.

Start Date

• if the start date is given in format YYYY
  • it should always be handled as YYYY-01-01

• the search results should contain items which comprise dates in format YYYY as well as dates in format YYYY-MM as well as dates in format YYYY-MM-DD

• if the start date is given in format YYYY-MM
  • it should always be handled as YYYY-MM-01

• the search result should contain items which comprise dates in format YYYY-MM as well as dates in format YYYY-MM-DD

• if the start date is given in format YYYY-MM-DD
  • it should always be handled as YYYY-MM-DD

• the search results should contain items which comprise dates in format YYYY-MM-DD

End Date

• if the end date is given in format YYYY
  • it should always be handled as YYYY-12-31

• the search results should contain items which comprise dates in format YYYY as well as dates in format YYYY-MM as well as dates in format YYYY-MM-DD

• if start date is given in format YYYY-MM
  • it should always be handled as YYYY-MM-31

• the search result should contain items which comprise dates in format YYYY-MM as well as dates in format YYYY-MM-DD

• if the start date is given in format YYYY-MM-DD
  • it should always be handled as YYYY-MM-DD

• the search results should contain items which comprise dates in format YYYY-MM-DD

Search Query Types

For all search query types the previously specified automatic serializations are true.

Search for a Time Range

1st example:

• the user wants to search for a time range
• the users entries for example:
  • 2005 as start date
  • 2007 as end date
• the search result should contain items which comprises dates from 2005-01-01 (minimum) until 2007-12-31 (maximum)
• the dates within the items could either be in format YYYY or YYYY-MM or YYYY-MM-DD

2nd example:

• the user wants to query all publication of one year
• the user entries for example:
  • 2009 as start date
  • 2009 as end date
• the search result should contain all items of the respective year (publications from 2009-01-01 until 2009-12-31) which comprise dates either in format YYYY or YYYY-MM or YYYY-MM-DD

Search for a specific Date

example:

• the user searches for a specific date
• the enters for example:
  • 2009-08-18 as start date
  • 2009-08-18 as end date
• the search result should contain all items with the exact date 2009-08-18

Search only in Start Date

example:

• the user enters a date only in the field for the start date
• the user enters for example:
• 2005-02-17 as start date
• the search result should contain all items which comprise a date of minimum 2005-02-17 and a maximum date, which is the recent date of all publications (= all stored publications with a date since 2005-02-17)

Comment

• I will list and explain all search query types for dates with an example in the PubMan help; so the user is able to understand what search result has to be expected.

Publication Management