simbiat/sand-clock

时间相关对象的功能集合

2.3.4+20240616 2024-06-16 08:54 UTC

README

用于处理日期/时间的函数集。

如何使用

时间格式化

echo \Simbiat\SandClock::format(1234567890);

将输出 2009-02-13 23:31:30.000000

你可以按自己的喜好格式化,以获取 23:31

echo \Simbiat\SandClock::format(1234567890, 'H:i');

将秒转换为时间单位剩余时间

将输出 1 aeon 1 millennium 5 centuries 8 decades 5 years 6 months 1 week 1 day 7 hours 10 minutes 52 seconds

echo \Simbiat\SandClock::seconds('31536050000829051');

你可以以'简短'格式(不包含文本)输出相同的内容,例如

将输出 1:1:5:8:5:6:1:1:7:10:52

echo \Simbiat\SandClock::seconds('31536050000829051', false);

此函数支持多语言,目前支持8种语言:Deutsch (de)、English (en)、Spanish (es)、French (fr)、Italian (it)、Japanese (jp)、Russian (ru)、Finnish (fi)。你可以这样切换

将输出 1 ion 1 sennenki 5 seiki 8 tōnen 5 toshi 6 tsuki 1 shū 1 hi 7 jikan 10 bun 52 byō

echo \Simbiat\SandClock::seconds('31536050000829051', true, 'jp');

你可以传递 iso: true 以生成符合 ISO 8601 时间长度格式的输出,例如 P51Y8M0W4DT8H20M31S

如果你想要转换整数、字符串、\DateTime\DateTimeImmutable 表示的时间戳的时区,你可以这样调用

时区转换

如果你想要转换整数、字符串、\DateTime\DateTimeImmutable 表示的时间戳的时区,你可以这样调用

\Simbiat\SandClock::convertTimezone('now', 'Europe/Helsinki', 'UTC')

这将返回相应的 \DateTime 对象,然后你可以进一步操作它。如果你最初提供的是 \DateTime\DateTimeImmutable 对象,你可以使用 null 作为 $from(第二个参数),因为在这种情况下它将不会使用(空字符串会抛出异常)。