iandyck/carbon

DateTime的API扩展,支持281种不同的语言。

2.58.9 2022-05-05 14:14 UTC

This package is auto-updated.

Last update: 2024-09-05 19:35:27 UTC


README

Latest Stable Version Total Downloads GitHub Actions codecov.io Tidelift

一个国际化的PHP DateTime扩展。 https://carbon.nesbot.com

<?php

use Carbon\Carbon;

printf("Right now is %s", Carbon::now()->toDateTimeString());
printf("Right now in Vancouver is %s", Carbon::now('America/Vancouver'));  //implicit __toString()
$tomorrow = Carbon::now()->addDay();
$lastWeek = Carbon::now()->subWeek();
$nextSummerOlympics = Carbon::createFromDate(2016)->addYears(4);

$officialDate = Carbon::now()->toRfc2822String();

$howOldAmI = Carbon::createFromDate(1975, 5, 21)->age;

$noonTodayLondonTime = Carbon::createFromTime(12, 0, 0, 'Europe/London');

$internetWillBlowUpOn = Carbon::create(2038, 01, 19, 3, 14, 7, 'GMT');

// Don't really want this to happen so mock now
Carbon::setTestNow(Carbon::createFromDate(2000, 1, 1));

// comparisons are always done in UTC
if (Carbon::now()->gte($internetWillBlowUpOn)) {
    die();
}

// Phew! Return to normal behaviour
Carbon::setTestNow();

if (Carbon::now()->isWeekend()) {
    echo 'Party!';
}
// Over 200 languages (and over 500 regional variants) supported:
echo Carbon::now()->subMinutes(2)->diffForHumans(); // '2 minutes ago'
echo Carbon::now()->subMinutes(2)->locale('zh_CN')->diffForHumans(); // '2分钟前'
echo Carbon::parse('2019-07-23 14:51')->isoFormat('LLLL'); // 'Tuesday, July 23, 2019 2:51 PM'
echo Carbon::parse('2019-07-23 14:51')->locale('fr_FR')->isoFormat('LLLL'); // 'mardi 23 juillet 2019 14:51'

// ... but also does 'from now', 'after' and 'before'
// rolling up to seconds, minutes, hours, days, months, years

$daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays();

通过Tidelift订阅获取支持的nesbot/carbon

安装

使用Composer

$ composer require nesbot/carbon
{
    "require": {
        "nesbot/carbon": "^2.16"
    }
}
<?php
require 'vendor/autoload.php';

use Carbon\Carbon;

printf("Now: %s", Carbon::now());

不使用Composer

为什么不使用composer?下载Carbon的最新版本,并将ZIP归档的内容放入项目的目录中。然后需要加载所有类和依赖项的文件autoload.php

<?php
require 'path-to-Carbon-directory/autoload.php';

use Carbon\Carbon;

printf("Now: %s", Carbon::now());

文档

https://carbon.nesbot.com/docs

安全联系方式

报告安全漏洞,请使用Tidelift安全联系方式。Tidelift将协调修复和披露。

致谢

贡献者

本项目得以存在,归功于所有贡献者。

翻译者

感谢帮助我们将Carbon翻译成多种语言的每一个人

赞助商

通过成为赞助商来支持本项目。您的标志将显示在此处,并提供到您网站的链接。

[成为赞助商]

支持者

感谢所有支持者!🙏

[成为支持者]

Carbon企业版

作为Tidelift订阅的一部分提供。

Carbon的维护者以及成千上万的其他包的维护者正在与Tidelift合作,为您使用的构建应用程序的开源依赖项提供商业支持和维护。节省时间,降低风险,提高代码质量,同时支付您使用的确切依赖项的维护者。 了解更多。