PHP: Praktische Möglichkeiten, der Hölle der Dates zu entkommen

Kritische Funktionen für Unternehmen hängen häufig von Daten ab, etwa Abonnements, wiederkehrende Zahlungen oder Buchungen.

Als PHP-Programmierer müssen Sie wahrscheinlich Datums- und Uhrzeitangaben manipulieren.

Erste Schritte mit einer Drittanbieter-Bibliothek? Wirklich?

Während es im Allgemeinen eine gute Praxis ist, bei nativen APIs zu bleiben, um Ihr Handwerk zu beherrschen und zu verstehen, wie die Sprache funktioniert, sollten wir pragmatisch sein.

Carbon ist eine leistungsstarke Bibliothek, die DateTimeInterface, JsonSerializable und andere native PHP-Tools erweitert.

Es bietet nützliche Helfer für die Bearbeitung bestehender und neuer Datumsobjekte:

// Tomorrow
CarbonImmutable::now()->add(1, 'day');

// Copy instance from another API
$dateTime = new \DateTime('first day of January 2025');
$carbon = Carbon::instance($dateTime);

// Parsing values
$date = Carbon::parse('2050-01-01 12:34:00', 'UTC');

Zurück zu den Grundlagen

Carbon erweitert die native API, aber das DateTime-Objekt bietet bereits Tools zur Berechnung von Datums- und Uhrzeitangaben:

$date = new DateTime('2024-07-23');
$date->add(new DateInterval('P10D'));
echo $date->format('Y-m-d');

$date2 = new DateTime('2024-08-03');
$interval = $date->diff($date2);
echo $interval->format('%R%a days');

Sie können Zeichenfolgen übergeben, um bestimmte Ausgaben zu erhalten oder Intervalle und Zeiträume zu berechnen.

Warum also zusätzliche Schichten wie Carbon verwenden?

Bessere Lesbarkeit

$yesterday = Carbon::yesterday();
$today = Carbon::today();
$now = Carbon::now();
$tomorrow = Carbon::tomorrow();
$futureDate = Carbon::today()->addDays(21)->format('Y-m-d');

if ($now->isEndOfDay()) {
    // Some code
}

Die Bibliothek ist praktisch und robust für Datumsvergleiche, die anfällig für verschiedene Fehler sind.

Einfache Lokalisierung

Carbon verwaltet Standorte bequem:

$now = Carbon::now()->locale('fr_FR');
echo $now->monthName;

Umgang mit Überläufen

Das Standardverhalten von PHP DateTime kann beim Addieren oder Subtrahieren von Monaten irreführend sein. Es kann überlaufen!

Während Sie dieses Verhalten manchmal benötigen, bietet Carbon eine bessere Kontrolle:

Carbon::useMonthsOverflow(false);
Carbon::resetMonthsOverflow();

Sie können in jeder Methode auch Überläufe konfigurieren, wenn Sie Jahre oder Monate bearbeiten (z. B. subMonthsNoOverflow, addMonthsWithOverflow).

Termine für Unit-Tests

Daten können in Unit-Tests aufgrund der Variabilität problematisch sein.

Carbon bietet erweiterte Mocking-Funktionen und stellt sicher, dass Tests konsistent und zuverlässig bleiben.

Dies verhindert zufällige Fehler, die Ihre CI/CD-Pipelines beschädigen können.

So vermeiden Sie häufige Fallstricke bei Datums- und Uhrzeitangaben

Ob Sie Carbon verwenden oder nicht, es gibt praktische Möglichkeiten, potenzielle Fehler und Inkonsistenzen zu reduzieren:

Fehler nicht verschweigen

Neueste Versionen von PHP haben bessere Datums-/Uhrzeitausnahmen eingeführt, sodass Sie unerwartete Eingaben konsistenter abfangen können.

Allerdings können Implementierungen manchmal schwerwiegende Fehler unterdrücken:

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);
echo date('Y-m-d', $timestamp); // Defaults back to 1970-01-01

Der folgende Code stellt keine Verbesserung dar, auch wenn er ein DateTime-Objekt verwendet:

$dateInput = '2024-02-30'; // Invalid date (February has 28 days, 29 at most)
$date = new DateTime($dateInput);
echo $date->format('l \t\h\e jS F'); // Outputs "Friday the 1st March"

Also immer Datum/Uhrzeit validieren:

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);

if (false === $timestamp) {
    throw new InvalidArgumentException();
}

echo date('Y-m-d', $timestamp);

Und überprüfen Sie die Eingaben gründlich:

$format = 'Y-m-d';
$dateInput = '2024-02-30';
$dateInfo = date_parse($dateInput);
if (!checkdate($dateInfo['day'], $dateInfo['month'], $dateInfo['year'])) {
    throw new InvalidArgumentException();
}

$date = DateTimeImmutable::createFromFormat($format, $dateInput);
echo $date->format('l \t\h\e jS F');

Verhindern Sie versehentliche Mutationen

DateTimeImmutable oder CarbonImmutable können nach der Erstellung nicht geändert werden. In den meisten Fällen müssen Sie das ursprüngliche Datum nicht ändern.

Wenn andere Teile des Codes auf dieser Instanz basieren, können schwerwiegende Fehler entstehen.

Unveränderliche Formate verhindern solche Nebenwirkungen und sind in der Regel besser für Lesbarkeit und Tests geeignet.

Zeitzonen nicht vernachlässigen

Zeitzonen zu vernachlässigen ist riskant:

PHP: Zeitzonen verstehen

spO0q ・ 4. August

#php #Anfänger #Programmierung

Wenn Sie in Ihrer App keine Standardzeitzone angeben, wird diese vom Server ermittelt.

Ihre Anwendung kann jedoch auf Servern in verschiedenen Zeitzonen bereitgestellt werden.

Möglicherweise haben Sie auch mit Komplexitäten wie Sommerzeit oder Speicherformaten (z. B. UTC vs. Ortszeit) zu kämpfen, was bei einer Bibliothek, die bewährte Praktiken fördert, möglicherweise weniger schmerzhaft ist.

Einpacken

Die native API ermöglicht erweiterte Manipulationen von Datum und Uhrzeit, während Carbon sie wunderbar erweitert.

PHP-Entwickler können diese zusätzliche Ebene nutzen, um Berechnungen zu vereinfachen und die Lesbarkeit zu verbessern.

Unabhängig davon, ob Sie es verwenden, stellen Sie sicher, dass Sie das Standardverhalten des nativen PHP-DateTime-Objekts verstehen.

Das obige ist der detaillierte Inhalt vonPHP: Praktische Möglichkeiten, der Hölle der Dates zu entkommen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!