Comment utiliser Carbon avec CakePHP ?

Carbon est une bibliothèque de traitement de date et d'heure populaire en PHP. Il fournit des méthodes pratiques de formatage d'horodatage et de date, ainsi que de nombreuses fonctions utiles telles que la comparaison de dates et la conversion de fuseau horaire. Dans une application CakePHP, nous pouvons facilement intégrer Carbon et exploiter sa puissance pour gérer les dates et les heures.

Cet article présentera comment utiliser Carbon dans CakePHP. Nous commencerons par installer Carbon, puis expliquerons comment utiliser les différentes fonctionnalités de Carbon, telles que le formatage de l'heure, la comparaison de date et la conversion de fuseau horaire, dans les modèles et vues CakePHP.

Install Carbon

Pour utiliser Carbon avec CakePHP, nous devons d'abord l'installer. Dans Composer, nous pouvons utiliser la commande suivante pour installer Carbon :

composer require nesbot/carbon

Une fois l'installation terminée, nous devons introduire Carbon dans CakePHP. Pour ce faire, nous pouvons ajouter le code suivant à la fin du fichier config/bootstrap.php : config/bootstrap.php 文件的末尾添加以下代码：

use CarbonCarbon;

require_once ROOT . DS . 'vendor' . DS . 'autoload.php';

这将使我们可以在应用程序中使用 Carbon 类。

在模型中使用 Carbon

在 CakePHP 模型中使用 Carbon 的一个常见用例是将数据库中的日期和时间字段转换为本地时间。我们可以使用 Carbon 的 parse() 方法来实现这一点。例如，假设我们有一个名为 Article 的模型，并且该模型具有一个名为 published 的日期时间字段。我们可以将其转换为本地时间，并将其存储在模型的 published_local 属性中，如下所示：

use CarbonCarbon;

class Article extends AppModel {
    public function getPublishedLocal() {
        $published = $this->get('published');
        if ($published instanceof Carbon) {
            // 已经是 Carbon 对象，无需转换
            return $published->copy();
        }
        return Carbon::parse($published)->tz('Asia/Shanghai');
    }
}

在上面的代码中，我们首先检查 published 字段是否已经是 Carbon 对象，如果是，则无需转换并直接返回它。否则，我们将使用 Carbon 的 parse() 方法将其转换为 Carbon 对象，然后使用 tz() 方法将其转换为本地时间（将时区设置为 'Asia/Shanghai'）。

现在，我们可以在模型中轻松地访问 published_local 属性，以获取本地时间版本的 published 字段。

在视图中使用 Carbon

在 CakePHP 视图中使用 Carbon 有许多用例。比如，我们可能需要按特定格式显示日期或时间，或者根据日期时间字段的值显示不同的内容。

格式化日期和时间

要将日期和时间格式化为我们想要的格式，我们可以使用 Carbon 的 format() 方法。例如，假设我们要将日期字段 created 格式化为 "Y-m-d" 格式。我们可以在视图中使用以下代码：

<?= $article->created->format('Y-m-d') ?>

类似地，要将时间字段 updated 格式化为 "H:i:s" 格式，我们可以在视图中使用以下代码：

<?= $article->updated->format('H:i:s') ?>

日期比较

另一个我们可能需要在视图中使用 Carbon 的用例是比较日期。我们可以使用 Carbon 的 diffForHumans() 方法将日期字段与当前日期进行比较，并将其显示为“几天前”、“几分钟前”等等。例如，假设我们要在视图中显示文章发布到现在已经经过了多长时间。我们可以使用以下代码：

<?= $article->published->diffForHumans() ?>

这将显示“2 天前”、“5 分钟前”等等。

时区转换

最后，我们可能需要在视图中将日期和时间字段转换为不同的时区。例如，如果我们的应用程序将默认时区设置为 UTC，但用户在本地时区中查看了数据，则我们需要将日期和时间字段从 UTC 转换为用户的本地时区。为此，我们可以使用 Carbon 的 setTimezone() 方法。例如，假设我们的应用程序将默认时区设置为 UTC，但用户的本地时区为 'Asia/Shanghai'。我们可以在视图中使用以下代码将 published 字段转换为用户的本地时间：

<?= $article->published->setTimezone('Asia/Shanghai')->toDateTimeString() ?>

这将以 'Y-m-d H:i:s' 格式显示 publishedrrreee

Cela nous permettra d'utiliser la classe Carbon dans notre application .

Utilisation de Carbon dans les modèles

Un cas d'utilisation courant de l'utilisation de Carbon dans les modèles CakePHP consiste à convertir les champs de date et d'heure d'une base de données en heure locale. Nous pouvons le faire en utilisant la méthode parse() de Carbon. Par exemple, disons que nous avons un modèle appelé Article et que ce modèle a un champ datetime appelé publié. Nous pouvons le convertir en heure locale et le stocker dans l'attribut published_local du modèle comme suit : #🎜🎜#rrreee#🎜🎜#Dans le code ci-dessus, nous vérifions d'abord published code> est déjà un objet Carbon, si c'est le cas, aucune conversion n'est requise et il est renvoyé directement. Sinon, nous utiliserons la méthode <code>parse() de Carbon pour le convertir en objet Carbon, puis utiliserons la méthode tz() pour le convertir en heure locale (en définissant l'heure zone vers 'Asie/Shanghai'). #🎜🎜##🎜🎜#Maintenant, nous pouvons facilement accéder à la propriété published_local dans le modèle pour obtenir la version heure locale du champ published. #🎜🎜##🎜🎜#Utiliser Carbon dans les vues#🎜🎜##🎜🎜#Il existe de nombreux cas d'utilisation pour utiliser Carbon dans les vues CakePHP. Par exemple, nous pouvons avoir besoin d'afficher la date ou l'heure dans un format spécifique, ou d'afficher un contenu différent en fonction de la valeur du champ date et heure. #🎜🎜#

Formater la date et l'heure

#🎜🎜#Pour formater la date et l'heure dans le format souhaité, nous pouvons utiliser la méthode format() de Carbon. Par exemple, disons que nous voulons formater un champ de date créé au format "Y-m-d". Nous pouvons utiliser le code suivant dans la vue : #🎜🎜#rrreee#🎜🎜#De même, pour formater le champ horaire mis à jour en "H:i:s" Format , nous pouvons utiliser le code suivant dans la vue : #🎜🎜#rrreee

Comparaison de dates

#🎜🎜#Un autre cas d'utilisation où nous pourrions avoir besoin d'utiliser Carbon dans la vue est de comparer des dates. Nous pouvons utiliser la méthode diffForHumans() de Carbon pour comparer un champ de date à la date actuelle et l'afficher comme "il y a quelques jours", "il y a quelques minutes", etc. Par exemple, disons que nous souhaitons afficher dans une vue combien de temps s'est écoulé depuis la publication d'un article. On peut utiliser le code suivant : #🎜🎜#rrreee#🎜🎜#Cela affichera "il y a 2 jours", "il y a 5 minutes", etc. #🎜🎜#

Conversion de fuseau horaire

#🎜🎜#Enfin, nous devrons peut-être convertir les champs de date et d'heure de la vue dans un fuseau horaire différent. Par exemple, si notre application définit le fuseau horaire par défaut sur UTC, mais que l'utilisateur affiche les données dans son fuseau horaire local, nous devons convertir les champs de date et d'heure d'UTC vers le fuseau horaire local de l'utilisateur. Pour ce faire, nous pouvons utiliser la méthode setTimezone() de Carbon. Par exemple, supposons que notre application définisse le fuseau horaire par défaut sur UTC, mais que le fuseau horaire local de l'utilisateur est « Asie/Shanghai ». Nous pouvons utiliser le code suivant dans la vue pour convertir le champ publié en heure locale de l'utilisateur : #🎜🎜#rrreee#🎜🎜#Ceci sera converti en 'Y-m-d H:i : s' Le format code> affiche l'heure locale du champ <code>publié. #🎜🎜##🎜🎜#Conclusion#🎜🎜##🎜🎜#Dans cet article, nous avons expliqué comment utiliser Carbon dans CakePHP, y compris différents cas d'utilisation pour l'utilisation de Carbon dans les modèles et les vues. Vous devriez désormais pouvoir intégrer facilement Carbon et profiter de sa puissance pour travailler avec les dates et les heures. #🎜🎜#

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!