README

关于您的PHP应用中时间和日期的单一可信来源。

安装

使用composer将Clock Maestro安装到您的项目中

composer require deoomen/clock-maestro

如何使用

冻结时钟

它总是返回相同的值 - 初始化时的时间。

<?php

use ClockMaestro\Clock\FrozenClockMaestro;

// ...

// Use system default timezone
$clock = FrozenClockMaestro::fromSystemTimezone();
$now = $clock->now();

// Use UTC timezone
$clock = FrozenClockMaestro::fromUTC();
$now = $clock->now();

// Use given timezone
$timezone = new DateTimeZone('Mexico/General');
$clock = FrozenClockMaestro::fromTimezone($timezone);
$now = $clock->now();

// Get time as string with default format: `Y-m-d\TH:i:sP` - (ATOM, compatible with ISO-8601 format)
$clock = FrozenClockMaestro::fromUTC();
$nowAsString = $clock->toString();  // ex. 2021-05-13T12:30:00+00:00

// Get time as string with custom foramt
$clock = FrozenClockMaestro::fromUTC();
$nowAsString = $clock->toString('d.m.Y H:i');  // ex. 13.05.2021 12:30

系统时钟

返回当前时间。

<?php

use ClockMaestro\Clock\SystemClockMaestro;

// ...

// Use system default timezone
$clock = SystemClockMaestro::fromSystemTimezone();
$now = $clock->now();

// Use UTC timezone
$clock = SystemClockMaestro::fromUTC();
$now = $clock->now();

// Use given timezone
$timezone = new DateTimeZone('Mexico/General');
$clock = SystemClockMaestro::fromTimezone($timezone);
$now = $clock->now();

// Get time as string with default format: `Y-m-d\TH:i:sP` - (ATOM, compatible with ISO-8601 format)
$clock = SystemClockMaestro::fromUTC();
$nowAsString = $clock->toString();  // ex. 2021-05-13T12:30:00+00:00

// Get time as string with custom foramt
$clock = SystemClockMaestro::fromUTC();
$nowAsString = $clock->toString('d.m.Y H:i');  // ex. 13.05.2021 12:30

许可证

MIT许可证