Ciri kritikal untuk perniagaan selalunya bergantung pada tarikh, seperti langganan, pembayaran berulang atau tempahan.

Sebagai pengaturcara PHP, anda mungkin perlu memanipulasi tarikh/masa.

Bermula dengan Perpustakaan Pihak Ketiga? Betul ke?

Walaupun secara amnya merupakan amalan yang baik untuk kekal menggunakan API asli untuk menguasai kemahiran anda dan memahami cara bahasa itu berfungsi, mari kita bersikap pragmatik.

Carbon ialah perpustakaan berkuasa yang memanjangkan DateTimeInterface, JsonSerializable dan alatan PHP asli yang lain.

Ia menyediakan pembantu yang berguna untuk memanipulasi kedua-dua objek tarikh sedia ada dan baharu:

// 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');

Kembali kepada Asas

Karbon memanjangkan API asli, tetapi objek DateTime sudah menyediakan alat untuk mengira tarikh dan masa:

$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');

Anda boleh melepasi rentetan untuk mendapatkan output tertentu atau mengira selang dan tempoh.

Jadi, Mengapa Gunakan Lapisan Tambahan Seperti Karbon?

Kebolehbacaan yang lebih baik

$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
}

Perpustakaan ini mudah dan kukuh untuk perbandingan tarikh, yang terdedah kepada pelbagai ralat.

Penyetempatan mudah

Karbon mengendalikan setempat dengan mudah:

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

Mengendalikan Limpahan

Tingkah laku PHP DateTime lalai boleh mengelirukan apabila menambah atau menolak bulan. Ia boleh melimpah!

Walaupun anda mungkin memerlukan tingkah laku itu kadang-kadang, Carbon menyediakan kawalan yang lebih baik:

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

Anda juga boleh mengkonfigurasi limpahan dalam setiap kaedah apabila memanipulasi tahun atau bulan (cth, subMonthsNoOverflow, addMonthsWithOverflow).

Tarikh Ujian Unit

Kurma boleh menjadi masalah dalam ujian unit kerana kebolehubahan.

Karbon menawarkan keupayaan canggih untuk mengejek, memastikan ujian kekal konsisten dan boleh dipercayai.

Ini menghalang ralat rawak yang boleh memecahkan saluran paip CI/CD anda.

Cara Mengelakkan Perangkap Biasa dengan Tarikh/Masa

Sama ada anda menggunakan Karbon atau tidak, terdapat cara praktikal untuk mengurangkan potensi pepijat dan ketidakkonsistenan:

Jangan Senyapkan Kesilapan

Versi terbaharu PHP memperkenalkan pengecualian tarikh/masa yang lebih baik, membolehkan anda menangkap input yang tidak dijangka dengan lebih konsisten.

Walau bagaimanapun, pelaksanaan kadangkala boleh menyenyapkan ralat buruk:

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

Kod berikut bukanlah peningkatan, walaupun ia menggunakan objek DateTime:

$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"

Jadi, sentiasa sahkan tarikh/masa:

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

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

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

Dan, semak input dengan mendalam:

$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');

Cegah Mutasi Tidak Sengaja

DateTimeImmutable atau CarbonImmutable tidak boleh ditukar selepas penciptaan. Selalunya, anda tidak perlu mengubah tarikh awal.

Jika bahagian lain kod bergantung pada contoh itu, anda mungkin memperkenalkan pepijat jahat.

Format tidak berubah menghalang kesan sampingan tersebut dan biasanya lebih baik untuk kebolehbacaan dan ujian.

Jangan Abaikan Zon Waktu

Mengabaikan zon waktu adalah berisiko:

PHP: Memahami Zon Masa

spO0q ? 4 Ogos

#php #pemula #pengaturcaraan

Jika anda tidak menentukan zon waktu lalai dalam apl anda, pelayan akan menentukannya.

Walau bagaimanapun, aplikasi anda mungkin digunakan pada pelayan dalam zon waktu yang berbeza.

Anda juga mungkin bergelut dengan kerumitan seperti masa penjimatan siang hari atau format storan (mis., UTC lwn. waktu tempatan), yang mungkin kurang menyakitkan dengan perpustakaan yang menggalakkan amalan baik.

Bungkus

API asli membenarkan manipulasi lanjutan tarikh dan masa, manakala Karbon memanjangkannya dengan cantik.

Pembangun PHP boleh memanfaatkan lapisan tambahan ini untuk memudahkan pengiraan dan meningkatkan kebolehbacaan.

Tidak kira sama ada anda menggunakannya, pastikan anda memahami gelagat lalai objek DateTime PHP asli.

Atas ialah kandungan terperinci PHP: Cara praktikal untuk melarikan diri dari neraka Dates. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!