ms:format-date-Funktion

Artikel
08/21/2008

Konvertiert XSD-Standarddatumsformate in Zeichen, die für die Ausgabe geeignet sind.

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

Parameter

string datetime
Enthält einen Wert im XSD-Format, der sich auf ein Datum bezieht. Bei Argumenten, die keine Zeichenfolge darstellen, verhält sich diese Funktion so, als sei eine string()-Funktion angewendet worden. Wenn das Argument kein Datum darstellt, besteht die Ausgabe aus einer leeren Zeichenfolge. Wenn das Attribut ein gültiges XSD-Datum darstellt und einige Felder leer sind, versucht diese Funktion, nicht angegebene Felder auszufüllen.

string format
Enthält eine Formatzeichenfolge gemäß den GetDateFormat-Funktionen der Win32 API.

locale [optional]
Definiert das Gebiet, für das die Daten formatiert werden sollen (z. B. "EN_us").

Hinweise

Im Folgenden werden die Formatzeichen für ms:format-date() aufgelistet.

Zeichen	Beschreibung
M	Monate, angezeigt als 1–12
MM	Monate, angezeigt als 01–12
MMM	Monate, angezeigt als Jan–Dez
MMMM	Monate, angezeigt als Januar-Dezember
d	Tage, angezeigt als 1-31
dd	Tage, angezeigt als 01-31
ddd	Tage, angezeigt als So-Sa
dddd	Tage, angezeigt als Sonntag-Samstag
y	Jahre, angezeigt als 0-99
yy	Jahre, angezeigt als 00-99
yyyy	Jahre, angezeigt als 1900-9999
gg	Dauer/Zeitraum (wird - wenn nicht vorhanden - ignoriert)

Beachten Sie, das bei diesem Format Folgendes nicht zulässig ist: Zeitzonen, das Einfügen von beliebigem Text in eine formatierte Zeichenfolge, Jahrhunderte und Suffixe (z. B. 2. Mai oder 1.April).

Beispiel

XML-Dokument (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>

XSLT-Stylesheet (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>

Ausgabe

In der ausgegebenen HTML-Seite werden die folgenden Einträge angezeigt:

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

Siehe auch

Verweis

Referenz zu XML-Schemata (XSD)
Referenz zu XML-Datentypen

Freigeben über