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!