Syntaxe pour la fonction date_time_set()
La syntaxe de la date_heure_set() fonction en PHP est donnée ci-dessous.
DateHeure date_heure_set ( DateHeure $objet , entier $heure , entier $minute , entier $ seconde = 0 , entier $ microseconde = 0 )Les paramètres de la fonction sont :
- $objet : Objet DateTime à modifier.
- $heure : La nouvelle valeur du composant heure.
- $minute : La nouvelle valeur du composant minute.
- $seconde : (Facultatif) La nouvelle valeur du deuxième composant. La valeur par défaut est 0.
- $microseconde : (Facultatif) La nouvelle valeur du composant microseconde. La valeur par défaut est 0.
Ces valeurs doivent être au format d'une chaîne, avec l'heure formatée au format 24 heures.
Valeur de retour
Un nouvel objet DateTime avec les composants de temps mis à jour est renvoyé par le date_heure_set() méthode. L'objet DateTime principal n'est pas modifié.
Note: Il est à noter que le date_heure_set() La fonction ne modifie pas l'objet DateTime d'origine, mais renvoie un nouvel objet DateTime avec la date et l'heure spécifiées. Cela signifie que si vous souhaitez mettre à jour un objet DateTime avec une nouvelle valeur d'heure, vous devez affecter la valeur de retour du date_heure_set() fonction de retour à l'objet DateTime d'origine.
Par exemple:
$date = nouveau DateHeure ( '2023-12-01 00:00:00' ) ;
date_heure_set ( $date , 12 , 30 ) ;
imprimer ( 'Date: ' . format de date ( $date , 'A/m/j H:i:s' ) ) ;
?>
Dans cet exemple, la première ligne crée un nouvel objet DateTime avec la date définie sur le 1er décembre 2023 à minuit. La deuxième ligne utilise le date_heure_set() fonction pour régler l'heure de l'objet sur 12h30 et attribue l'objet DateTime résultant à la $date variable.
Si vous transmettez des valeurs de jour et de mois qui sont en dehors de la plage autorisée lors de l'appel de cette méthode, elles seront ajoutées à leurs valeurs parentes.
$date = nouveau DateHeure ( ) ;
date_heure_set ( $date , 24 , 22 , 36 ) ;
imprimer ( 'Date: ' . format de date ( $date , 'A/m/j H:i:s' ) ) ;
?>
Un nouvel objet DateTime qui reflète la date et l'heure actuelles est créé par le code ci-dessus. L'heure de l'objet DateTime est alors définie sur 24 heures, 22 minutes et 36 secondes à l'aide de la date_heure_set() méthode. Le format de date() est ensuite utilisée pour formater et imprimer la date et l'heure modifiées.
Conclusion
Le date_heure_set() La fonction en PHP fournit un moyen pratique de définir ou de modifier les composants temporels d'un objet DateTime. En utilisant cette fonction, les développeurs peuvent facilement modifier les composants heure, minute, seconde et microseconde d'un objet DateTime. Le date_heure_set() La fonction offre flexibilité et précision dans la gestion des modifications de temps, ce qui en fait un outil précieux pour travailler avec les dates et les heures dans les applications PHP.