DatetimeExtension
extends TICTwigExtension
in package
Filtres et fonctions twig de formattage de dates.
https://twig.symfony.com/doc/3.x/filters/format_datetime.html
Table of Contents
Properties
- $strings : mixed
- $translator : mixed
- $urlHelper : mixed
Methods
- durationFilter() : string
- Formattage d'une durée en décomposant un nombre de secondes avec toutes les unités intermédiaires appropriées.
- fdateFilter() : string
- Formattage d'une date (ou chaine par défaut si date vide).
- fdatetimeFilter() : string
- Formattage d'une date (ou chaine par défaut si date vide).
- ftimeFilter() : string
- Formattage d'un horaire (ou chaine par défaut si date vide).
- getFilters() : array<string|int, mixed>
- ldateFilter() : string
- Formattage localisé d'une date sans horaire (selon des profils de formats).
- ldatehourFilter() : string
- Formattage localisé d'une date avec horaire, mais sans les secondes (selon des profils de formats).
- ldatetimeFilter() : string
- Formattage localisé d'une date avec horaire (selon des profils de formats).
- lhourFilter() : string
- Formattage localisé d'un horaire, mais sans les secondes (selon des profils de formats).
- lmonthFilter() : string
- Formattage localisé d'un mois (selon des profils de formats).
- ltimeFilter() : string
- Formattage localisé d'un horaire (selon des profils de formats).
- ndatetimeFilter() : string
- Formattage d'une date au format numérique 'YYYYMMDDhhmmss' (ou chaine par défaut si date vide).
- getBool() : mixed
- Retourne l'équivalent booléen (ou null) d'une variable quelconque.
- getIcon() : string
- Génération d'un tag HTML pour afficher un icone FontAwesome ou Bootstrap (avec quelques alias utiles).
- getText() : string
- Retourne une chaine texte à partir d'une variable (avec traduction et échappements HTML possibles).
- htmlAttr() : string
- Conversion d'un hachage en une chaine d'attributs insérable dans un tag HTML.
- trans() : string
- Recherche la traduction d'un texte (si le service $translator est disponible).
Properties
$strings
protected
static mixed
$strings
= ['true' => 'ext.boolean.true', 'false' => 'ext.boolean.false', 'null' => null]
$translator
protected
mixed
$translator
$urlHelper
protected
mixed
$urlHelper
Methods
durationFilter()
Formattage d'une durée en décomposant un nombre de secondes avec toutes les unités intermédiaires appropriées.
public
durationFilter(mixed $seconds[, string $sep = ' ' ][, array<string|int, mixed> $units = array('M' => ' mois', 'd' => ' jour', 'h' => ' heure', 'm' => ' minute') ][, string $pluriel = 's' ][, bool $opt_week = true ]) : string
Parameters
- $seconds : mixed
-
Durée à afficher en nombre de secondes
- $sep : string = ' '
-
Séparateur pour la construction de la chaine de caractère
- $units : array<string|int, mixed> = array('M' => ' mois', 'd' => ' jour', 'h' => ' heure', 'm' => ' minute')
-
Liste des unités utilisables pour la décomposition (parmis: C,D,Y,M,W,d,h,m,s)
- $pluriel : string = 's'
-
Caractère à ajouter aux unités pour leurs formes plurielles
- $opt_week : bool = true
-
Unité 'week' supprimée automatiquement si durée supérieure au mois (quelque soit la liste $units)
Return values
string —Chaine de caractères décrivant la durée (ex: 123456789 => "46 mois 28 jours 19 heures 16 minutes")
fdateFilter()
Formattage d'une date (ou chaine par défaut si date vide).
public
fdateFilter(mixed $value[, string $format = '%A %e %B %Y' ][, string $default = '' ]) : string
Parameters
- $value : mixed
-
Variable indiquant la date (objet DateTime sinon timestamp numérique)
- $format : string = '%A %e %B %Y'
-
Motif avec la syntaxe de strftime() sinon date()
- $default : string = ''
-
Chaine à retourner par défaut si la variable est vide
Return values
string —Chaine représentant la date avec le format indiqué
fdatetimeFilter()
Formattage d'une date (ou chaine par défaut si date vide).
public
fdatetimeFilter(mixed $value[, string $format = '%A %e %B %Y - %H:%M' ][, string $default = '' ]) : string
Note: variante du filtre "fdate" avec un format par défaut incluant les heures
Parameters
- $value : mixed
-
Variable indiquant la date (objet DateTime sinon timestamp numérique)
- $format : string = '%A %e %B %Y - %H:%M'
-
Motif avec la syntaxe de strftime() sinon date()
- $default : string = ''
-
Chaine à retourner par défaut si la variable est vide
Return values
string —Chaine représentant la date avec le format indiqué
ftimeFilter()
Formattage d'un horaire (ou chaine par défaut si date vide).
public
ftimeFilter(mixed $value[, string $format = 'H:i' ][, string $default = '' ]) : string
Parameters
- $value : mixed
-
Variable indiquant la date (objet DateTime sinon timestamp numérique)
- $format : string = 'H:i'
-
Motif avec la syntaxe de strftime() sinon date()
- $default : string = ''
-
Chaine à retourner par défaut si la variable est vide
Return values
string —Chaine représentant l'horaire avec le format indiqué
getFilters()
public
getFilters() : array<string|int, mixed>
Return values
array<string|int, mixed>ldateFilter()
Formattage localisé d'une date sans horaire (selon des profils de formats).
public
ldateFilter(Environment $env, mixed $date[, string|null $dateFormat = 'medium' ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ]) : string
Parameters
- $env : Environment
- $date : mixed
- $dateFormat : string|null = 'medium'
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
Return values
stringldatehourFilter()
Formattage localisé d'une date avec horaire, mais sans les secondes (selon des profils de formats).
public
ldatehourFilter(Environment $env, mixed $date[, string|null $dateFormat = 'medium' ][, string|null $timeFormat = null ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ]) : string
Parameters
- $env : Environment
- $date : mixed
- $dateFormat : string|null = 'medium'
- $timeFormat : string|null = null
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
Return values
stringldatetimeFilter()
Formattage localisé d'une date avec horaire (selon des profils de formats).
public
ldatetimeFilter(Environment $env, mixed $date[, string|null $dateFormat = 'medium' ][, string|null $timeFormat = null ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ][, string $pattern = '' ]) : string
Parameters
- $env : Environment
- $date : mixed
- $dateFormat : string|null = 'medium'
- $timeFormat : string|null = null
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
- $pattern : string = ''
Return values
stringlhourFilter()
Formattage localisé d'un horaire, mais sans les secondes (selon des profils de formats).
public
lhourFilter(Environment $env, mixed $date[, string|null $timeFormat = 'short' ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ]) : string
Parameters
- $env : Environment
- $date : mixed
- $timeFormat : string|null = 'short'
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
Return values
stringlmonthFilter()
Formattage localisé d'un mois (selon des profils de formats).
public
lmonthFilter(Environment $env, mixed $date[, string|null $format = 'long' ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ]) : string
Parameters
- $env : Environment
- $date : mixed
- $format : string|null = 'long'
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
Return values
stringltimeFilter()
Formattage localisé d'un horaire (selon des profils de formats).
public
ltimeFilter(Environment $env, mixed $date[, string|null $timeFormat = 'medium' ][, string $default = '' ][, string $locale = null ][, mixed $timezone = null ]) : string
Parameters
- $env : Environment
- $date : mixed
- $timeFormat : string|null = 'medium'
- $default : string = ''
- $locale : string = null
- $timezone : mixed = null
Return values
stringndatetimeFilter()
Formattage d'une date au format numérique 'YYYYMMDDhhmmss' (ou chaine par défaut si date vide).
public
ndatetimeFilter(mixed $value[, string $default = '' ]) : string
Parameters
- $value : mixed
-
Variable indiquant la date (objet DateTime sinon timestamp numérique)
- $default : string = ''
-
Chaine à retourner par défaut si la variable est vide
Return values
string —Chaine représentant la date sous sa forme numérique
getBool()
Retourne l'équivalent booléen (ou null) d'une variable quelconque.
protected
getBool(mixed $value[, mixed $default = null ]) : mixed
Parameters
- $value : mixed
-
Variable à convertir en booléen
- $default : mixed = null
-
Valeur à retourner si la conversion échoue
getIcon()
Génération d'un tag HTML pour afficher un icone FontAwesome ou Bootstrap (avec quelques alias utiles).
protected
getIcon(string $name[, string $state = '' ]) : string
Parameters
- $name : string
-
Classe Bootstrap ou FontAwesome (ex 'fas-user', 'fab-user', 'envelope', 'ban-circle'...)
- $state : string = ''
-
Ajout d'une classe de type 'text-
' (ex: primary, info, success, warning, danger)
Return values
stringgetText()
Retourne une chaine texte à partir d'une variable (avec traduction et échappements HTML possibles).
protected
getText(mixed $value[, bool $trans = false ][, bool $escape = false ]) : string
Parameters
- $value : mixed
-
Variable à convertir en texte
- $trans : bool = false
-
Recherche d'une traduction (si c'est une chaine valide)
- $escape : bool = false
-
Appliquer les échappements HTML
Return values
string —Chaine de texte correspondante
htmlAttr()
Conversion d'un hachage en une chaine d'attributs insérable dans un tag HTML.
protected
htmlAttr([array<string|int, mixed> $attr = array() ]) : string
Parameters
- $attr : array<string|int, mixed> = array()
-
Liste d'attributs HTML en clé/valeur
Return values
string —Code HTML contenant les attributs d'un tag
trans()
Recherche la traduction d'un texte (si le service $translator est disponible).
protected
trans(string $token) : string
Parameters
- $token : string
-
Chaine de texte à traduire
Return values
string —Chaine de texte traduite