Fonction ms:format-date

Article
08/31/2012

Convertit des formats de date XSD standard en caractères appropriés pour la sortie.

string ms:format-date(string datetime, string format [,locale])

Paramètres

string datetime
Contient une valeur de date au format XSD.Pour les arguments sans chaîne, la fonction se comporte comme si on appliquait une fonction string().Si l'argument n'est pas une date, la sortie est une chaîne vide.Si l'argument est une date XSD valide et si certains champs sont vides, la fonction tente de compléter les champs non spécifiés.
string format
Contient une chaîne de format, selon les fonctions GetDateFormat API Win32.
locale [optional]
Définit les paramètres régionaux selon lesquels les données doivent être formatées (par exemple, « FR_fr »).

Notes

Le tableau suivant énumère les caractères de formatage de ms:format-date().

Caractère(s)	Description
M	Mois, de 1 à 12
MM	Mois, de 01 à 12
MMM	Mois, de Jan à Dec
MMMM	Mois, de janvier à décembre
d	Jour, de 1 à 31
dd	Jour, de 01 à 31
ddd	Jour, de Dim à Sam
dddd	Jour, de dimanche à samedi
y	Année, de 0 à 99
yy	Année, de 00 à 99
yyyy	Année, de 1900 à 9999
gg	Période/ère (ignorée s'il n'y en a pas)

Notez que ce format ne permet pas de spécifier des fuseaux horaires, d'inclure un texte arbitraire dans la chaîne formatée, de spécifier le siècle, ni d'insérer un suffixe comme dans 1er avril.

Exemple

Document XML (Sample.xml)

<?xml version='1.0'?>
<XMLSamples xml:space="preserve"
         xmlns:dt="urn:schemas-microsoft-com:datatypes">
  <FileDetails>
   <Author>Robert Brown</Author>
   <Date dt:dt="datetime">2000-02-16T15:56:00</Date>
  </FileDetails>
</XMLSamples>

Feuille de style XSLT (Sample.xsl)

<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      xmlns:ms="urn:schemas-microsoft-com:xslt"
      xmlns:dt="urn:schemas-microsoft-com:datatypes">
  <xsl:template match="/">
  <HTML>
  <HEAD>
  </HEAD>
  <BODY> 
   <xsl:for-each select="XMLSamples/FileDetails/Date">
      <DIV>
          Date Unedited:
          <xsl:value-of select="."/>
      </DIV>
      <DIV>
          Date Edited:
          <xsl:value-of select="ms:format-date(., 'MMM dd, yyyy')"/>
      </DIV>
   </xsl:for-each>
  </BODY> 
  </HTML>
</xsl:template>
</xsl:stylesheet>

Sortie

La page HTML de sortie affiche les entrées suivantes :

Date Unedited: 2000-02-16T15:56:00
Date Edited: Feb 16, 2000

Voir aussi

Référence

Référence XSD (XML Schemas)

Référence des types de données XML

Partager via