date

(PHP 4, PHP 5, PHP 7, PHP 8)

date — Formate un horodatage Unix

Description

Retourne une date sous forme d'une chaîne, au format donné par le paramètre format, fournie par le paramètre timestamp (horodatage Unix) ou la date et l'heure courantes si aucun timestamp n'est fourni. En d'autres termes, le paramètre timestamp est optionnel et vaut par défaut la valeur de la fonction time().

Les horodatages Unix ne gèrent pas les fuseaux horaires. Utilisez la classe DateTimeImmutable, et sa méthode de formatage DateTimeInterface::format() pour formater les informations de date/heure avec un fuseau horaire attaché.

Liste de paramètres

format

Format accepté par DateTimeInterface::format().

Note: date() générera toujours 000000 pour les microsecondes puisqu'il prend un paramètre int, alors que datetime::format() prend en charge les microsecondes si DateTime a été créé avec des microsecondes.

timestamp

Le paramètre optionnel timestamp est un timestamp Unix de type entier qui vaut par défaut l'heure courante locale si timestamp est omis ou null. En d'autres termes, il vaut par défaut la valeur de la fonction time().

Valeurs de retour

Retourne une date formatée en chaine de caractères.

Erreurs / Exceptions

Chaque appel à une fonction date/heure générera un diagnostic de type E_WARNING si le fuseau horaire n'est pas valide. Voir aussi date_default_timezone_set()

Historique

Exemples

Exemple #1 Exemple avec date()

Vous pouvez faire afficher un caractère spécial dans la chaîne de format en le protégeant par un antislash. Si le caractère est lui-même une séquence incluant un antislash, vous devrez protéger aussi l'antislash.

Exemple #2 Protection des caractères dans la fonction date()

Il est possible d'utiliser date() et mktime() ensemble pour générer des dates dans le futur ou dans le passé.

Exemple #3 Exemple avec date() et mktime()

Note:

Cette méthode est plus sûre que simplement ajouter ou retrancher le nombre de secondes dans une journée ou un mois à un timestamp, à cause des heures d'hiver et d'été.

Voici maintenant quelques exemples de formatage avec date(). Notez que vous devriez échapper tous les autres caractères, car s'ils ont une signification spéciale, ils risquent de produire des effets secondaires indésirables. Notez aussi que les versions futures de PHP peuvent attribuer une signification à des lettres qui sont actuellement inertes. Lorsque vous échappez les caractères, pensez à utiliser des guillemets simples, pour que les séquences \n ne deviennent pas des nouvelles lignes.

Exemple #4 Exemple avec date()

Pour formater des dates dans d'autres langues, IntlDateFormatter::format() peut être utilisé à la place de date().

Notes

Note:

Pour générer un timestamp à partir d'une représentation de date, vous pouvez utiliser la fonction strtotime(). De plus, certaines bases de données disposent de fonctions pour convertir leurs propres formats de date en timestamp (par exemple, MySQL et sa fonction » UNIX_TIMESTAMP()).

Un timestamp représentant le début de la requête est disponible dans la variable $_SERVER['REQUEST_TIME'].

Voir aussi

• DateTimeImmutable::__construct() - Retourne un nouvel objet DateTimeImmutable
• DateTimeInterface::format() - Retourne une date formatée suivant le format fourni
• gmdate() - Formate une date/heure GMT/CUT
• idate() - Formate une partie de l'heure/date locale en tant qu'entier
• getdate() - Retourne la date/heure
• getlastmod() - Retourne la date de dernière modification de la page
• mktime() - Retourne l'horodatage UNIX d'une date
• IntlDateFormatter::format() - Formate la date et l'heure sous forme de chaîne
• time() - Retourne l'horodatage UNIX actuel
• Constantes DateTime Prédéfinie