👨🏻‍⚕️ 🍕 🦔 Dater - PHP में एक समय क्षेत्र, स्थानीयकरण और प्रारूप समय को परिभाषित करता है 🕝 👩🏿‍💻 😼

जब किसी वेब प्रोजेक्ट को विकसित करते समय उपयोगकर्ता समय क्षेत्र के लिए लेखांकन का कार्य उठता है, तो हर बार समाधान को प्रबलित होना प्रतीत होता है। मुझे ज्ञात कई परियोजनाओं में से, जिन्होंने इस समस्या को हल किया, मुझे एक भी समाधान याद नहीं है जिसे संपूर्ण वास्तुकला के लिए सरल, पारदर्शी कहा जा सकता है।

लेकिन क्या होगा यदि आप कोड की कुछ लाइनें चाहते हैं, और ताकि बाकी कोड कभी भी यह पता न लगा सके कि डेटा को क्लाइंट को एक अलग समय क्षेत्र में भेजने की आवश्यकता है, और क्लाइंट से प्राप्त डेटा को सर्वर से अलग टाइम ज़ोन के साथ इंगित किया जा सकता है? इसे और कई अन्य समस्याओं को हल करने के लिए, आज मैं आपको पीएचपी के लिए एक संक्षिप्त और कार्यात्मक पुस्तकालय के बारे में बताऊंगा।

और इसलिए, मिलते हैं - डैटर , और इसकी मुख्य विशेषताएं:

प्रारूप बाइंडिंग
ग्रंथों और स्वरूपों का स्थानीयकरण
स्वरूपण विकल्पों की सूची का विस्तार
टाइम ज़ोन ऑटो डिटेक्शन
समय क्षेत्र के आधार पर समय रूपांतरण
समय क्षेत्र को ध्यान में रखते हुए $ _GET, $ _POST, $ _REQUEST को समय का स्वचालित रूपांतरण
डेटा भेजने के लिए टेम्पलेट में समय क्षेत्र का स्वचालित रूपांतरण

हम डेज़र्ट के लिए उपयोगकर्ता के समय क्षेत्र की स्वचालित पहचान और प्रसंस्करण के लिए कोड की वादा की गई पंक्तियों को छोड़ देंगे, लेकिन अब उदाहरण के लिए, संक्षेप में Dater की मुख्य विशेषताओं पर जाने दें।

प्रारूप बाइंडिंग

आपको प्रोजेक्ट के लिए उपयोग किए जाने वाले स्वरूपों के सेट को मानकीकृत करने और उनके साथ काम करने की अनुमति देता है:

$dater = new Dater\Dater(new Dater\Locale\En()); $dater->format(time(), 'd/m/Y'); // 2013/03/14 $dater->addFormat('slashedDate', 'd/m/Y'); $dater->format(time(), 'slashedDate'); // 2013/03/14 $dater->slashedDate(time()); // 2013/03/14

स्वरूपण विकल्प विस्तार

दिनांक से सभी प्रारूपण विकल्प उपलब्ध हैं , जिन्हें ओवरराइड और विस्तारित भी किया जा सकता है:

 $dater->addFormatOption('ago', function (DateTime $datetime) { return floor((time() - $datetime->getTimestamp()) / 86400) . ' days ago'; }); $dater->format(time() - 60*60*24*7, 'd FY, ago'); // 14 March 2013, 7 days ago

लोकल सपोर्ट

 $dater->setLocale(new Dater\Locale\En()); echo $dater->date(); // 03/21/2013 echo $dater->now('j F Y'); // 21 March 2013 $dater->setLocale(Dater\Dater::getLocaleByCode('ru')); echo $dater->date(); // 21.03.2013 echo $dater->now('j F Y'); // 21  2013

सर्वर और उपयोगकर्ता स्वरूपों के लिए मानक तरीके लोकेल पर आधारित हैं

 echo $dater->date(); // 03/21/2013 (client timezone, depends on locale) echo $dater->time(); // 5:41 AM (client timezone, depends on locale) echo $dater->datetime(); // 03/21/2013 5:41 (client timezone, depends on locale) echo $dater->isoDate(); // 2013-03-21 (client timezone) echo $dater->isoTime(); // 05:41:28 (client timezone) echo $dater->isoDatetime(); // 2013-03-21 05:41:28 (client timezone) echo $dater->serverDate(); // 2013-03-21 (server timezone) echo $dater->serverTime(); // 09:41:28 (server timezone) echo $dater->serverDatetime(); // 2013-03-21 09:41:28 (server timezone)

समय क्षेत्र के आधार पर समय / तिथि रूपांतरण

 $dater->setServerTimezone('Europe/Moscow'); $dater->setClientTimezone('Europe/London'); echo $dater->serverDatetime(); // 2013-03-21 08:18:06 echo $dater->isoDatetime(); // 2013-03-21 04:18:06 echo $dater->time(); // 04:18

यह ध्यान देने योग्य है कि जब $dater->setServerTimezone('Europe/Moscow'); बुला रहा हो $dater->setServerTimezone('Europe/Moscow'); दिनांक () फ़ंक्शन और दिनांक समय वर्ग नए सेट समय क्षेत्र में समय लौटाएगा। इसे अक्षम करने के लिए, दूसरे पैरामीटर पर गलत पास करें।

और अंत में वादा किया

एक कोड जो आपको ग्राहक के समय क्षेत्र को स्वचालित रूप से निर्धारित करने और उसके लिए वर्तमान तिथि-समय प्रदर्शित करने की अनुमति देता है:

वैश्विक आरंभीकरण स्क्रिप्ट के हेडर में

 $dater = new Dater\Dater(new Dater\Locale\Ru(), 'Europe/Moscow'); $timezoneDetector = new Dater\TimezoneDetector(); $dater->setClientTimezone($timezoneDetector->getClientTimezone()); $dataHandler = new Dater\DataHandler($dater); $dataHandler->enableOutputTimezoneHandler(); $dataHandler->convertRequestDataToServerTimezone();

मुख्य टेम्पलेट में

 <html> <head> <?= $timezoneDetector->getHtmlJsCode() ?> </head> </html>

अब सभी लाइनों YYYY-MM-DD HH: MM: SS को भेजे गए डेटा में YYYY-MM-DD-HH द्वारा प्रतिस्थापित किया जाएगा: MM: SS ग्राहक के स्वतः निर्धारित समय क्षेत्र में। यदि आपको किसी निश्चित प्रारूप में दिनांक-समय प्रदर्शित करने की आवश्यकता है, तो बस YYYY-MM-DD HH जोड़ें: MM: SS [ md] या YYYY-MM-DD HH: MM: SS [तिथि] जहां दिनांक प्रारूप में द्विपद है । आप टाइमस्टैम्प प्रारूप को आउटपुट और प्रारूपित भी कर सकते हैं: 1363853607 [dmY]।

उदाहरण के लिए, निम्न डेटा

 <html> <body> Timestamp format: 1363238564 ( ) Timestamp format: 1363238564[Y/m/d] Timestamp format: 1363238564[datetime] Server datetime format: 2013-03-14 09:22:44[Y/m/d] Server datetime format: 2013-03-14 09:22:44[time] Server datetime format: 2013-03-14 09:22:44 </body> </html>

में स्वचालित रूप से परिवर्तित हो जाएगा

 <html> <body> Timestamp format: 1363238564 ( ) Timestamp format: 2013/03/14 Timestamp format: 14.03.2013 07:22 Server datetime format: 2013/03/14 Server datetime format: 07:22 Server datetime format: 2013-03-14 07:22:44 </body> </html>

उसी समय, $dataHandler->convertRequestDataToServerTimezone(); सभी YYYY-MM-DD HH कर देगा: MM: क्लाइंट से आने वाले SS डेटा को YYYY-MM-DD-HH में परिवर्तित किया जाएगा: MM: SS सर्वर समय क्षेत्र। इस प्रकार, सर्वर को कभी पता नहीं चलेगा कि ग्राहक दूसरे समय क्षेत्र में दिनांक-समय प्राप्त करता है और भेजता है।

यह मानने योग्य है कि समय क्षेत्र के प्रसंस्करण के लिए यह थोड़ा चरम विकल्प है। एक अधिक सार्वभौमिक और पारंपरिक समाधान $dataHandler->enableOutputTimezoneHandler(); का उपयोग छोड़ना $dataHandler->enableOutputTimezoneHandler(); और बस उचित स्वरूपण विधि को कॉल करके प्रत्येक दिनांक-समय के सम्मिलन की रूपरेखा तैयार करें। उदाहरण के लिए, <?= $dater->date($datetimeOrTimestamp) ?>

परियोजना के बारे में

मैं ईमानदारी से मानता हूं कि मैं इस पुस्तकालय का लेखक हूं, और किसी भी आलोचना के लिए बहुत आभारी हूं और अंतिम रूप देने में मदद करता हूं। GitHub में एक निशुल्क BSD लाइसेंस के तहत स्रोत अपलोड किए जाते हैं, आप अपनी इच्छानुसार उपयोग और वितरित कर सकते हैं।

मुझे उम्मीद है कि अभी भी कोई काम आ रहा है :)

UPD लोकप्रिय मांग से, PSR-0 के अनुसार, नाम स्थान का उपयोग करके पुस्तकालय को फिर से तैयार किया गया। पिछला संस्करण एक अलग ब्रंच में सहेजा गया था, और संगीतकार से "dater/dater":"1.*@dev" रूप में उपलब्ध है "dater/dater":"1.*@dev" ।

Dater - PHP में एक समय क्षेत्र, स्थानीयकरण और प्रारूप समय को परिभाषित करता है