Calendar est un ensemble d'extensions pour les calendriers de dates. Comment utiliser cette extension Calendar en PHP ? Cet article vous présentera comment installer et utiliser l'extension Calendrier.

Calendar est un ensemble d'extensions sur le calendrier des dates, mais pour nous, il n'a pas d'opérations liées au calendrier lunaire, donc pour nous, Chinois, cette extension n'a aucun effet réel. Mais cela ne nous empêche pas de le comprendre et de l’apprendre.

Type de calendrier de date

Pour les opérations de date dans des circonstances normales, PHP utilise par défaut l'heure UTC, qui est l'heure standard internationale, pour notre pays, nous devons ajouter 8 à l’heure UTC standard pour représenter l’heure du huitième district est de Pékin. Bien entendu, vous pouvez également modifier directement les paramètres liés au fuseau horaire dans le php.ini ou la base de données pour définir la date et le fuseau horaire.

Le fuseau horaire standard correspond en fait au calendrier horaire grégorien. Ce sont les dates du calendrier grégorien et du calendrier solaire que nous utilisons le plus couramment actuellement. En plus du calendrier grégorien standard, l'extension Calendrier prend également en charge le calendrier juif, le calendrier fran?ais et un autre calendrier julien très célèbre. Notre calendrier grégorien a évolué à partir du calendrier julien. La différence entre eux n'est pas grande, mais l'écart entre le calendrier juif et le calendrier fran?ais est relativement grand. Dans le code suivant, nous verrons les différences entre les différents calendriers.

Pour le contenu spécifique de ces calendriers, vous pouvez vérifier les informations pertinentes par vous-même, et vous pouvez également apprendre des connaissances historiques intéressantes, comme par exemple pourquoi le calendrier julien a été abandonné et le calendrier grégorien a été remplacé par le calendrier grégorien. calendrier. Aussi, pourquoi les années du calendrier fran?ais sont-elles seulement courtes, et pourquoi les années du calendrier juif sont-elles si mémorables ? Les origines des noms de mois dans le calendrier fran?ais et dans le calendrier juif sont toutes des histoires très intéressantes.

Installation de l'extension Calendrier et affichage des informations du calendrier

L'extension Calendrier a été intégrée au package d'installation PHP et n'a pas besoin d'être installée séparément . Si vous ne pouvez pas utiliser les fonctions liées au calendrier, vous pouvez recompiler PHP et ajouter le paramètre --enable-calendar.

Ensuite, nous examinons les détails du calendrier spécifié. Ici, nous spécifions le calendrier juif.

$info = cal_info(2);
print_r($info);
// Array
// (
//     [months] => Array
//         (
//             [1] => Tishri
//             [2] => Heshvan
//             [3] => Kislev
//             [4] => Tevet
//             [5] => Shevat
//             [6] => Adar I
//             [7] => Adar II
//             [8] => Nisan
//             [9] => Iyyar
//             [10] => Sivan
//             [11] => Tammuz
//             [12] => Av
//             [13] => Elul
//         )
//     [abbrevmonths] => Array
//         (
//             [1] => Tishri
//             [2] => Heshvan
//             [3] => Kislev
//             [4] => Tevet
//             [5] => Shevat
//             [6] => Adar I
//             [7] => Adar II
//             [8] => Nisan
//             [9] => Iyyar
//             [10] => Sivan
//             [11] => Tammuz
//             [12] => Av
//             [13] => Elul
//         )
//     [maxdaysinmonth] => 30
//     [calname] => Jewish
//     [calsymbol] => CAL_JEWISH
// )

Le paramètre re?u par la fonction cal_info() est une constante, qui sont CAL_GREGORIAN, CAL_JULIAN, CAL_JEWISH et CAL_FRENCH. Leurs nombres correspondants sont 0, 1, 2 et 3. Dans ce code, ce que nous renvoyons sont les informations CAL_JEWISH. On peut voir que les noms des mois du calendrier juif sont différents des noms anglais du calendrier grégorien. Par exemple, il y a Nisan et Tishri. Je n’entrerai pas dans le contenu spécifique. Après tout, nous n’avons pas accès à ce genre de calendrier dans notre vie quotidienne.

Vous pouvez essayer vous-même les informations renvoyées par d'autres calendriers. Le calendrier grégorien et le calendrier julien sont les mêmes, mais les noms des mois dans le calendrier grégorien sont différents, et ces noms sont très intéressants.

Conversion du calendrier de date

Tout d'abord, pour effectuer la conversion du calendrier, nous devons convertir la date spécifiée en nombre de jours juliens. Ce nombre jd peut être considéré comme une variable intermédiaire de l'expansion du calendrier, utilisée pour la conversion entre différents calendriers.

//  轉變Unix時間戳為Julian Day計數(shù)
$today = unixtojd(mktime(0, 0, 0, 9, 23, 2020));
echo $today, PHP_EOL; // 2459116

Utilisez la fonction unixtojd() pour convertir un horodatage Unix en un nombre jd. Voyons ensuite quel jour du calendrier juif correspond au 23 septembre 2020.

// 獲取當前猶太歷時間
print_r(cal_from_jd($today, CAL_JEWISH));
// Array
// (
//     [date] => 1/5/5781
//     [month] => 1
//     [day] => 5
//     [year] => 5781
//     [dow] => 3
//     [abbrevdayname] => Wed
//     [dayname] => Wednesday
//     [abbrevmonth] => Tishri
//     [monthname] => Tishri
// )

L'information renvoyée est déjà très claire. Notre jour est le mercredi 5 janvier 5781 dans le calendrier juif. Le mois en cours est Tishri, qui correspond au premier mois de l'année civile grégorienne et au septième mois de l'année ecclésiale du calendrier juif, qui représente l'arrivée de l'automne.

La fonction de cal_from_jd() est de renvoyer des informations détaillées sur le calendrier spécifié en fonction du nombre de jd. L'autre fonction cal_to_jd() convertit les données de calendrier prises en charge en nombre jd.

echo cal_to_jd(CAL_JEWISH, 1, 5, 5781), PHP_EOL; // 2459116
echo cal_to_jd(CAL_GREGORIAN,9, 23, 2020), PHP_EOL; // 2459116

Vous pouvez voir que le nombre de jd renvoyé par le calendrier juif ci-dessus est cohérent avec le nombre de jd renvoyé par notre calendrier grégorien.

Bien s?r, nous pouvons également convertir la date du décompte jd en heure unix.

echo date("Y-m-d", jdtounix($today)), PHP_EOL;
// 2020-09-23

En plus de cal_from_jd() et cal_to_jd(), l'extension Calendar nous fournit également quelques fonctions rapides pour la conversion de date, mais elles renvoient directement les informations de date de type cha?ne, pas comme la fonction cal_from_jd() renvoie également détails des dates. La méthode

// 轉變一個Gregorian歷法日期到Julian Day計數(shù)
$jd = GregorianToJD(9, 23, 2020);

// 轉變一個Julian Day計數(shù)為Gregorian歷法日期
echo jdtogregorian($jd), PHP_EOL; // 9/23/2020
// 轉變一個Julian Day計數(shù)為Julian歷法日期
echo jdtojulian($jd), PHP_EOL; // 9/10/2020
// 轉變一個Julian Day計數(shù)為猶太歷法日期
echo jdtojewish($jd), PHP_EOL; // 1/5/5781
// 轉變一個Julian Day計數(shù)為unix時間戳
echo jdtounix($jd), PHP_EOL; // 1600819200

$jd = GregorianToJD(9, 23, 1799);
// 轉變一個Julian Day計數(shù)為French歷法日期
echo jdtofrench($jd), PHP_EOL; // 1/1/8

GregorianToJD() consiste à convertir rapidement une date grégorienne en nombre jd. Les fonctions jdtoxxxx sont con?ues pour renvoyer rapidement les informations de cha?ne du calendrier de date correspondant au nombre jd.

Veuillez noter que les dates du calendrier ne peuvent être comprises que dans la période du 22 septembre 1792 au 22 septembre 1806, qui est le calendrier introduit après la fondation de la Première République fran?aise et dont l'utilisation a pris fin en 1806. , puisque Napoléon fonda le Premier Empire fran?ais en 1804. L'empire abolit le calendrier fran?ais (calendrier républicain) et appliqua pleinement le calendrier grégorien.

Le nombre de jours dans un certain mois

Comment apprenez-vous les connaissances historiques ci-dessus?? Revenons ensuite à la découverte de l’extension Calendrier.

$num = cal_days_in_month(CAL_GREGORIAN, 2, 2020);
echo $num, PHP_EOL; // 29

cal_days_in_month() 函數(shù)是返回指定歷法月份的天數(shù)，比如我們看看 2020 年的 2月 是不是 閏月 就可以用這個函數(shù)來實現(xiàn)。

復活節(jié)彩蛋

復活節(jié)是西方非常重要的一個節(jié)日，所以在 Calendar 擴展中就有函數(shù)可以直接獲得指定年份的復活節(jié)日期。關于復活節(jié)的計算方式其實還是比較復雜的，手工推算是比較麻煩的，而程序計算就非常方便了。

// 指定年份的復活節(jié)時間戳
echo date("M-d-Y", easter_date(2019)), PHP_EOL;        // Apr-21-2019
echo date("M-d-Y", easter_date(2020)), PHP_EOL;        // Apr-12-2020
echo date("M-d-Y", easter_date(2021)), PHP_EOL;        // Apr-04-2021

// 3月21日到復活節(jié)之間的天數(shù)
echo easter_days(2019), PHP_EOL;        // 31
echo easter_days(2020), PHP_EOL;        // 22
echo easter_days(2021), PHP_EOL;        // 14

easter_date() 函數(shù)就是返回指定年份的復活節(jié)日期。而 easter_days() 函數(shù)則是返回從當年公歷的 3月21日 到復活節(jié)之間的天數(shù)。

復活節(jié)是每年春分月圓后的第一個星期日，而春分一般是在3月21日，這就簡化為只要計算滿月的日期和緊挨的星期日的日期就可以得到每年復活節(jié)的具體日期了。這種函數(shù)在西方世界的軟件開發(fā)中會非常常用，其實就像我們需要獲取每年春節(jié)的具體公歷日期一樣。

總結

是不是很有意思的一套擴展函數(shù)。不過對于我們主要面向國內開發(fā)的開發(fā)者來說用處確實不大，但筆者在學習這個擴展的時候另外收獲了不少歷史方面的知識，也算是開了眼界，也不失為一大收獲，大家也自己試著玩玩并且查查相關的歷史知識吧，說不定你的收獲會更多！

測試代碼：

https://github.com/zhangyue0503/dev-blog/blob/master/php/202009/source/10.PHP中非常好玩的Calendar擴展學習.php

參考文檔：https://www.php.net/manual/zh/book.calendar.php

推薦學習：《PHP視頻教程》

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!