Relative Time Queries

[montymxb]

Following #4289 in parse-server, this brings in relative time queries as an additional sorting mechanism. Queries can now be modified to sort via relative time as follows.

// relative queries either start with 'in' or end in 'ago'
// but not both!

...
// less than 1 day ago
$query->lessThanRelativeTime('createdAt', '1 day ago');

...
// greater than 7 days and 30 minutes ago
$query->greaterThanRelativeTime('updatedAt', '7 days 30 minutes ago');

...
// less than or equal to 14 days in the future
$query->lessThanOrEqualToRelativeTime('date', 'in 14 days');

...
// greater than or equal to 5 days, 6 hrs, 14 mins & 30 seconds in the future
$query->greaterThanOrEqualToRelativeTime(
    'purchase_date', 
    'in 5 days 6 hrs 14 mins 30 secs'
);

...
// get stuff from the last 2 weeks
$query->greaterThanEqualToRelativeTime(
    'date',
    '14 days ago'
);
$query->lessThanEqualToRelativeTime(
    'date',
    '0 days ago'
);

/* 
Units are as follows:

-day
-days

-hours
-hour
-hrs
-hr

-minutes
-minute
-mins
-min

-seconds
-second
-secs
-sec
*/

I plan on putting in some support for a singular now string for ease of dictating lessThan/greaterThan the current time. Please note that the times used are server times, and may be different from the current time or zone of your sdk. Take this into consideration, such as if your hosted service is running 8 hours ahead of your sdk for example.

This PR additionally updates package.json for testing purposes and adds package-lock.json into version control.

[codecov]

Codecov Report

Merging #360 into master will increase coverage by <.01%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##           master     #360      +/-   ##
==========================================
+ Coverage   98.93%   98.93%   +<.01%     
==========================================
  Files          35       35              
  Lines        3281     3301      +20     
==========================================
+ Hits         3246     3266      +20     
  Misses         35       35

Impacted Files	Coverage Δ
src/Parse/ParseQuery.php	99.39% <100%> (+0.03%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1964a4b...dc977fe. Read the comment docs.