328 lines
8.4 KiB
PHP
328 lines
8.4 KiB
PHP
<?php
|
|
|
|
namespace App\Helpers;
|
|
|
|
use Carbon\Carbon;
|
|
use Jenssegers\Date\Date;
|
|
use Illuminate\Support\Facades\Auth;
|
|
|
|
class DateHelper
|
|
{
|
|
/**
|
|
* Set the locale of the instance for Date frameworks.
|
|
*
|
|
* @param string
|
|
* @return string
|
|
*/
|
|
public static function setLocale($locale)
|
|
{
|
|
$locale = $locale ?: config('app.locale');
|
|
Carbon::setLocale($locale);
|
|
Date::setLocale($locale);
|
|
}
|
|
|
|
/**
|
|
* Creates a Carbon object from DateTime format.
|
|
*
|
|
* @param \DateTime|Carbon|string date
|
|
* @param string timezone
|
|
* @return Carbon
|
|
*/
|
|
public static function parseDateTime($date, $timezone = null)
|
|
{
|
|
if (is_null($date)) {
|
|
return;
|
|
}
|
|
if ($date instanceof \DateTime) {
|
|
$date = Carbon::instance($date);
|
|
}
|
|
if ($date instanceof Carbon) {
|
|
$date = $date->toDateTimeString();
|
|
}
|
|
$date = Carbon::createFromFormat('Y-m-d H:i:s', $date, config('app.timezone'));
|
|
if ($timezone !== null) {
|
|
$date->setTimezone($timezone);
|
|
}
|
|
|
|
return $date;
|
|
}
|
|
|
|
/**
|
|
* Creates a Carbon object from Date format.
|
|
*
|
|
* @param string date
|
|
* @return Carbon
|
|
*/
|
|
public static function parseDate($date, $timezone = null)
|
|
{
|
|
if (! $date instanceof Carbon) {
|
|
try {
|
|
$date = Carbon::parse($date);
|
|
} catch (\Exception $e) {
|
|
// Parse error
|
|
return;
|
|
}
|
|
}
|
|
$date = Carbon::create($date->year, $date->month, $date->day, 0, 0, 0, config('app.timezone'));
|
|
if ($timezone !== null) {
|
|
$date->setTimezone($timezone);
|
|
}
|
|
|
|
return $date;
|
|
}
|
|
|
|
/**
|
|
* Return timestamp date format.
|
|
*
|
|
* @param Carbon|\App\Models\Instance\SpecialDate|string $date
|
|
* @return string
|
|
*/
|
|
public static function getTimestamp($date)
|
|
{
|
|
if (is_null($date)) {
|
|
return;
|
|
}
|
|
if ($date instanceof \App\Models\Instance\SpecialDate) {
|
|
$date = $date->date;
|
|
}
|
|
if (! $date instanceof Carbon) {
|
|
$date = Carbon::create($date, config('app.timezone'));
|
|
}
|
|
|
|
return $date->format(config('api.timestamp_format'));
|
|
}
|
|
|
|
/**
|
|
* Get timezone of the current user, or null.
|
|
*
|
|
* @return string|null
|
|
*/
|
|
public static function getTimezone()
|
|
{
|
|
if (Auth::check()) {
|
|
return auth()->user()->timezone;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return a date according to the timezone of the user, in a short format
|
|
* like "Oct 29, 1981".
|
|
*
|
|
* @param Carbon $date
|
|
* @return string
|
|
*/
|
|
public static function getShortDate($date)
|
|
{
|
|
$date = new Date($date, static::getTimezone());
|
|
$format = trans('format.short_date_year', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Return the month of the date according to the timezone of the user
|
|
* like "Oct", or "Dec.
|
|
*
|
|
* @param Carbon $date
|
|
* @return string
|
|
*/
|
|
public static function getShortMonth($date)
|
|
{
|
|
$date = new Date($date, static::getTimezone());
|
|
$format = trans('format.short_month', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Return the day of the date according to the timezone of the user
|
|
* like "Mon", or "Wed.
|
|
*
|
|
* @param Carbon $date
|
|
* @return string
|
|
*/
|
|
public static function getShortDay($date)
|
|
{
|
|
$date = new Date($date, static::getTimezone());
|
|
$format = trans('format.short_day', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Return a date according to the timezone of the user, in a short format
|
|
* like "Oct 29".
|
|
*
|
|
* @param Carbon $date
|
|
* @return string
|
|
*/
|
|
public static function getShortDateWithoutYear($date)
|
|
{
|
|
$date = new Date($date, static::getTimezone());
|
|
$format = trans('format.short_date', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Return a date and the time according to the timezone of the user, in a short format
|
|
* like "Oct 29, 1981 19:32".
|
|
*
|
|
* @param Carbon $date
|
|
* @return string
|
|
*/
|
|
public static function getShortDateWithTime($date)
|
|
{
|
|
$date = new Date($date, static::getTimezone());
|
|
$format = trans('format.short_date_year_time', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Add a given number of week/month/year to a date.
|
|
* @param Carbon $date the start date
|
|
* @param string $frequency week/month/year
|
|
* @param int $number the number of week/month/year to increment to
|
|
*/
|
|
public static function addTimeAccordingToFrequencyType(Carbon $date, $frequency, $number)
|
|
{
|
|
switch ($frequency) {
|
|
case 'week':
|
|
$date->addWeeks($number);
|
|
break;
|
|
case 'month':
|
|
$date->addMonths($number);
|
|
break;
|
|
default:
|
|
$date->addYears($number);
|
|
break;
|
|
}
|
|
|
|
return $date;
|
|
}
|
|
|
|
/**
|
|
* Get the name of the month and year of a given date with a given number
|
|
* of months more.
|
|
* @param int $month
|
|
* @return string
|
|
*/
|
|
public static function getMonthAndYear(int $month)
|
|
{
|
|
$date = Date::now()->addMonthsNoOverflow($month);
|
|
$format = trans('format.short_month_year', [], Date::getLocale());
|
|
|
|
return $date->format($format) ?: '';
|
|
}
|
|
|
|
/**
|
|
* Gets the next theoritical billing date.
|
|
* This is used on the Upgrade page to tell the user when the next billing
|
|
* date would be if he subscribed.
|
|
*
|
|
* @param string
|
|
* @return Carbon
|
|
*/
|
|
public static function getNextTheoriticalBillingDate(String $interval)
|
|
{
|
|
if ($interval == 'monthly') {
|
|
return now(static::getTimezone())->addMonth();
|
|
}
|
|
|
|
return now(static::getTimezone())->addYear();
|
|
}
|
|
|
|
/**
|
|
* Gets a list of all the year from min to max (0 is the current year).
|
|
*
|
|
* @param int min
|
|
* @param int max
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function getListOfYears($max = 120, $min = 0)
|
|
{
|
|
$years = [];
|
|
$maxYear = now(static::getTimezone())->subYears($min)->year;
|
|
$minYear = now(static::getTimezone())->subYears($max)->year;
|
|
|
|
for ($year = $maxYear; $year >= $minYear; $year--) {
|
|
array_push($years, $year);
|
|
}
|
|
|
|
return $years;
|
|
}
|
|
|
|
/**
|
|
* Gets a list of all the months in a year.
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function getListOfMonths()
|
|
{
|
|
$months = collect([]);
|
|
$currentDate = Date::parse('2000-01-01');
|
|
$format = trans('format.full_month', [], Date::getLocale());
|
|
|
|
for ($month = 1; $month <= 12; $month++) {
|
|
$currentDate->month = $month;
|
|
$months->push([
|
|
'id' => $month,
|
|
'name' => mb_convert_case($currentDate->format($format), MB_CASE_TITLE, 'UTF-8'),
|
|
]);
|
|
}
|
|
|
|
return $months;
|
|
}
|
|
|
|
/**
|
|
* Gets a list of all the days in a month.
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function getListOfDays()
|
|
{
|
|
$days = collect([]);
|
|
for ($day = 1; $day <= 31; $day++) {
|
|
$days->push(['id' => $day, 'name' => $day]);
|
|
}
|
|
|
|
return $days;
|
|
}
|
|
|
|
/**
|
|
* Gets a list of all the hours in a day.
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function getListOfHours()
|
|
{
|
|
$currentDate = Date::parse('2000-01-01 00:00:00');
|
|
$format = trans('format.full_hour', [], Date::getLocale());
|
|
|
|
$hours = collect([]);
|
|
for ($hour = 1; $hour <= 24; $hour++) {
|
|
$currentDate->hour = $hour;
|
|
$hours->push([
|
|
'id' => date('H:i', strtotime("$hour:00")),
|
|
'name' => $currentDate->format($format),
|
|
]);
|
|
}
|
|
|
|
return $hours;
|
|
}
|
|
|
|
/**
|
|
* Removes a given number of days of a date given in parameter.
|
|
*
|
|
* @param Carbon $date
|
|
* @param int $numberOfDaysBefore
|
|
* @return Carbon
|
|
*/
|
|
public static function getDateMinusGivenNumberOfDays(Carbon $date, int $numberOfDaysBefore)
|
|
{
|
|
return $date->subDays($numberOfDaysBefore);
|
|
}
|
|
}
|