battye/date-convert

将日期字符串从一种格式转换为另一种格式。

v1.0.0 2019-08-25 13:05 UTC

This package is not auto-updated.

Last update: 2024-09-17 12:06:08 UTC


README

一个小型库,使用 DateTime 对象将日期字符串从一种格式转换为另一种格式。

安装

使用 composer 安装此库,命令为 composer require battye/date-convert "~1.0"。如果您发现任何错误,请提交问题或拉取请求。

简单用法

必须在 date() 函数中提供原始日期字符串。

应使用 from() 函数来指示正在使用的格式,而 to() 应填充所需的输出格式(与 datetext() 结合使用)。

以下是一个示例用法

use battye\date_convert\convert;

$convert = convert::date('2011-01-20 00:00:00+09')
    ->from('Y-m-d H:i:sT')
    ->to('j F y');
    
$datetime = $convert->datetime(); // returns a DateTime object
$datetext = $convert->datetext(); // returns 20 January 11
$timestamp = $convert->timestamp(); // returns 1295449200

转换时区

要在不同的时区输出格式,可以在调用 datetime()datetext() 之前指定以下方式之一。时间戳不受时区影响。

$convert->timezone(new \DateTimeZone('Asia/Macau'));
$convert->timezone('Asia/Macau');

测试

Build Status

单元测试提供了如何使用此库的好例子,可以在 tests/ 目录中找到。要执行单元测试,请运行

vendor/bin/simple-phpunit tests/