Date
Afficher une date parait être une action sans intérêt, mais vous changerez sans doute d'avis avec cette démo.

Surtout depuis que PHP 8 complique "un peu" les choses ...

 

🆙 date : affiche une date

Cliquer pour lire la documentation

affiche une date définie ou calculée en tenant compte des nouvelles contraintes de PHP8
syntaxe {up action=option_principale}
@version: UP-3.0 @license: GNU/GPLv3 @credit: script xxx de xxx @tags: EDITOR
  • date: date reconnue par la fonction php : strtotime
  • format = %A %e %B %Y: format. ex: %A %e %B %Y
  • locale: le code pays (en_US) ou NULL=celui en cours
  • timezone: fuseau horaire. Ex: Europe/Paris ou Atlantic/Reykjavik. vide=celui du serveur
  • id: identifiant
  • tag = span:
  • class: classe(s) pour bloc
  • style: style inline pour bloc
  • css-head (base-css): style ajouté dans le HEAD de la page

Version 3.1
- transfert du code vers la méthode générale up-date_format
- ajout option timezone

Un exemple simple

Noël sera le {up date=19991225}

Noël sera le Saturday 25 December 1999

Il suffit de mettre la date désirée au format YYYYMMDD

Le prochain Noël sera le {up date=1225}

Le prochain Noël sera le Wednesday 25 December 2024

Pour annoncer un événement futur, il est possible de ne pas spécifier l'année. La date sera toujours postérieure à la date du jour.

Mise en forme

Vous êtes attendus pour le réveillon de Noël le  Wednesday 25 December 2024 à 22:30 précise.

Vous êtes attendus pour le réveillon de Noël le  {up date=12252230 | format=%A %e %B %Y à %k:%M} précise.

L'option format permet de définir la forme attendue pour la date. Pour compatibilité avec les anciens codes et simplicité pour le rédacteur, l'option utilise toujours l'ancienne méthode PHP. Une conversion sera effectuée vers le nouveau format php8.

Liste des codes autorisés :

%y: AA, %Y: AAAA,
%m: 01-12, %b: nom du mois en 3 lettres, %B: nom complet du mois,
%d: 01-31, %e: 1-31, %a: jour de la semaine en 3 lettres, %A: jour de la semaine complet,
%U: N° semaine,
%k: heure (0-23), %H: heure (00-23), %l: heure (1-12) AM/PM (L minuscule), %I: heure (01-12) AM/PM  (i majuscule), %P: am/pm, %p: AM/PM,
%M: minute (00-59)
 

Avec du bbcode

November
2024
Tuesday
5

L'option format accepte du bbcode. Cela permet d'ajouter des balises et du CSS.

Je vous laisse découvrir le shortcode ci-dessous.

Pour faciliter la saisie, j'utilise la feuille de style interne de UP

{up date
| format=[div style="padding:0 10px 5px" class="bg-red t-white lh100" ]
[b]%B[/b]
[br]%Y
[/div]
[div class="bg-white ph1 pb1"]
[div]%A[/div]
[div class="b fs300 t-red" style="margin:-15px"]%e[/div]
[/div]
| class=display-inline-block tc bd-red ombreMax rotate6
| style=min-width:80px
}

ico-idee Si vous utilisez souvent un modèle, ajoutez-le à votre custom/prefs.ini

Comment exprimer une date

En plus du traditionnel AAAAMMDDHHMM, il est possible d'indiquer une date dans un format reconnu par la fonction strtotime de PHP.

Ma prochaine permanence est le {up date=next wednesday}

Ma prochaine permanence est le Wednesday 6 November 2024

Si la fonction PHP n'accepte que des termes anglais, l'action date reconnait les mots suivants en français :
aujourd'hui, premier jour de ce mois, dernier jour de ce mois, premier jour du mois prochain, dernier jour du mois prochain, précédent, prochain, année, an, mois, jour, semaine, heure, seconde, lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche, janvier, février, mars, avril, mai, juin, juillet, août, septembre, octobre, novembre, décembre

Note: vous pouvez ajouter une traduction dans votre langue en créant un fichier xx-XX.ini dans le dossier language de UP. Prenez modèle sur les fichiers existants.

Ma prochaine permanence est le Wednesday 6 November 2024

Ma prochaine permanence est le {up date=prochain mercredi}
 
Pour des demandes très particulières, l'anglais reste un passage obligé
 

Vous avez jusqu'au Monday 2 December 2024

Vous avez jusqu'au {up date=first monday of next month}

Timezone

Par défaut, le fuseau horaire utilisé est celui de votre serveur.

Pour un besoin spécifique ou pour corriger la configuration de votre serveur, vous pouvez indiquer le fuseau horaire de votre choix.

Formats de date acceptées

Une petite synthèse des méthodes pour indiquer une date.

{up date=prochain mercredi} Wednesday 6 November 2024 texte dans une langue reconnue
{up date=vendredi 2 juin 2023 } Friday 2 June 2023 date sous forme littérale
{up date=20230602 } Friday 2 June 2023 AAAAMMJJ ou MMJJ pour année en cours.
{up date=2023-06-02 } Friday 2 June 2023 AAAA-MM-JJ (AA-MM-JJ interdit)
{up date=02-06-2023 } Friday 2 June 2023 JJ-MM-AAAA (JJ-MM-AA interdit)
{up date=202306021030 | format=%e %B %Y à %Hh%M } 2 June 2023 à 10h30 Avec heure au format AAAAMMJJHHMM
{up date=02-06-2023 10:30 | format=%e %B %Y à %Hh%M } 2 June 2023 à 10h30 Avec heure

Les séparateurs acceptés pour la date sont le tiret, l'espace et la barre oblique de division. Pour l'heure, le double-points

Pour info, cette page utilise 28 action(s) :
box (1) upactionslist (1) readmore (1) csv2def (1) flexauto (5) date (14) div (1) flexbox (1) icon (1) csv2table (1) jcontent-info (1)