dur() function documentation

[robertsinfosec]

From these pages:

https://blacksmithgu.github.io/obsidian-dataview/query/functions/#durany
https://blacksmithgu.github.io/obsidian-dataview/query/expressions/#durations

I can't find any more detail about the capabilities of this function. It seems to somewhat support features of "momentjs", but in a custom way. For example, you can seem to do things like this: dur(date(now) - date(creation_date)).days as Ago however, that's not really what I need.

By default, dur() shows the full, complete duration between two dates, like:

3 months, 3 weeks, 5 days, 23 hours, 10 minutes, 52 seconds, 589 ms

What I would like instead is to have the "most appropriate", rounded-up date range between two dates like "momentjs", like: "3 months ago", "4 minutes ago", etc.

I've scoured the internet looking for more documentation on what dur() can support and I'm not finding much beyond this official documentation. Is there a way to "auto format" a "duration" to the closest, appropriate date denomination? Thanks

[AB1908]

It uses Luxon behind the scenes IIRC. Should support some of those operations.

[blacksmithgu]

dur is a function which creates a Duration object, which is an abstract representation of a duration of time. It gives you access to some fields, like weeks, days, and so on.

I don't think there is presently a method for duration rounding - I will need to add one.

[robertsinfosec]

Thanks!