Algum tempo atrás escrevi um artigo sobre como trabalhar com datas no JavaScript. Nesse artigo trago algo semelhante, porém agora para o mundo PHP utilizando a biblioteca Carbon. Sobre o Carbon O Carbon é uma biblioteca que herda a classe DateTime do PHP e que facilita a manipulação e operação com datas no PHP.
Algum tempo atrás escrevi um artigo sobre como trabalhar com datas no JavaScript. Nesse artigo trago algo semelhante, porém agora para o mundo PHP utilizando a biblioteca Carbon.
Sobre o Carbon
O Carbon é uma biblioteca que herda a classe DateTime do PHP e que facilita a manipulação e operação com datas no PHP.
O repositório oficial do Carbon pode ser encontrado no GitHub e a documentação oficial no site.
Instalando a biblioteca
Antes de começar, é bom se atentar na compatibilidade da versão do Carbon com a versão do PHP, segundo a documentação oficial:
- 1.x é compatível com PHP 5.3+
- 2.x é compatível com PHP 7.1.8+
A forma mais simples de instalar o Carbon no nosso projeto é através do Composer:
$ composer require nesbot/carbon
Com ele instalado, vamos criar um arquivo teste.php com o seguinte código:
<?php
require_once 'vendor/autoload.php';
use CarbonCarbon;
Funcionalidades
Agora, vamos ver algumas das funcionalidades que a biblioteca disponibiliza para trabalharmos com datas.
Para não ficar repetitivo, vou considerar em todos os exemplos que o passo anterior já foi executado, ou seja, já foi feito o require do autoload e o use da classe. Além disso em todas as execuções dos testes vou executar o comando php teste.php para mostrar a saída.
Data atual
$agora = Carbon::now();
print_r($agora);
$instancia = new Carbon();
print_r($instancia);
Os dois exemplos tiveram o mesmo efeito, exceto obviamente pelos milisegundos.
Timezone
Com o Carbon também é muito tranquilo de se trabalhar com timezone, basta passar a opção no momento de criação da classe.
$saoPaulo = Carbon::now(new DateTimeZone('America/Sao_Paulo'));
$recife = Carbon::now(new DateTimeZone('America/Recife'));
$londres = Carbon::now(new DateTimeZone('Europe/London'));
print('São Paulo - ' . $saoPaulo . PHP_EOL);
print('Recife - ' . $recife . PHP_EOL);
print('Londres - ' . $londres . PHP_EOL);
Adição e Subtração
Temos diversas funções para adicionar e subtrair valores em uma data. Vou mostrar apenas algumas, porém todas seguem a mesma lógica.
$d = Carbon::create(2018, 01, 01, 0);
print($d->addCenturies(2) . PHP_EOL);
print($d->subCenturies(2) . PHP_EOL);
print($d->addHour() . PHP_EOL);
print($d->subHour() . PHP_EOL);
print($d->addMinutes(10) . PHP_EOL);
print($d->subMinutes(10) . PHP_EOL);
// Métodos genéricos para manipulação
print($d->add(10, 'minutes') . PHP_EOL);
print($d->sub('1 day') . PHP_EOL);
Formatação
Todas as opções de formatação se baseiam no método format() da própria classe DateTime, porém temos algumas funções que já facilitam alguns formatos mais comuns.
$d = Carbon::now();
print($d->toDateString() . PHP_EOL);
print($d->toTimeString() . PHP_EOL);
print($d->toDateTimeString() . PHP_EOL);
Conclusão
Esse post foi para introduzir e mostrar algumas funções básicas da biblioteca Carbon, tenho certeza de que se você estiver trabalhando com datas no PHP é uma excelente escolha para facilitar o seu desenvolvimento.
Aconselho para os que querem conhecer as demais funções e facilidades da biblioteca que consultem a documentação oficial.
Fonte: Por Breno Panzolini – tableless.com.br
