feat(appframework): ⌚ Make ITimeFactory extend \PSR\Clock\ClockInterface

[nickvergessen]

Summary

• ITimeFactory now implements PSR-20: https://www.php-fig.org/psr/psr-20/#21-clockinterface

TODO

• [ ] 3rdparty https://github.com/nextcloud/3rdparty/pull/1262
• [ ] OCP update so Psalm can find the interface https://github.com/nextcloud-deps/ocp/pull/4

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• [x] Tests (unit, integration, api and/or acceptance) are included
• [x] Screenshots before/after for front-end changes
• [x] Documentation (manuals or wiki) has been updated or is not required
• [x] Backports requested where applicable (ex: critical bugfixes)

[ChristophWurst]

Might or might not make sense to deprecate getTime right away.

[nickvergessen]

Might or might not make sense to deprecate getTime right away.

Same for the getDateTime() I think

[ChristophWurst]

I would love to see this documented at https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/psr.html :)

[nickvergessen]

Will do, after it's merged

[nickvergessen]

Rebased, now that 7.4 is dropped

[nickvergessen]

Dang, this slipped through. To preserve stability in OCP, I'm moving it to 27

[nickvergessen]

Docs in https://github.com/nextcloud/server/issues/37039#issuecomment-1455724716 and https://github.com/nextcloud/documentation/pull/9722