ms:format-date 函数

将标准的 XSD 日期格式转换为适合输出的字符。

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

参数

  • string datetime
    包含与日期有关的值,采用 XSD 格式。 对于非字符串参数,此函数的行为就像应用了 string() 函数。 如果该参数不是日期,将输出空字符串。 如果是有效的 XSD 日期但是某些字段为空,此函数会尝试填充未指定的字段。

  • string format
    包含格式字符串,依据 Win32 API GetDateFormat 函数。

  • locale [可选]
    定义格式化数据的区域设置(例如“EN_us”)。

备注

下面列出了 ms:format-date() 的格式字符。

字符

描述

M

月,1-12

MM

月,01-12

MMM

月,Jan-Dec

MMMM

月,January-December

d

日,1-31

dd

日,01-31

ddd

日,Sun-Sat

dddd

日,Sunday-Saturday

y

年,0-99

yy

年,00-99

yyyy

年,1900-9999

gg

时期/时代(如果没有则省略)

注意,此格式不允许包含时区;不允许将任意文本加入格式化字符串;不允许包含世纪;不允许包含 May 2nd 或 April1st 等后缀。

示例

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>

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>

ms256099.collapse_all(zh-cn,VS.120).gif输出

输出 HTML 页显示以下实体:

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

请参见

参考

XML 架构 (XSD) 参考

XML 数据类型引用