Fichier ecrire/inc/filtres_dates.php

Déclaration de filtres de dates pour les squelettes

Source

Proposer une amélioration

Liste des fonctions

string affdate( string $numdate , string $format = 'entier' )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $format = 'entier'

    Type de format souhaité ou expression pour strtotime() tel que Y-m-d h:i:s

Retour

  • string

    La date formatée

Exemples

  • En PHPaffdate("2008-10-11 14:08:45") affiche "11 octobre 2008"
  • En squelettes
    • [(#DATE|affdate)]
    • [(#DATE|affdate{Y-m-d})]

Utilise

Utilisé par

Package

Filtre

  • affdate
Proposer une amélioration
mixed | string affdate_base( string $numdate , string $vue , array $options = array() )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $vue

    Type de format souhaité ou expression pour strtotime() tel que Y-m-d h:i:s

  3. array $options = array()

    {

Retour

  • mixed | string

Package

Type

  • string $param 'abbr' ou 'initiale' permet d'afficher les jours au format court ou initiale
  • int $annee_courante Permet de definir l'annee de reference pour l'affichage des dates courtes }
Proposer une amélioration

Si l'année actuelle (ou indiquée dans $annee_courante) est 2015, retournera "21 juin" si la date en entrée est le 21 juin 2015, mais retournera "juin 2013" si la date en entrée est le 21 juin 2013.

string affdate_court( string $numdate , integer | null $annee_courante = null )

Paramètres

  1. string $numdate

    Une écriture de date

  2. integer | null $annee_courante = null

    L'année de comparaison, utilisera l'année en cours si omis.

Retour

  • string

    La date formatée

Exemples

  • [(#DATE|affdate_court)]

Utilise

Package

Filtre

  • affdate_court
Proposer une amélioration
  • Lundi 20 fevrier a 18h
  • Le 20 fevrier de 18h a 20h
  • Du 20 au 23 fevrier
  • Du 20 fevrier au 30 mars
  • Du 20 fevrier 2007 au 30 mars 2008

$horaire='oui' ou true permet d'afficher l'horaire, toute autre valeur n'indique que le jour $forme peut contenir une ou plusieurs valeurs parmi

  • abbr (afficher le nom des jours en abrege)
  • hcal (generer une date au format hcal)
  • jour (forcer l'affichage des jours)
  • annee (forcer l'affichage de l'annee)
string affdate_debut_fin( string $date_debut , string $date_fin , string $horaire = 'oui' , string $forme = '' )

Paramètres

  1. string $date_debut
  2. string $date_fin
  3. string $horaire = 'oui'
  4. string $forme = ''
    • abbr pour afficher le nom du jour en abrege (Dim. au lieu de Dimanche)
    • annee pour forcer l'affichage de l'annee courante
    • jour pour forcer l'affichage du nom du jour
    • hcal pour avoir un markup microformat abbr

Retour

  • string

    Texte de la date

Package

Proposer une amélioration
string affdate_heure( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • string

    La date formatée

Exemples

  • [(#DATE|affdate_heure)] peut donner "11 novembre 2015 à 11h10min"

Utilisé par

Package

Filtre

  • affdate_heure
Proposer une amélioration

Si l'année actuelle (ou indiquée dans $annee_courante) est 2015, retournera "21 juin" si la date en entrée est le 21 juin 2015, mais retournera "21 juin 2013" si la date en entrée est le 21 juin 2013.

string affdate_jourcourt( string $numdate , integer | null $annee_courante = null )

Paramètres

  1. string $numdate

    Une écriture de date

  2. integer | null $annee_courante = null

    L'année de comparaison, utilisera l'année en cours si omis.

Retour

  • string

    La date formatée

Exemples

  • [(#DATE|affdate_jourcourt)]

Voir également

Utilise

Package

Filtre

  • affdate_jourcourt
Proposer une amélioration

Ne retourne pas le jour donc.

string affdate_mois_annee( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • string

    La date formatée

Utilise

Package

Filtre

  • affdate_mois_annee
Proposer une amélioration
integer annee( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • integer

    Année (sur 4 chiffres)

Exemples

  • [(#DATE|annee)]

Utilise

Package

Filtre

  • annee
Proposer une amélioration

Utilisé pour <pubdate> dans certains flux RSS

string date_822( string $date_heure )

Paramètres

  1. string $date_heure

    Une écriture de date

Retour

  • string

    La date formatée

Exemples

  • [(#DATE|date_822)] peut donner "Wed, 11 Nov 2015 11:13:45 +0100"

Package

Filtre

  • date_822
Proposer une amélioration
string date_anneemois( string $d )

Paramètres

  1. string $d

    Une écriture de date commençant par un format Y-m (comme date ou datetime SQL). Si vide, utilise la date actuelle.

Retour

  • string

    Date au format Ym

Exemples

  • date_anneemoisjour('2015-10-11 11 :27:03') retourne 201510

Voir également

Package

Proposer une amélioration
string date_anneemoisjour( string $d )

Paramètres

  1. string $d

    Une écriture de date commençant par un format Y-m-d (comme date ou datetime SQL). Si vide, utilise la date actuelle.

Retour

  • string

    Date au format Ymd

Exemples

  • date_anneemoisjour('2015-10-11 11 :27:03') retourne 20151011

Voir également

Package

Proposer une amélioration
string date_debut_semaine( integer $annee , integer $mois , integer $jour )

Paramètres

  1. integer $annee
  2. integer $mois
  3. integer $jour

Retour

  • string

    Date au lundi de la même semaine au format Ymd

Exemples

  • date_debut_semaine(2015, 11 , 11) retourne 20151109

Voir également

Package

Proposer une amélioration
string date_fin_semaine( integer $annee , integer $mois , integer $jour )

Paramètres

  1. integer $annee
  2. integer $mois
  3. integer $jour

Retour

  • string

    Date au dimanche de la même semaine au format Ymd

Exemples

  • date_debut_semaine(2015, 11 , 11) retourne 20151115

Voir également

Package

Proposer une amélioration

Retourne une date au format Ymd\THis\Z, tel que '20150428T163254Z'

string date_ical( string $date , integer $addminutes )

Paramètres

  1. string $date

    La date

  2. integer $addminutes

    Ajouter autant de minutes à la date

Retour

  • string

    Date au format ical

Exemples

  • DTSTAMP:[(#DATE|date_ical)]

Package

Filtre

  • date_ical
Proposer une amélioration

En fonction de la date transmise, peut retourner par exemple :

  • «il y a 3 minutes»,
  • «il y a 11 heures»,
  • «10 mai 2015 à 10h23min»
string date_interface( string $date , integer $decalage_maxi = 43200 )

Paramètres

  1. string $date

    La date fournie

  2. integer $decalage_maxi = 43200

    Durée écoulée, en secondes, à partir de laquelle on bascule sur une date complète. Par défaut +/- 12h.

Retour

  • string

    La date relative ou complète

Exemples

  • [(#DATE|date_interface)]

Package

Filtre

  • date_interface
Proposer une amélioration
string date_iso( string $date_heure )

Paramètres

  1. string $date_heure

    Une écriture de date

Retour

  • string

    La date formatée

Exemples

  • [(#DATE|date_iso)] peut donner "2015-11-11T10:13:45Z"

Package

Filtre

  • date_iso
Proposer une amélioration

En fonction de la date transmise ainsi que de la date de référence (par défaut la date actuelle), peut retourner par exemple :

  • «il y a 3 minutes»,
  • «il y a 2 semmaines»,
  • «dans 1 semaine»
string date_relative( string $date , integer $decalage_maxi , string $ref_date = null )

Paramètres

  1. string $date

    La date fournie

  2. integer $decalage_maxi

    Durée écoulée, en secondes, au delà de laquelle on ne retourne pas de date relative Indiquer 0 (par défaut) pour ignorer.

  3. string $ref_date = null

    La date de référence pour le calcul relatif, par défaut la date actuelle

Retour

  • string
    • La date relative
    • "" si un dépasse le décalage maximum est indiqué et dépassé.

Exemples

    • [(#DATE|date_relative)]
    • [(#DATE|date_relative{43200})]
    • [(#DATE|date_relative{0, #AUTRE_DATE})] Calcul relatif à une date spécifique

Package

Filtre

  • date_relative
Proposer une amélioration

Retourne «hier», «aujourd'hui» ou «demain» si la date correspond, sinon utilise date_relative()

string date_relativecourt( string $date , integer $decalage_maxi )

Paramètres

  1. string $date

    La date fournie

  2. integer $decalage_maxi

    Durée écoulée, en secondes, au delà de laquelle on ne retourne pas de date relative Indiquer 0 (par défaut) pour ignorer.

Retour

  • string
    • La date relative
    • "" si un dépasse le décalage maximum est indiqué et dépassé.

Exemples

  • [(#DATE|date_relativecourt)]

Package

Filtre

  • date_relativecourt
Proposer une amélioration

L'année et le mois doivent être numériques. Le séparateur entre l'année et le mois peut être un -, un : ou un texte quelconque ne contenant pas de chiffres.

Les jours ne sont pas pris en compte et le résultat est toujours le 1er du mois.

string extraire_date( string $texte )

Paramètres

  1. string $texte

    Texte contenant une date tel que 2008-04

Retour

  • string

    Date au format SQL tel que 2008-04-01

Package

Proposer une amélioration
integer heures( string $numdate )

Paramètres

  1. string $numdate

    La date à extraire

Retour

  • integer

    heures, sinon 0

Utilise

Package

Filtre

  • heures
Proposer une amélioration
string heures_minutes( string $numdate )

Paramètres

  1. string $numdate

    La date à extraire

Retour

  • string

    L'heure formatée dans la langue en cours.

Package

Note

  • Le format de retour varie selon la langue utilisée.

Filtre

  • heures_minutes
Proposer une amélioration

Utilise une abbréviation (exemple "1er") pour certains jours, en fonction de la langue utilisée.

integer jour( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • integer

    Numéro du jour

Exemples

  • [(#DATE|jour)]

Voir également

Utilise

Package

Filtre

  • jour
Proposer une amélioration
integer journum( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • integer

    Numéro du jour

Exemples

  • [(#DATE|journum)]

Voir également

Utilise

Package

Filtre

  • journum
Proposer une amélioration
integer minutes( string $numdate )

Paramètres

  1. string $numdate

    La date à extraire

Retour

  • integer

    minutes, sinon 0

Utilise

Package

Filtre

  • minutes
Proposer une amélioration
string mois( string $numdate )

Paramètres

  1. string $numdate

    Une écriture de date

Retour

  • string

    Numéro du mois (sur 2 chiffres)

Exemples

  • [(#DATE|mois)]

Utilise

Package

Filtre

  • mois
Proposer une amélioration
string nom_jour( string $numdate , string $forme = '' )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $forme = ''

    Forme spécifique de retour :

    • initiale : l'initiale du jour
    • abbr : abbréviation du jour
    • '' : le nom complet (par défaut)

Retour

  • string

    Nom du jour

Exemples

    • [(#DATE|nom_jour)] lundi
    • [(#DATE|nom_jour{abbr})] lun.
    • [(#DATE|nom_jour{initiale})] l.

Utilise

Package

Filtre

  • nom_jour
Proposer une amélioration
string nom_mois( string $numdate , string $forme = '' )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $forme = ''

    Forme spécifique de retour :

    • abbr : abbréviation du mois
    • '' : le nom complet (par défaut)

Retour

  • string

    Nom du mois

Exemples

    • [(#DATE|nom_mois)] novembre
    • [(#DATE|nom_mois{abbr})] nov.

Utilise

Package

Filtre

  • nom_mois
Proposer une amélioration
string normaliser_date( string $date , boolean $forcer_jour = false )

Paramètres

  1. string $date

    La date à normaliser

  2. boolean $forcer_jour = false

    true pour forcer à indiquer un jour et mois (01) s'il n'y en a pas.

Retour

  • string
    • une date au format datetime
    • une chaîne vide si la date est considérée nulle

Utilise

Package

Note

  • Si elle vient du contexte (public/parametrer.php), on force le jour

Filtre

  • normaliser_date
Proposer une amélioration

Annee, mois, jour sont retrouvés si la date contient par exemple :

  • '03/11/2015', '3/11/15'
  • '2015-11-04', '2015-11-4'
  • '2015-11'

Dans ces cas, les heures, minutes, secondes sont retrouvés avec recup_heure()

Annee, mois, jour, heures, minutes, secondes sont retrouvés si la date contient par exemple :

  • '20151104111420'
array recup_date( string $numdate , boolean $forcer_jour = true )

Paramètres

  1. string $numdate

    La date à extraire

  2. boolean $forcer_jour = true

    True pour tout le temps renseigner un jour ou un mois (le 1) s'il ne sont pas indiqués dans la date.

Retour

  • array

    [année, mois, jour, heures, minutes, secondes]

Utilise

Package

Proposer une amélioration

Retrouve une horaire au format 11:29:55

array recup_heure( string $date )

Paramètres

  1. string $date

    Chaîne de date contenant éventuellement une horaire

Retour

  • array
    • [heures, minutes, secondes] si horaire trouvée
    • [0, 0, 0] sinon

Package

Proposer une amélioration
string saison( string $numdate , string $hemisphere = 'nord' )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $hemisphere = 'nord'

    Nom optionnel de l'hémisphère (sud ou nord) ; par défaut nord

Retour

  • string

    La date formatée

Exemples

  • En PHP
    saison("2008-10-11 14:08:45") affiche "automne"
    saison("2008-10-11 14:08:45", "sud") affiche "printemps"

    En squelettes
    [(#DATE|saison)]
    [(#DATE|saison{sud})]

Utilise

Package

Filtre

  • saison
Proposer une amélioration
string saison_annee( string $numdate , string $hemisphere = 'nord' )

Paramètres

  1. string $numdate

    Une écriture de date

  2. string $hemisphere = 'nord'

    Nom optionnel de l'hémisphère (sud ou nord) ; par défaut nord

Retour

  • string

    La date formatée

Exemples

  • En PHP
    saison_annee("2008-10-11 14:08:45") affiche "automne 2008"
    saison_annee("2008-10-11 14:08:45", "sud") affiche "printemps 2008"

    En squelettes
    [(#DATE|saison_annee)]
    [(#DATE|saison_annee{sud})]

Utilise

Package

Filtre

  • saison_annee
Proposer une amélioration
integer secondes( string $numdate )

Paramètres

  1. string $numdate

    La date à extraire

Retour

  • integer

    secondes, sinon 0

Utilise

Package

Filtre

  • secondes
Proposer une amélioration
string vider_date( string $letexte )

Paramètres

  1. string $letexte

Retour

  • string
    • La date entrée (si elle n'est pas considérée comme nulle)
    • Une chaine vide

Utilisé par

Package

Proposer une amélioration