ميزات الوظيفة
ال تاريخ_شروق () و تاريخ_غروب الشمس () تحتوي الوظائف على العديد من الميزات التي تجعلها أدوات موثوقة لحساب توقيت شروق الشمس وغروبها. يعد إدخال خطوط الطول والعرض أحد أهم الخصائص. للحصول على أوقات الفجر والغروب بدقة ، يجب على المرء إدخال قيم خطوط الطول والعرض الدقيقة للموقع.
إلى جانب ذلك ، تتطلب الوظيفة التاريخ الذي سيتم فيه حساب شروق الشمس وغروبها. تأخذ الوظيفة أيضًا قيمة المنطقة الزمنية PHP لضبط التوقيت الصيفي.
بناء الجملة
البنية النحوية لملف تاريخ_شروق () الوظيفة على النحو التالي:
تاريخ_شروق ( الطابع الزمني $ و تنسيق $ و خط العرض $ و خط الطول دولار و ذروة $ و gmt_offset دولار ) ؛
وبالمثل ، فإن البنية النحوية لـ دالة تاريخ_الشمس () على النحو التالي:
تاريخ_غروب الشمس ( الطابع الزمني $ و تنسيق $ و خط العرض $ و خط الطول دولار و ذروة $ و gmt_offset دولار ) ؛
معلمات الإدخال
لغة PHP تاريخ_شروق () و تاريخ_غروب الشمس () تحتوي الوظائف على ستة معلمات إدخال. المعلمة الأولى هي الطابع الزمني $ ، وهو أمر اختياري ويتم تحديده بواسطة طابع زمني لـ Unix. المعلمة الثانية هي تنسيق $ ، وهو أيضًا اختياري. تحدد هذه المعلمة كيفية إرجاع الإخراج. المعلمة الثالثة هي خط العرض $ ، الذي يخزن خط العرض للموقع الذي سيتم حساب شروق الشمس أو غروبها.
المعلمة الرابعة هي خط الطول دولار ، والذي يخزن خط الطول للموقع الذي سيتم حساب شروق الشمس أو غروبها. حول الأفق ، يتم تحديد موقع الشمس بواسطة المعلمة الخامسة ، ذروة $ . أخيرًا ، معلمة الإدخال السادسة هي gmt_offset دولار ، وهي إزاحة المنطقة الزمنية المحلية من توقيت غرينتش.
تنسيق الإرجاع
لغة PHP تاريخ_شروق () و تاريخ_غروب الشمس () تسمح الوظيفة للمستخدمين بتحقيق العديد من تنسيقات الإرجاع. تنسيقات الإرجاع الأكثر استخدامًا هي السلسلة والطابع الزمني. ال SUNFUNCS_RET_STRING سيعيد التنسيق وقت الشمس بتنسيق سلسلة ، SUNFUNCS_RET_TIMESTAMP سيعيد الوقت بتنسيق طابع زمني Unix و SUNFUNCS_RET_DOUBLE سيعيد الوقت بتنسيق مزدوج.
حساب الشروق
باستخدام تاريخ_شروق () وظيفة ، يمكن للمستخدمين حساب وقت شروق الشمس باستخدام الصيغة التالية:
تاريخ_شروق ( وقت ( ) و SUNFUNCS_RET_STRING و سنوات دولار و طويل دولار و ذروة $ و gmt_offset دولار ) ؛على سبيل المثال:
<؟ phpصدى صوت تاريخ ( 'D M d Y \ن ' ) ؛
صدى صوت ( 'وقت الشروق:' ) ؛
صدى صوت ( تاريخ_شروق ( وقت ( ) و SUNFUNCS_RET_STRING و 34.6543 و 56.34535 و 88 و 5.32 ) ) ؛
؟>
يقوم هذا الرمز بتنسيق التاريخ الحالي كـ 'D M d Y' ويعرضه باستخدام ملف تاريخ() وظيفة. ال تاريخ_شروق () ثم يتم استخدام الطريقة لتحديد وقت شروق الشمس والإبلاغ عنه بناءً على إحداثيات خطوط الطول والعرض المحددة (34.6543 ، 56.34535).
حساب الغروب
باستخدام تاريخ_غروب الشمس () وظيفة ، يمكن للمستخدمين حساب وقت غروب الشمس باستخدام هذه الصيغة:
تاريخ_غروب الشمس ( وقت ( ) و SUNFUNCS_RET_STRING و سنوات دولار و طويل دولار و ذروة $ و gmt_offset دولار ) ؛على سبيل المثال:
<؟ phpصدى صوت تاريخ ( 'D M d Y' ) ؛
صدى صوت ( ' \ن وقت الغروب: ' ) ؛
صدى صوت ( تاريخ_غروب الشمس ( وقت ( ) و SUNFUNCS_RET_STRING و 34.6543 و 56.34535 و 88 و 5.32 ) ) ؛
؟>
يقوم هذا الرمز بتنسيق التاريخ الحالي كـ 'D M d Y' ويعرضه باستخدام ملف تاريخ() وظيفة. ال تاريخ_غروب الشمس () ثم يتم استخدام الطريقة لتحديد وقت الغروب والإبلاغ عنه بناءً على إحداثيات خطوط الطول والعرض المحددة (34.6543 ، 56.34535).
خاتمة
ال تاريخ_شروق () و تاريخ_غروب الشمس () توفر الوظائف في PHP طريقة مناسبة لحساب أوقات شروق الشمس وغروبها لتاريخ وموقع معين. باستخدام هذه الوظائف ، يمكن للمطورين تحديد الأوقات الفلكية بدقة ودمجها في تطبيقات PHP الخاصة بهم.