Re: [RFC] Duration class

On 2026-07-03 03:27, Tim Düsterhus wrote:

Any suggestions regarding naming from your side? Best regards Tim Düsterhus

"translate" would be too abstract, obviously. Have "offset" or "shift" been suggested? "offset" is also a noun so would need to be "offsetBy" or "withOffset"; the former is still a bit ambiguous, and while the latter I think clearly returns a new Duration, it suggests there's some kind of distinct "Offset" entity. "shift"/"shifted" - perhaps with a "By" to make reading flow more naturally - gets the translation idea across I think: we're moving an Instant from _here_ to _there_ by _this_ amount. Larry has already commented on the connotations of the "-ed" suffix: the former is active, the latter is passive; one changes the object it's applied to, the other returns a new one. (If there's any debate on that, my preference would be for immutable objects: having an object _here_ change because of something done to it over _there_ ... such communication should be done out in the open and not hidden inside arbitrary values.) (And that active/passive tension is often a thing in coordinate transforms - are we changing the object and seeing the results in our reference frame, or are we changing our reference frame and just changing our description of the object?)