将标准的 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>
输出
输出 HTML 页显示以下实体:
Date Unedited: 2000-02-16T15:56:00
Date Edited: Feb 16, 2000