Derafu\Lib\Core\Helper\Date

Complexity

Total Complexity

7

Size/Duplication

Total Lines	81
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	validateAndConvert()	0	17	5
A	formatSpanish()	0	11	2

<?php

declare(strict_types=1);

/**
 * Derafu: Biblioteca PHP (Núcleo).
 * Copyright (C) Derafu <https://www.derafu.org>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la Licencia Pública General Affero de GNU publicada por
 * la Fundación para el Software Libre, ya sea la versión 3 de la Licencia, o
 * (a su elección) cualquier versión posterior de la misma.
 *
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la Licencia Pública
 * General Affero de GNU para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la Licencia Pública General Affero de GNU
 * junto a este programa.
 *
 * En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
 */

namespace Derafu\Lib\Core\Helper;

use Carbon\Carbon;
use Carbon\Exceptions\InvalidFormatException;

/**
 * Clase para trabajar con fecha en PHP.
 *
 * Extiende las funcionalidades de Carbon
 */
class Date extends Carbon
{
    /**
     * Días de la semana en español.
     *
     * @var array
     */
    private const DAYS = [
        'domingo',
        'lunes',
        'martes',
        'miércoles',
        'jueves',
        'viernes',
        'sábado',
    ];

    /**
     * Meses del año en español.
     *
     * @var array
     */
    private const MONTHS = [
        'enero',
        'febrero',
        'marzo',
        'abril',
        'mayo',
        'junio',
        'julio',
        'agosto',
        'septiembre',
        'octubre',
        'noviembre',
        'diciembre',
    ];

    /**
     * Formatea una fecha en formato YYYY-MM-DD a un string en español.
     *
     * @param string $date
     * @param bool $showDay
     * @return string
     */
    public static function formatSpanish(string $date, bool $showDay = true): string
    {
        $unixtime = strtotime($date);
        $string = date('j \d\e \M\O\N\T\H \d\e\l Y', $unixtime);
        if ($showDay) {
            $string = 'DAY ' . $string;
        }
        $day = self::DAYS[date('w', $unixtime)];
        $month = self::MONTHS[date('n', $unixtime) - 1];

        return str_replace(['DAY', 'MONTH'], [$day, $month], $string);
    }

    /**
     * Valida si una fecha está en el formato Y-m-d y la convierte a un nuevo
     * formato.
     *
     * @param string $date
     * @return string|null
     */
    public static function validateAndConvert(
        string $date,
        string $format = 'd/m/Y'
    ): ?string {
        try {

            $carbonDate = self::createFromFormat('Y-m-d', $date);
            if (
                $carbonDate === null
                || $carbonDate->format('Y-m-d') !== $date
                || $carbonDate->getLastErrors()['error_count'] > 0
            ) {
                return null;
            }
            return $carbonDate->format($format);
        } catch (InvalidFormatException $e) {
            return null;
        }
    }
}