ThéorieRéférences XMLTypes des données

Les dates [date]

Les dates [date]
Le terme date est employé pour qualifier le type d'une donnée Blogger.
Une donnée de type date est utilisée pour indiquer un jour calendaire du calendrier Grégorien.

Présentation

Ce type de données est une exclusivité gadgets Version 2.

Vous trouverez la liste complète dans la bibliothèque [filtre date].


Paramètres additionnels

Certains types de données disposent de paramètres additionnels qui permettent d'obtenir des informations supplémentaires ou d'appliquer une caractéristique à la donnée. C'est le cas des données de type date :

Paramètre Type de la valeur Signification
iso8601 string Renvoie la date au format iso8601.
year number Renvoie la valeur numérique de l'année.
month number Renvoie la valeur numérique du mois.
1 pour janvier, 2 pour février, etc...
day number Renvoie la valeur numérique du jour du mois.
1 pour le 1er jour du mois, 2 pour le 2e jour du mois, etc...
dayOfWeek number Renvoie la valeur numérique du jour de la semaine.
1 pour lundi, 2 pour mardi, etc...
dayOfMonth number Identique à day.
dayOfYear number Renvoie la valeur numérique du jour de l'année.
1 pour 1er janvier, 2 pour 2 janvier, 32 pour 1er février, etc...

Les données de type date héritent automatiquement des caractéristiques des données de type string.

Paramètre Type de la valeur Signification
length number Renvoie le nombre de caractères contenus dans la chaîne.
size
escaped string Échappement HTML d'une chaîne de caractères.
jsEscaped string Échappement JS d'une chaîne de caractères.
jsonEscaped string Échappement JSON d'une chaîne de caractères.
cssEscaped string Échappement CSS d'une chaîne de caractères.


D'un point de vue technique, ces paramètres sont des données contenues dans un objet et qui renvoient une nouvelle valeur :


Représentation des ressources
"data": {
  "dataDate": date,
              { 
                "iso8601": string,
                "year": number,
                "month": number,
                "day": number,
                "dayOfWeek": number,
                "dayOfMonth": number,
                "dayOfYear": number,
                "length": number,
                "size": number,
                "escaped": string,
                "jsEscaped": string,
                "jsonEscaped": string,
                "cssEscaped": string
              }
}


En pratique, les paramètres s'ajoutent simplement au nom de la donnée et renvoie une nouvelle valeur.
Quelques exemples avec la donnée data:posts[i].date disponible dans la version 2 des gadgets "Blog", "FeaturedPost" et "PopularPosts" :


La date par défaut
<b:loop values='data:posts' var='post'>
  <data:post.date/>
</b:if>

La date au format iso8601
<b:loop values='data:posts' var='post'>
  <data:post.date.iso8601/>
</b:if>

Extraire l'année
<b:loop values='data:posts' var='post'>
  <data:post.date.year/>
</b:if>

Extraire le mois
<b:loop values='data:posts' var='post'>
  <data:post.date.month/>
</b:if>

Extraire le jour du mois
<b:loop values='data:posts' var='post'>
  <data:post.date.day/>
</b:if>

Extraire le jour de l'année
<b:loop values='data:posts' var='post'>
  <data:post.date.dayOfYear/>
</b:if>

Extraire le jour de la semaine
<b:loop values='data:posts' var='post'>
  <data:post.date.dayOfWeek/>
</b:if>

La longueur de la date
<b:loop values='data:posts' var='post'>
  <data:post.date.size/>
</b:if>

Échappement HTML
<b:loop values='data:posts' var='post'>
  <data:post.date.escaped/>
</b:if>

Échappement JS
<b:loop values='data:posts' var='post'>
  <data:post.date.jsEscaped/>
</b:if>

Échappement JSON
<b:loop values='data:posts' var='post'>
  <data:post.date.jsonEscaped/>
</b:if>

Échappement CSS
<b:loop values='data:posts' var='post'>
  <data:post.date.cssEscaped/>
</b:if>


array[date]

array[date] est un type de tableau contenant que des valeurs de type date.

array["25 janvier 2017","30 décembre 2016","3 avril 1975"]

Il n'existe aucun tableau de ce type dans la bibliothèque des données Blogger, mais si une telle donnée existait, il faudrait employer la balise b:loop

Exemple fictif
<b:loop values='data:arrayDATE' var='itemDATE'>

  <data:itemDATE/>

</b:loop>

Pourquoi avoir mentionné le type array[image] dans cette documentation si aucune donnée de ce type ne figure dans la bibliothèque ?
Il est vrai que la bibliothèque ne contient pas de tableau de ce type, mais il est possible d'en créer. Pour cela, vous devez utiliser une donnée de type array[object] avec l'opérateur lambda map qui se chargera de regrouper une donnée de type date contenue dans l'objet du tableau.

Syntaxe
array[object] map (var => var.date)

Exemple
<b:loop values='data:posts map (x => x.date)' var='postDate'>

  Date : <data:postDate/>

</b:loop>
L'opérateur map compile les valeurs de la donnée date contenue dans le tableau objet data:posts. Le nouveau tableau de dates est créé et stocké dans la variable postDate.
Dernière modification :
Assistance publique pour le produit Blogger sur les supports  d'aides :

Certifiée par Google - Experte Platine TC (Ambassador & Advanced Troubleshooter):
  • Affectation Google France, produit Blogger, du 11/07/2011 au 28/07/2014.
  • Affectation Google US, produit Blogger depuis le 28/07/2014.

Posts les plus consultés de ce blog

ThéorieRéférences XMLParamètres des données
Le paramètre Image redimensionnable [isResizable]
Populaire
DéveloppementsFichiers XML
Résumés des articles avec images réactives [Pack 2016]
Populaire
ThéorieRéférences XMLTypes des variables d'habillage
Variables d'habillage - Les arrière-plans [background]
Populaire
DéveloppementsMulti-versions
Facebook : Bouton J'aime [Like button]
Populaire