Merge pull request #7 from marcreichel/feat/strict-mode

Feat/strict mode

Author: marcreichel

README.md

@@ -83,6 +83,38 @@ Distances less than a minute are more detailed.
 <span x-data="{ date: new Date() }" x-timeago.seconds="date"></span>
 ```
 
+### Strict
+
+If you do not want the "about [diff]" or "less than [diff]" prefixes, you can use the `x-timeago.strict` modifier.
+
+```html
+<span x-data="{ date: new Date() }" x-timeago.strict="date"></span>
+```
+
+#### Strict options
+
+The strict mode comes with its own set of modifiers for controlling the output.
+
+##### Force unit
+
+Use the `x-timeago.strict.unit.[unit]` modifier with one of the following units to force the unit in the output.
+
+- `second` (e.g. `x-timeago.strict.unit.second`)
+- `minute` (e.g. `x-timeago.strict.unit.minute`)
+- `hour` (e.g. `x-timeago.strict.unit.hour`)
+- `day` (e.g. `x-timeago.strict.unit.day`)
+- `month` (e.g. `x-timeago.strict.unit.month`)
+- `year` (e.g. `x-timeago.strict.unit.year`)
+
+##### Adjust rounding method
+
+By default, the values are rounded using the `Math.round` algorithm. If you would like to adjust this, use
+the `x-timeago.rounding.[method]` modifier with one of the following methods:
+
+- `floor` (e.g. `x-timeago.strict.rounding.floor`)
+- `ceil` (e.g. `x-timeago.strict.rounding.ceil`)
+- `floor` (e.g. `x-timeago.strict.rounding.round`)
+
 ### Magic function
 
 As of version 1.3.0 of this package a `$timeago` magic function is included which will return the human-readable
@@ -113,14 +145,40 @@ function.
 <span x-data="{ date: new Date() }" x-text="$timeago(date, null, true)"></span>
 ```
 
+#### Strict
+
+If you do not want the "about [diff]" or "less than [diff]" prefixes, you can use the fourth parameter to provide the "
+strict" options.
+
+##### Default
+
+```html
+<span x-data="{ date: new Date() }"
+      x-text="$timeago(date, null, null, { strict: true })"></span>
+```
+
+##### Unit
+
+```html
+<span x-data="{ date: new Date() }"
+      x-text="$timeago(date, null, null, { strict: true, unit: 'second' })"></span>
+```
+
+##### Rounding method
+
+```html
+<span x-data="{ date: new Date() }"
+      x-text="$timeago(date, null, null, { strict: true, roundingMethod: 'floor' })"></span>
+```
+
 ### Other locales
 
 If you are using the `npm` installation method for this package or the ESM distribution, you can use the
 `TimeAgo.configure()` method to provide a different locale from `date-fns`.
 
 ```javascript
 import TimeAgo from '@marcreichel/alpine-timeago';
-import { de } from 'date-fns/locale';
+import {de} from 'date-fns/locale';
 
 Alpine.plugin(TimeAgo.configure({
     locale: de,