תכונות פונקציה
ה date_sunrise() ו תאריך_שקיעה() לפונקציות יש תכונות רבות שהופכות אותן לכלים אמינים לחישוב תזמוני זריחה ושקיעה. קלט קווי הרוחב והאורך הוא אחד המאפיינים החשובים ביותר. כדי לקבל זמני שחר ושקיעה מדויקים, יש להזין את ערכי קו הרוחב והאורך המדויקים של המיקום.
יחד עם זה, הפונקציה דורשת את התאריך שבו יש לחשב את הזריחה והשקיעה. הפונקציה גם לוקחת את ערך אזור הזמן של PHP כדי להתאים לשעון קיץ.
תחביר
מבנה התחביר עבור date_sunrise() הפונקציה היא כדלקמן:
תאריך_זריחה ( $חותמת זמן , $פורמט , $latitude , קו אורך $ , $זניט , $gmt_offset ) ;
באופן דומה, מבנה התחביר עבור פונקציית תאריך_שקיעה() הוא כדלקמן:
תאריך_שקיעה ( $חותמת זמן , $פורמט , $latitude , קו אורך $ , $זניט , $gmt_offset ) ;
קלט פרמטרים
ה-PHP date_sunrise() ו תאריך_שקיעה() לפונקציות יש שישה פרמטרי קלט. הפרמטר הראשון הוא $חותמת זמן , שהוא אופציונלי ומוגדר על ידי חותמת זמן של Unix. הפרמטר השני הוא ה $פורמט , שהוא גם אופציונלי. פרמטר זה מציין כיצד הפלט יוחזר. הפרמטר השלישי הוא $latitude , המאחסן את קו הרוחב של המיקום שעבורו יש לחשב את הזריחה או השקיעה.
הפרמטר הרביעי הוא קו אורך $ , המאחסן את קו האורך של המיקום שעבורו יש לחשב את הזריחה או השקיעה. לגבי האופק, מיקום השמש מוגדר על ידי הפרמטר החמישי, $זניט . לבסוף, פרמטר הקלט השישי הוא $gmt_offset , שהוא הקיזוז של אזור הזמן המקומי מ-GMT.
פורמט החזרה
ה-PHP date_sunrise() ו תאריך_שקיעה() הפונקציה מאפשרת למשתמשים להשיג מספר פורמטים להחזרה. פורמטי ההחזרה הנפוצים ביותר הם מחרוזת וחותמת זמן. ה SUNFUNCS_RET_STRING פורמט יחזיר את זמן השמש בפורמט מחרוזת, SUNFUNCS_RET_TIMESTAMP יחזיר את השעה בפורמט חותמת זמן של Unix ו SUNFUNCS_RET_DOUBLE יחזיר את השעה בפורמט כפול.
חישוב זריחה
משתמש ב date_sunrise() פונקציה, משתמשים יכולים לחשב את זמן הזריחה באמצעות התחביר הזה:
תאריך_זריחה ( זְמַן ( ) , SUNFUNCS_RET_STRING , שנים דולר , $ ארוך , $זניט , $gmt_offset ) ;לדוגמה:
הֵד תַאֲרִיך ( 'ד מ ד י \n ' ) ;
הֵד ( 'זמן זריחה:' ) ;
הֵד ( תאריך_זריחה ( זְמַן ( ) , SUNFUNCS_RET_STRING , 34.6543 , 56.34535 , 88 , 5.32 ) ) ;
?>
קוד זה מעצב את התאריך הנוכחי כ 'ד מ ד י' ומציג אותו באמצעות תַאֲרִיך() פוּנקצִיָה. ה date_sunrise() לאחר מכן נעשה שימוש בשיטה כדי לקבוע ולדווח על זמן הזריחה בהתבסס על קואורדינטות קווי הרוחב והאורך שצוינו (34.6543, 56.34535).
חישוב שקיעה
משתמש ב תאריך_שקיעה() פונקציה, משתמשים יכולים לחשב את זמן השקיעה באמצעות התחביר הזה:
תאריך_שקיעה ( זְמַן ( ) , SUNFUNCS_RET_STRING , שנים דולר , $ ארוך , $זניט , $gmt_offset ) ;לדוגמה:
הֵד תַאֲרִיך ( 'ד מ ד י' ) ;
הֵד ( ' \n שעת השקיעה: ' ) ;
הֵד ( תאריך_שקיעה ( זְמַן ( ) , SUNFUNCS_RET_STRING , 34.6543 , 56.34535 , 88 , 5.32 ) ) ;
?>
קוד זה מעצב את התאריך הנוכחי כ-'D M d Y' ומציג אותו באמצעות ה- תַאֲרִיך() פוּנקצִיָה. ה תאריך_שקיעה() לאחר מכן נעשה שימוש בשיטה כדי לקבוע ולדווח על זמן השקיעה בהתבסס על קואורדינטות קווי הרוחב והאורך שצוינו (34.6543, 56.34535).
סיכום
ה date_sunrise() ו תאריך_שקיעה() פונקציות ב-PHP מספקות דרך נוחה לחשב את זמני הזריחה והשקיעה עבור תאריך ומיקום נתונים. על ידי שימוש בפונקציות אלו, מפתחים יכולים לקבוע במדויק זמנים אסטרונומיים ולשלב אותם ביישומי PHP שלהם.