duration/duration-php

时间持续类

v0.0.7 2023-05-18 04:07 UTC

This package is auto-updated.

Last update: 2024-09-18 07:24:07 UTC


README

Duration 是一个抽象时间持续时间的类

安装

composer require duration/duration-php

用法

require __DIR__ . '/vendor/autoload.php';
use Duration\Duration;
$d = Duration::parse("1h59m59s999ms999us999ns");
$d->add(Duration::parse("1ns"));
echo $d; // prints "2h"

方法

  • Duration::parse():通过解析字符串创建新实例,例如 Go

    $d = Duration::parse("+1h59m59s999ms999us999ns")

  • new / 构造函数:创建新实例

    $d = new Duration([$n=0, [$multiplier=1]]) $d = new Duration(); // 0 纳秒 $d = new Duration(1); // 1 纳秒 $d = new Duration(1, Duration::Millisecond); // 1000000 纳秒

  • add(Duration):将持续时间添加到 $d

    $q = Duration::parse("1m"); $d->add($q) -> Duration

  • sub(Duration):从 $d 中减去持续时间

    $q = Duration::parse("1m"); $d->sub($q) -> Duration

  • truncate(Duration):四舍五入到最近的持续时间

    $q = Duration::parse("5m"); $d->truncate($q) -> Duration

  • abs():返回绝对持续时间

    注意:与 Go 的 time#Duration.Abs() 相同,对于 PHP_MIN_INT 的持续时间返回 PHP_MAX_INT 的持续时间,反之亦然。

    $d->abs() -> Duration

时间持续时间属性

Makefile

  • make test 运行单元测试