Queries are parts of /groupchat deletehistory and /groupchat history commands allowing for more precise messages selection.
When using them with /groupchat deletehistory command, we enter whole query as first argument after command name. When using them with /groupchat history command, we need to add -query (or -q) as first argument of command and then insert our query as second argument.

There are 6 keywords we use when looking for messages.
BEFORE, AFTER, SINCE, TO, RANGE – keywords used with dates
ALL – keyword matching all existing messages – depending on our choice, these may be all messages stored on server, all messages of given player or all messages with player and selected group

BEFORE keyword matches messages sent before given datetime.
AFTER keyword matches messages sent after given datetime.
SINCE keyword matches messages sent since given datetime (including it).
TO keyword matches messages sent to given datetime (including it).
RANGE keyword matches messages sent in range of two datetimes (including them).

Query construction:

Queries without target player/groupchat included

• „ALL” – all messages on server
• „BEFORE [datetime]” / „AFTER [datetime]” / „SINCE [datetime]” / „TO [datetime]” / „RANGE [datetime1] [datetime2]” – messages matching datetime criteria
• „[ID]” – matches message with given ID
• „[ID,ID₂,ID₃…]” – matches messages with given ID’s

Examples in commands
/groupchat history -q ALL – show history of all messages
/groupchat history -q RANGE 10.10.2020 10.12.2020 – show history of all messages sent from 10.10.2020 to 10.12.2020 inclusive
/groupchat deletehistory BEFORE 10.10.2020 – delete all messages sent before 10.10.2020
/groupchat deletehistory 214 – delete message with ID 214
/groupchat deletehistory 3,9,12 – delete messages with ID of 3,9 and 12

Queries with target player/groupchat included

• „[playername] ALL” – all messages of player
• „[playername],[groupname] ALL” – all messages sent by player on selected groupchat
• „[playername] BEFORE [datetime]” / „[playername] AFTER [datetime]” / „[playername] SINCE [datetime]” / „[playername] TO [datetime]” / „[playername] RANGE [datetime1] [datetime2]” – messages of player matching datetime criteria
• „[playername],[groupname] BEFORE [datetime]” / „[playername],[groupname] AFTER [datetime]” / „[playername],[groupname] SINCE [datetime]” / „[playername],[groupname] TO [datetime]” / „[playername],[groupname] RANGE [datetime1] [datetime2]” – messages sent by player on selected groupchat matching datetime criteria

Examples in commands
/groupchat history -q Jack ALL – show history of all messages with player Jack
/groupchat history -q John,superparty RANGE 10.10.2020 10.12.2020 – show history of all messages sent by player John on groupchat superparty from 10.10.2020 to 10.12.2020 inclusive
/groupchat deletehistory Notch BEFORE 10.10.2020 – delete all messages of player Notch sent before 10.10.2020
/groupchat deletehistory Steve,friends AFTER 04.30.2022-11:34 – delete all messages of player Steve sent on groupchat friends after 04.30.2022 11:34

Datetime format
By default, it’s possible to pass date and time in following format:

• MM.dd.yyyy
• MM.dd.yyyy-HH:mm
• MM.dd.yyyy-HH:mm:ss

Accepted formats are controlled by InCommandDateTimeFormat setting in config.yml.